http://www.surfshopcart.com/dokuwiki/ 2012-05-18T17:49:58-04:00 http://www.surfshopcart.com/dokuwiki/ http://www.surfshopcart.com/dokuwiki/lib/tpl/prsnl10/images/favicon.ico text/html 2010-12-20T16:29:40-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=adding_and_modifying_products&rev=1292880580&do=diff Items must exist in the catalog database before you can present them for sale on your website. To add or modify items in your SurfShop™ catalog database, go to admin.cgi and select “Edit Catalog.” You will see a list view of your current catalog which you can navigate, 20 items at a time. From this page you can: text/html 2010-12-20T16:29:42-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=additional_features&rev=1292880582&do=diff Returning Static Web Page If you want SurfShop™ to display the originating catalog page form instead of the customer's cart when an item is added, include the “return_page” parameter and set its value to the URL of the page to which you wish the customer to return. After SurfShop™ adds the item to the customer's cart, it will display the page passed in the “return_page” field. text/html 2010-12-20T16:29:41-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=background&rev=1292880581&do=diff SurfShop began as a simple order form script in the fall of 1999. As time progressed, customers began asking for the script to do certain things they couldn't find in other shopping cart scripts. By the middle of 2001, SurfShop had become a full-featured E-commerce system. text/html 2010-12-20T16:29:41-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=calculations&rev=1292880581&do=diff SurfShop™ allows for amounts to be added to, or deducted from, the customer's order based on an endless combination of variables. Examples are Tax, Discounts, Shipping and Handling charges. You should be able to generate virtually any amount using the SurfShop™ calculation system. text/html 2010-12-20T16:29:42-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=categories&rev=1292880582&do=diff Categories are groups into which catalog items are assigned. * You may create up to 1,000 total unique categories. * Categories can be divided into sub-categories, with up to 100 categories per tier. * Each category has a corresponding category code. The code consists of a two-character sort order and a three-character category id, which is assigned by SurfShop™. * Each category's code is created by combining its “parent” code(s) with its own, separated by a dash. * When you change… text/html 2010-12-20T16:29:42-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=check-out_options&rev=1292880582&do=diff You can customize the way SurfShop™ handles the “buy sequence” during checkout, as well as fine-tune the various methods of payment using the Check Out Admin. Allow payment by Mail If you do not plan to use any real-time payment options, you can always use snail-mail text/html 2010-12-20T16:29:42-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=coupons_and_gift_certificates&rev=1292880582&do=diff Gift Certificates are special Catalog Items that you can sell to your customers to redeem at your site as cash. Coupons (for special promotions) give discounts off the total amount of the order when used. SurfShop™ keeps track of the Gift Certificates and Coupons as they are used so you can monitor their activity. There are also several checks and balances to prevent the system from being abused by your web visitors. text/html 2010-12-20T16:29:43-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=customer_accounts_and_sign-in&rev=1292880583&do=diff You can set up SurfShop™ to allow customers to create accounts that remember their billing information and order history. To use Customer Sign-In, select “Use Customer Sign-In” in the template options admin. See Template Options. When this feature is enabled, a sign-in console appears at the top of the page next to the customer's “cart.” In addition, Links to to “Create and Account” become visible on the page. text/html 2010-12-20T16:29:43-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=customizing_output&rev=1292880583&do=diff Once you are familiar with the system, you may begin to customize the output templates. SurfShop™ uses a special system of “Templates,” “Parameters” and “Place Holders” to generate the output. Output Terms Templates are HTML files which are read by SurfShop™ and combined with data to form the output. text/html 2010-12-20T16:29:43-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=email_options&rev=1292880583&do=diff There are several e-mail messages that are used by SurfShop™ to notify pending sales and login information. These messages can be edited from the WebStoreManager. Message Fields Many of these fields are populated by SurfShop™ place holder tags; however, they can be manually entered as well. text/html 2010-12-20T16:29:43-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=force_complete_delete_carts&rev=1292880583&do=diff Certain payment processors (PayPal, for example) require that the customer direct their browser (usually without their knowledge) to their remote server to process a secure transaction. After the transaction is complete, the browser is then returned to the originating website to complete the order. text/html 2010-12-20T16:29:43-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=getting_started&rev=1292880583&do=diff Welcome to SurfShop. Our goal is to provide a web store program that can be used ON ANY UNIX-BASED SHARED HOSTING ENVIRONMENT and is COMPLETELY PORTABLE so if you change ISPs, you can take your store with you. We hope you find this script to be the most versatile web store system available today. text/html 2010-12-20T16:29:44-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=global_config_settings&rev=1292880584&do=diff 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. text/html 2010-12-20T16:29:44-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=importing_exporting_databases&rev=1292880584&do=diff Exporting Databases All databases can be exported from the WebStore Manager into a plain text format for use with Excel, Access, FileMaker Pro or any other database program. You can use the Web Store Manager to export your data as a text file as either tab-separated or comma separated values. text/html 2010-12-20T16:29:44-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=installation&rev=1292880584&do=diff We recommend that you print this document and follow along as you go through the installation process. It is a lot less intimidating than when you see it in your web browser. Quick Start Installation * Check that the CGI’s are pointing to perl5 on your server (i.e., #!/usr/bin/perl, etc.) * Upload the following directories and ALL THEIR CONTENTS: surfshop -> cgi-bin (use ASCII mode) ssdata -> user directory above document root if possible (use ASCII mode) ssimages -> document r… text/html 2010-12-20T16:29:44-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=managing_customers&rev=1292880584&do=diff Each time a new customer (identified by the Email address) purchases something from your store, a new customer record is entered into the Customers Database. If you have chosen to use “Customer Sign-In,” then their record will also include a password, and the customer will be able to Sign-In the next time they visit the store. text/html 2010-12-20T16:29:45-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=minimum_requirements&rev=1292880585&do=diff Our goal was to create a system which will work on ANY UNIX SERVER, under ANY CONFIGURATION, provided you have the following at a minimum. You need: * A basic knowledge of HTML, especially forms (but only if you plan to change or add code to your store). text/html 2010-12-20T16:29:45-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=other_payment_methods&rev=1292880585&do=diff SurfShop allows you to enable payment by any number of methods. You can also specify another method if you so choose. In order to make the system work as it was designed, you must include certain elements in the “Check-Out Form” section of the “Check-Out Options” admin page. text/html 2010-12-20T16:29:45-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=payloads_downloadable_products&rev=1292880585&do=diff You can use SurfShop™ to sell online products such as software or e-books. SurfShop™ automatically creates the download links when the order is completed, both on the receipt page that is displayed and in the confirmation email that is sent. Each time the customer downloads a file using any of these links, SurfShop™ automatically updates the customer's order record. Once the total number of products ordered has been downloaded, the program will not deliver any more downloads for that order.… text/html 2010-12-20T16:29:45-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=security&rev=1292880585&do=diff Hackers are everywhere. Running a website is a calculated risk. There are textbooks full of ways to break into every web server on the market, so if someone decides to make your website a target, they probably will. We have attempted to write the program so that it will not allow anyone to use the CGI script as a means to gain access to your server, and will post free updates as soon as any security holes are discovered, but NO SYSTEM IS 100% HACK PROOF. text/html 2010-12-20T16:29:45-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=setting_up_payment_processing_setting_up_payment_processing_overview&rev=1292880585&do=diff SurfShop™ is designed to utilize several common Payment Processors by default. Click the links below for instructions on these “pre-configured” processors. * PayPal WebAccept/IPN * AuthorizeNet AIM * LinkPointConnect (formerly “Basic”) * LinkPointAPI text/html 2010-12-20T16:29:46-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=shipping_calculations&rev=1292880586&do=diff An order uses a single “shipping method” to calculate the shipping cost. This amount is the combination of any “item-specific” shipping calculations and the result of the selected shipping method's calculation. SurfShop automatically compiles a menu of available shipping options based on a number of factors. Once a shipping method is selected, it is used to calculated the shipping cost. text/html 2010-12-20T16:29:46-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=start&rev=1292880586&do=diff [SurfShopPRO] SurfShop is a rock solid, perl based e-commerce shopping cart system that comes in 4 versions: * SurfShopFREE * SurfShopLITE * SurfShopPRO * SurfShopUNLIMITED Getting Started * Getting Started Overview * Minimum Requirements * Installation * Global Config Settings * Setting Up SurfShop * Linking to SurfShop * Security * Troubleshooting and Error Messages text/html 2010-12-20T16:29:46-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=tax_calculations&rev=1292880586&do=diff Any calculation that is not specifically set as a shipping method can be considered a “tax calculation.” Typically, tax is calculated on the “Pre-Tax Total” or “Pre-Tax Taxable Total” order amounts. It should be added to the total using the “As Tax” option. This allows for discounts and Coupons to be factored in before tax is calculated. text/html 2010-12-20T16:29:46-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=template_options&rev=1292880586&do=diff Search Options You can customize the way SurfShop™ returns search results. Number of Columns: (1 or 0 for row format) - Enter 1 if you prefer a list format, or a higher number if you prefer to show your products in multiple columns. Number of Results per page - Enter the number of items you wish to return per page. We recommend a smaller number if you are using multiple columns, as they tend to load slower. text/html 2010-12-20T16:29:46-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=troubleshooting_and_error_messages&rev=1292880586&do=diff Sometimes a little additional troubleshooting is necessary to get the program up and running. If you are not familiar with FTP, File permissions, CGI or Unix, read the section entitled Web Essentials elsewhere in this document. 500 Internal Server Error or "Premature end of script headers" This is the most common problem that occurs with CGI scripts. It means the program crashed somewhere for some reason. 95% of our support questions are answered in the next several paragraphs. Start with (1) … text/html 2010-12-20T16:29:47-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=user_adminstration&rev=1292880587&do=diff Admin Access Levels Authorized SurfShop™ Users can be one of three types: Administrator Administrators have access to all aspects of the system, including the User Admin. There must always be at least one Administrator-level user in the system. text/html 2010-12-20T16:29:47-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_authorizenet&rev=1292880587&do=diff STEP 1 In your Authorize.Net admin, make sure you have done the following: * Click “Settings” * Click “Direct Response” * Set “Delimited Response” to “Yes” * Choose “|” (pipe) as the default field delimiter (or another character, if desired) * Leave Field Encapsulation character blank * Click Submit. text/html 2010-12-20T16:29:47-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_linkpointapi&rev=1292880587&do=diff STEP 1 Get the lpperl.pm module from LinkPoint. We cannot include it for legal reasons. Please also note that LinkPointAPI requires the “curl” application. Contact your ISP if you have any questions about whether “curl” is installed on your host server. text/html 2010-12-20T16:29:47-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_linkpointconnect&rev=1292880587&do=diff STEP 1 * Sign On to LinkPoint Central. * Click “Customization” * Click “Configure your LinkPoint Basic” * Sign On Again You will see the following: Merchant Account Setup: -Your Store ID- The suggested Surf Shop responses are indicated by [BRACKETS] text/html 2010-12-20T16:29:47-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_paypal&rev=1292880587&do=diff SurfShop™ comes pre-configured to work with PayPal out-of-the-box. Just leave the defaults and follow the steps below: STEP 1 In “Check-out options”, select “Use PayPal” as a payment method. STEP 2 Check your “Global Settings”: PayPal Email address:you@your-email-addressCardservice Vendor(s): PayPalCardservice domain(s):www.paypal.com *see note, belowName of transaction result field:statusValue when approved:approvedValue when declined: declinedName of AVS result field:leave blankName of … text/html 2010-12-20T16:29:48-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_surfshop_with_quickbooks&rev=1292880588&do=diff Not Fully Implemented Yet QuickBooks support is not fully implemented at this time. <<Main_Page text/html 2010-12-20T16:29:48-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=using_the_webstoremanager&rev=1292880588&do=diff Point your browser to admin.cgi. The path should be something like: http://www.yourdomain.com/cgi-bin/surfshop/admin.cgi Log in using the administrative username and password you set in autoconfig.cgi. At the top of the Admin page is a dropdown menu. From here you can control all aspects of your store, including the look and feel. text/html 2010-12-20T16:29:48-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=viewing_and_processing_orders&rev=1292880588&do=diff The “View Orders” admin page displays all of the orders that have come into your store, sorted by most recent. You can use the finder at the top of the page to locate orders by date. Orders can be confirmed as “shipped” from the list view or deleted from the database all together. text/html 2010-12-20T16:29:49-04:00 http://www.surfshopcart.com/dokuwiki/doku.php?id=wish_list&rev=1292880589&do=diff The Wish list is like a second shopping cart that the customer can use to save items in which they may be interested, but not ready to buy right away. It is a good tool to encourage “browsing” customers to come back and buy. To use the Wish List feature, select “Use Wish List” in the Template Options Admin. See Template Options.