Enter the various server settings and preferences where prompted. Each is described in detail below. Surf Shop attempts to auto-populate the fields when it can, but some configurations use aliases, or “linked” files so the program may not be able to detect the correct paths automatically. If you have trouble, you will need to obtain these values from your web host.
Enter the file path to the directory in which your web pages are located.
Enter the page you want to load by default when the customer clicks “Continue Shopping.” In most cases, they will be taken to the last page they visited, but sometimes this is not possible. For these cases, the default page is used.
Enter all domains that will be used to access this store. These are used to validate the origin of the CGI request. You may enter as many domains as you like, comma separated.
Enter the name of your company for use in e-mail responses. This will also appear in the <TITLE> of each generated page, unless you change it using the template admin.
The Working Mac
Enter the e-mail address to which you would like notifications sent.
Enter the path to your server's mail sending application. Common ones are “sendmail” and “qmail.”
/usr/lib/sendmail /usr/sbin/sendmail /var/qmail/bin/qmail-inject
Enter the URL to the surfshop folder, WITHOUT the http:// prefix.
www.yourdomain.com/cgi-bin/surfshop www.yourdomain.com/cgi-local/surfshop www.yourdomain.com/cgi-bin/cgiwrap/username/surfshop www.yourdomain.com/~user/cgi-bin/surfshop
Enter the URL to the surfshop folder using your SSL secure server. If no value is given, SurfShop will use the non-secure path entered in the previous field.
This will usually be your domain; however if you are sharing space on someone elses domain then enter the complete path to your document root. If you left the “Non-secure URL to SurfShop Directory” blank, then LEAVE THIS FIELD BLANK.
This URL allows SurfShop to display images using the SSL server. Enter the secure path to your public directory. If no value is given, SurfShop will use the “Non-secure URL to Document Root” setting.
Port number of SSL requests to your server. Defaults to 443.
This URL enables Catalog Image uploads. The default is /ssimages/store, but you can specify any directory on your website. The upload directory must be writable by the script for this feature to work. To disable uploads, leave this field blank.
This field enables the various “Plug-In” scripts for use with payment gateways.
secure.linkpt.net secure.authorize.net www.paypal.com
Like the “domain” field above, this is used to validate requests coming from your card processor. Enter the domain of your card service.
secure.linkpt.net secure.authorize.net www.paypal.com
Enter your PayPal business account email, if you are planning to use PayPal with SurfShop™.
Enter the name of the form field that contains the result of the transaction. The default value is
cardstatus STATUS TRANS_RES
Enter the value of a completed and approved transaction.
Enter the value transaction result field when the purchase is declined.
Enter the name of the field that contains the AVS (Address Verification) response code of an approved transaction.
Enter the name of the field that contains the rejection explanation response code of a declined transaction (it will be displayed in the “sorry” page when a purchase is rejected.)
Enter the name of the field that contains the authorization code returned from the bank. This is only necessary if you wish to log this code in your records.
Required for processors which use their own Reference ID. This is the way that the customer is identified to Surf Shop upon returning to the store. If your processor does not support custom fields, you may need to use this field. Otherwise, leave it blank.
Enter the number from which you would like Surf Shop to begin counting. It can be any number you like as long as it is a positive integer.
Enter the minimum order amount for wholesale customers. Enter '0' if you do not require a minimum order.
Enter the minimum order amount for retail customers. Enter '0' if you do not require a minimum order.
Enter the amount of an order over which you offer free shipping. Leave blank if you do not offer free shipping.
Enter the URL of your page header. Defaults to the demo, “Pet Fair” graphic.
Enter the currency symbol ($, ´, £, €, Eur, etc.)
Enter the number of decimal places you would like Surf Shop to calculate currency figures.
To display $1.00, check “before;” to display 10 Eur, check “after.”
Check “yes” to display $1,000,000 instead of $1000000
SurfShop™ automatically resets the user's browser after a period of inactivity. This value defaults to 60 minutes.
By default, carts that have been inactive for a period of 7 days will be automatically deleted from the system. You can change this period to any number of days you wish, as long as it is at least 1.
Enter “yes” if you want to receive a notice when an order is placed. Some stores get so busy that emails from each order become an annoyance.
Enter “yes” if you want the customer to receive a confirmation e-mail itemizing their order. Most people expect some kind of email confirmation, so disable this feature only if you have a really good reason to do so.
Enter “yes” if you want to send the order to a third party fulfillment house processor. The default output for this email notification is generated in XML. If XML is not required, you may wish to use the format of the other two email messages. See “Customizing Output.”
SurfShop works best with MySQL. If your ISP does not offer DBM or MySQL support, you can select “ASCII.” Otherwise, we recommend using DBM or MySQL for your databases.
If you will be using SurfShop with MySQL, you will need the following parameters:
If you do not wish to use SurfShop to keep track of your web store inventory, select “None.” To automatically deduct items from the inventory count in the catalog database each time an order is SUBMITTED, select “Upon Order.” You can modify the inventory counts at any time using the Web Store Admin.
If you wish to send your customers back to the static portion of your website, select “Website Home.” Otherwise, the program will go to the “start.htm” page by default.
Now, click “Configure SurfShop!” SurfShop creates all the necessary files and displays the results as it does so. If any of the files or directories are not set with correct permissions, Surf Shop will tell you at this point.
The last step is to choose an Admin username and password that will give you access to the “back-end” of your store.
If you are using a SSL server, SurfShop asks you to click a button to proceed. This doubles as a test of the SSL server to make sure it is configured correctly. At this point you should see the following window. Note, only SSL users will get the secure server message.
If any of the files or directories are not set with correct permissions under SSL, SurfShop will tell you at this point.
When you click “Set Password,” SurfShop™ creates .htaccess files in all of the SurfShop data directories. It also creates a special security file that will be required in order to view any information about your store. If you are not familiar with .htaccess, read “Web Essentials.”
Congratulations! You've just installed SurfShop!