SurfShopCart Documentation

Setting Up Shop Has Never Been Easier!

User Tools

Site Tools

Action disabled: register

Global Config Settings

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.

Global Config Fields

Path to your Document Root

Enter the file path to the directory in which your web pages are located.

  • Preceding Slash is Required



Home Page URL

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.


Domains used by this store (comma separated)

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.


Merchant Company Name

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

Merchant Email Address

Enter the e-mail address to which you would like notifications sent.


Mail Program

Enter the path to your server's mail sending application. Common ones are “sendmail” and “qmail.”



Non-secure URL to SurfShop directory

Enter the URL to the surfshop folder, WITHOUT the http:// prefix.

  • IMPORTANT• Some server configurations do not permit files to be shared between SSL and non-SSL (clear text) websites. If this is true in your case, or if your secure server is on a completely separate machine from your website, LEAVE THIS FIELD BLANK.

Secure URL to SurfShop directory

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.

  • DO NOT include the https:// prefix in this field.


Non-secure URL to Document Root

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.


Secure URL to Document Root (optional)

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.

  • DO NOT include the https:// prefix in this field.


SSL Port

Port number of SSL requests to your server. Defaults to 443.

Relative path to image upload directory

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.

  • NOTE: Preceding Slash is Required



Card Service Vendor(s)

This field enables the various “Plug-In” scripts for use with payment gateways.

  • Leave this field blank if you are not using a Plug-In script.


Card Service Domain

Like the “domain” field above, this is used to validate requests coming from your card processor. Enter the domain of your card service.

  • Note: Do not include the entire URL you use to call your card processor in this field - just the primary domain. The full URL will be included in the confirm.htm template.
  • Note: Leave this field blank if you are not using SSL. Otherwise, SurfShop will generate an error if when returning from a payment processor website.


If using PayPal, enter PayPal account ID (e-mail)

Enter your PayPal business account email, if you are planning to use PayPal with SurfShop™.

Name of transaction result field

Enter the name of the form field that contains the result of the transaction. The default value is



  • Note: In order for SurfShop™ to complete any transaction, the transaction result field MUST contain a value.

Value when approved

Enter the value of a completed and approved transaction.



Value when declined

Enter the value transaction result field when the purchase is declined.



Name of AVS result field (optional)

Enter the name of the field that contains the AVS (Address Verification) response code of an approved transaction.

Name of "Reason for Decline" field (optional)

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.)

Name of Authorization Code field (optional)

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.

Name of "Reference Number" field

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.

Order Log (invoice) starting number

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.

Wholesale Minimum Order

Enter the minimum order amount for wholesale customers. Enter '0' if you do not require a minimum order.

Retail Minimum Order

Enter the minimum order amount for retail customers. Enter '0' if you do not require a minimum order.

Free Shipping Minimum

Enter the amount of an order over which you offer free shipping. Leave blank if you do not offer free shipping.

Custom Header Graphic URL

Enter the URL of your page header. Defaults to the demo, “Pet Fair” graphic.

Currency Symbol

Enter the currency symbol ($, ´, £, €, Eur, etc.)

Currency Precision

Enter the number of decimal places you would like Surf Shop to calculate currency figures.

Location of Currency Symbol (in relation to amount)

To display $1.00, check “before;” to display 10 Eur, check “after.”

Insert commas in currency output?

Check “yes” to display $1,000,000 instead of $1000000

Expire unregistered carts after [ ] minutes of inactivity.

SurfShop™ automatically resets the user's browser after a period of inactivity. This value defaults to 60 minutes.

Prune all carts after [ ] days of inactivity.

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.

Send Notification Email to Merchant

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.

Send Confirmation Email to Customer

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.

Send Notification Email to Fulfillment House

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.”

Database Type

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.

MySQL Info (if applicable)

If you will be using SurfShop with MySQL, you will need the following parameters:

  • Database: The name of the local MySQL database for your account.
  • Host: The internet name or address of the server hosting the MySQL database. Defaults to “localhost” (same as website).
  • Username: The user under which you want Surf Shop to access the MySQL database
  • Password: The MySQL password for this user.

Use Inventory Tracking

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.

On cancel, send customer to

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.

Submit Settings

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.

Administrative Username and Password

The last step is to choose an Admin username and password that will give you access to the “back-end” of your store.

  • NOTE: When choosing a username and password, you may use only alphanumeric characters and the underscore. No other characters are allowed.

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!

Main Page

global_config_settings.txt · Last modified: 2018/08/13 00:16 by kinetic8sp