Installation

Note: Some ISP's have a site license to our shopping cart and they have a control panel interface to install it, so you can skip this step if this is the case.

UNIX Setup

  1. Place shop.pl and shop.cfg in your cgi directory. (e.g. cgi-local)
  2. Ensure PERL is installed on your system.
  3. Get PERL's path information. Use "which perl" on csh, "whence perl" on ksh. Usually is /usr/bin/perl or /usr/local/bin/perl
  4. Change the first line of shop.pl to reflect the correct location of the PERL interpreter.
  5. Make a directory that the WWW server can read to contain your shopping cart files. (the $shopping_root directory in the shop.cfg file)
  6. Edit shop.cfg to reflect the correct values for your web site or generate the shop.cfg file online here.
  7. Make sure you have a directory called lists in your $shopping_root directory and the permissions on it are set to 777.
  8. Make sure you make the $NT variable equal to 0.

Windows NT Setup (Website, IIS 2.0, IIS 3.0)

  1. Place shop.pl in your cgi-shl directory with Website or in a cgi directory with IIS 2.0/IIS 3.0 the directory must be set to execute only not read.
  2. Ensure PERL is installed on your system.
  3. Ensure PERL is associated with the .pl extension.
    To do this with Website:(with Windows NT 3.51)
    1. Run the File Manager.
    2. Find and highlight the shop.pl program.
    3. From the file menu select Associate.
    4. Select Browse.
    5. Select your PERL binary to run when a program with the .pl extension is run.

    To do this with the Microsoft Web Server (IIS 2.0/IIS 3.0):

    1. Stop the WWW service.
    2. Start Regedt32.exe
    3. Open HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters\ScriptMap
    4. From the Edit menu, choose Add Value. The Data type is REG_SZ.
    5. Type the filename extension, .pl used for your scripts.
    6. In the String editor, type the full path to the PERL interpreter.
    7. Add %s after the path to the PERL interpreter.
    8. Restart the WWW service.
  4. Make a directory that the WWW server can read to contain your shopping cart files.
  5. Edit shop.cfg to reflect the correct values for your web site or generate the shop.cfg file online here.
  6. Put the shop.cfg file in the same directory as the shop.pl file.
  7. Change the line in shop.pl that says "require 'whatever/shop.cfg'" to reflect the correct location of shop.cfg
  8. Make sure you have a directory called lists in your $shopping_root directory and the web server can write to that directory.
  9. Make sure you make the $NT variable equal to 1.
  10. Also you must have Blat installed so the Shopping Cart can email you the order information.
    You can get Blat here.

Windows NT Setup (IIS 4.0)

  1. Make a directory called c:\cgi-local
  2. Place shop.pl in your new cgi-local directory.
  3. Install PERL 5.001 or higher in c:\perl5.
  4. Go into the Microsoft Management Console for IIS 4.0.
  5. Double-click on the virtual website you wish to add the Shopping Cart to.
  6. Right-click on the virtual website and select New->Virtual Directory.
  7. Enter cgi-local as the new alias name and press Next
  8. Enter c:\cgi-local as the new physical path and press Next
  9. Check Allow Execute Access and make sure no other Access Permissions are checked and press Finish.
  10. Right-click on cgi-local and select Properties.
  11. Press the Configuration button.
  12. If there is an Application Mapping for .pl delete it.
  13. Select Add.
  14. For the Executable: field put "C:\perl5\perl.exe %s"
  15. For the Extension: field put ".pl"
  16. Make sure Script Engine is checked and that Check that file exists is not. Then press Ok.
  17. Press Ok until you are back to the Microsoft Management Console.
  18. Exit the Microsoft Management Console making sure you save Console Settings.
  19. Make a shopping_root directory that the WWW server can read to contain your shopping cart files.
  20. Edit shop.cfg to reflect the correct values for your web site or generate the shop.cfg file online here.
  21. Put the shop.cfg file in the same directory as the shop.pl file.
  22. Change the line in shop.pl that says "require 'whatever/shop.cfg'" to require c:/cgi-local/shop.cfg
  23. Make sure you have a directory called lists in your $shopping_root directory and the web server can write to that directory.
  24. Make sure you make the $NT variable equal to 1 in the shop.cfg file.
  25. Also you must have Blat installed so the Shopping Cart can email you the order information.
  26. Note: The cart will only work with the POST method on Windows NT SP6. (i.e you cannot use /cgi-local/shop.pl/page=estore.htm)
    You can get Blat here.