Shop 3 - Offline Setup for CGI Scripts

Offline Setup
Shop 3 CGI Scripts

Setting up the CGI script (shop.pl)

The most difficult part of the set-up is the installation of the CGI script that runs on your server. This controls the order form.

There are two options for installing this script.

Option 1:	We host the CGI scripts for you.
	We will supply you with a user name, that you can insert in to the setup program, which will allow you to connect a pre-configured cgi-script on our server. PayPal Pro, WorldPay and Nochex require extra cgi-scripts to allow them to connect to their payment servers. Because of the complex nature of these scripts we have added an option to set them up and install them on our server for you. The rest of the program including the category files and the item image are installed on your own server as normal. If you wish us to host the scripts for you, see our order page for costing details.
Option 2:	You host the CGI scripts yourself.
	Follow the instructions below on how to set up the shop.pl script on your own server.

Setting up your own scripts

If you click on Setup 2 of the Setup program, you will see a box entitled

URL of the shop.pl file

near the bottom of the screen.

It should contain a value something like the following.

http://put-your-own-URL-in-here/cgi-bin/shop.pl

The CGI (Common Gateway Interface) script "shop.pl" is usually placed in a cgi-bin or scripts directory. Some servers may require this to be placed in a differently named directory, so check with your user support.

To test if the shop.pl file is working correctly.

Type http://put-your-own-URL-in-here/cgi-bin/shop.pl as the URL in your browser.

The page should be similar to http://www.online-store.co.uk/cgi-bin/shop.pl

For Unix and NT Servers

Check if the folder you are using is allowed to run Perl programs.

If in doubt, check with the your web site provider.

Unix Servers using FTP Only

1) You need to upload the "shop.pl" file in text mode. If you upload it in binary, it will not work. If you have used text mode the size of the shop.pl file on the server should be slightly smaller than the shop.pl file on the your hard drive. Class, gif and jpg files should be uploaded in binary mode and there should be no change in size.

2) Its file permissions should be rwx r-x r-x

Private read,write,execute
Group read and execute
Public read and execute

You can change these permissions using an FTP program

The ftp program on setup page 5 will automatically upload the files in the correct mode and set the correct file permissions.

3) Also check you have used the correct location for Perl, it can vary from server to server.

To change the location of perl in the shop.pl file do the following.

Click on the "Setup 2" button of the Setup Program.

In the box entitled location of Perl type the location of Perl.

common values are

/usr/bin/perl

/usr/lib/perl

/bin/perl

consult the user support of your web hosting company if you are unsure of the correct location.

NT Servers Only

Normally, you do not set the position of Perl. Also you do not have to set any file permissions.

All Servers

Sometimes you need to rename the shop.pl to shop.cgi or shop.pl5

FrontPage Users

The files

shop.pl

should placed in your cgi-bin folder or directory

Make sure the properties of the folder that contains the "cgi-script.pl" file, are changed to allow scripts to be run. Click on "Edit" and "Properties" in FrontPage Explorer.