FirstProductions Dining Guide 2.0 Documentation
Overview · License and Copyright · Installation and Requirements · Template Customization · Troubleshooting · Release Changes and History · Future Plans

Requirements
Before you can use FirstProductions Dining Guide, be sure that your web site passes the minimum requirements:
• Web Server: You must have web space to store web pages on a Unix server (script not tested on Windows NT). If not, consider getting web space from FirstProductions Web Hosting, our web hosting service. FirstProductions Web Hosting fully supports the requirements of this script.
• CGI-BIN: You must be able to run custom CGI scripts on your web server, such as in a CGI-BIN. Note that most free web hosting services do not allow this (such as GeoCities, Tripod, and America Online).
• Perl: Perl 5.004 or later must be installed on the web server. We suggest ActiveState Perl for Windows servers.
• Socket Module: The Socket module needs to be installed on the web server so FirstProductions Dining Guide can obtain the restaurant information and reviews from Chef Moz. Although the Socket module is part of the standard Perl distribution and is automatically installed, it may be missing on a few web hosts who do not install the full Perl distribution.
• File Permissions: For Unix servers, you will need the ability to set and change file permissions, either through FTP or Telnet. This is also known as CHMOD.
• FTP Access: You will need to have FTP access to the web directories on your server. FrontPage access only is not sufficient.

Installation: Step 1: Uncompress the Package
First, you will need to uncompress the software package using WinZip or similar unzipping software. You should have a directory tree similar to this:

CGI (directory)
   |__templates (directory)
      |__include (directory)
         |__header.txt
         |__footer.txt
      |__copyright.txt
      |__editor.txt
      |__footer.txt
      |__fullsearch.txt
      |__header.txt
      |__links.txt
      |__main.txt
      |__nearby_cities.txt
      |__nomatches.txt
      |__online_guides.txt
      |__place_list.txt
      |__places.txt
      |__quicksearch.txt
      |__restaurant_listing.txt
      |__restaurant_page.txt
      |__restaurants.txt
      |__reviews.txt
      |__search.txt
   |__chefex.pm
   |__guide.cgi

Installation: Step 2: Configure the Script
First open guide.cgi in main CGI directory. Be sure that the first line of the script matches the path to Perl for your server. The path to Perl is usually similar to: /usr/bin/perl or /usr/local/bin/perl. Be sure not to remove the #! before the path to Perl. If you are unsure of the path to Perl, contact your server administrator. Next, modify the "configuration section" to customize the script for your server. Be sure to edit the CGI_URL setting.

Installation: Step 3: Upload Files to Server
After configuring the script, create a folder in your "cgi-bin" for the files. Be sure it matches the directory that you specified when you configured the script. Upload the files to your web server in ASCII mode. Be sure to keep the directory structure intact. Make the guide.cgi file executable by CHMODing it as 755.

Installation: Step 4: Testing the Script
Now that you have uploaded the files, it is time to see if it worked. In a web browser, navigate to the URL of the script. If there is an error, see the troubleshooting section of the documentation. If it works, go on to the Template Customization section.

Navigation:
Overview · License and Copyright · Installation and Requirements · Template Customization · Troubleshooting · Release Changes and History · Future Plans
FirstProductions Dining Guide Web Site