SPADS ©   Apple Cart ©   v9.0
Copyright 1997 - 2005 All Rights Reserved
Written by: Vince Creazzo email: vcreazzo@spads.com
http://www.spads.com

README.HTM

New Features:

We Have added three (5) new main features this time:

1.) New Authorize.Net - 100% Certified - Support for the cardholder authentication programs,
      Verified by Visa and MasterCard SecureCode™ and an exclusive Fraud Detection Suite!

2.) New Setup and Configuration front end, No need to edit any program files anymore,
      All settings are now Controled and Changed in and from the Administrators console!

3.) New Pay Cash System from Cyphermint

4.) New Multi Product Pricing feature

5.) New UPS Shipping by weight and destination rates

Help: Installation

*************** FIRST STEP ***************

The first thing you should do is Unzip the program file on your desktop computer, letting it create the necessary directories and putting the files that go in them. Next create the same directory structure on your web site and copy the appropriate files up in ASCII Mode, (See CGI-BIN: Directory Structure Example below!)

Use ASCII mode for all FTP uploads, except Image files, those you upload in Binary Mode only.

Next if you uploaded all of the program files into your /cgi-bin/acart/ directory, is to CHMODE all of the files with a .pl extension to 755 and the counter.txt to 777. and the files listed below to 766

  apple-cfg.pl -   ↓ CHMODE 766 - if Unix/Linux type Servers
  comp_cfg.pl,
  mail_cfg.pl,
  html_cfg.pl,
  tax_cfg.pl,
  ship_cfg.pl,
  auth_cfg.pl,
  boa_cfg.pl,
  veri_cfg.pl,
  ppal_cfg.pl,
  cym_cfg.pl


Next CHMODE the 'data' , 'order' , 'secure' Directories to 766 or 777. All files inside should be set to CHMODE 766

Leave 'originals' directory alone, It holds copies of the original configuration files that come with the program.
( Just in case you mess up editing, you will have copies of the original setup files to install or copy over again! )

Note: CHMODE is Not Understood or Neccessary on Windows Servers!

If the program is not responding, then Your Hosts permissions are not set to FULL or SPECIAL CONTROL, etc. - Windows Servers Only!

Quick Note:   " header.txt " and " footer.txt " are located in the /cgi-bin/acart/ ← Directory in which you can edit, " header.txt " which is the top half of your html page (for the cart) and " footer.txt " which is the bottom (Closing Tags) half of your Carts html page, These files you can edit to suit your site!

*************** NEXT STEP ***************

After you have finished, open your browser and go to http://www.yourdomain.com/acart/admin_install.htm

This is the Information and Admin Login page admin_install.htm Default username: admin password: today

Login using the username and password above, then Select SETUP/CONFIGURATION. Button

You will be presented with 11 choices to setup!

  • Main Program Configuration                    ↓ Program Setup Options
  • Company Information Configuration
  • Program Email Configuration
  • Program HTML Configuration
  • Program TAX Configuration
  • Program Shipping Configuration
  • Program Authorize.net Configuration        ↓ Payment Gateway Options
  • Program Bank of America Configuration
  • Program VeriSign Configuration
  • Program PayPal Configuration
  • Program Cyphermint Configuration

    Then Starting with the Main Program Configuration, select Edit Main Configuration Button.

    You will then be presented with a Form that will have your sites information, Look it over and check to see if all is correct and or change settings to suit.

    Note: the Program will pre fill in the form with information it has obtained from your server, since all servers are different it might not be a 100% correct, or you might want to change the way things are setup! So Caution is urged to verify your settings. ( Use the Test Environment program link to check your settings. )

    Important: you should change your username and password at this time as well, you will be required to re login with the new username and password. (So write it down!)

    Once you have logged in again, proceed to the the next option Company Information Configuration, Change to suit, and repeat for all options except Payment Gateway Options. All payment options are set to No by default, so only edit the ones that you want to use!

    Note: If you are going to use Authorize.net payment option, you will need to return to the admin console and Select Authorize Console Button, re login (security) and put in the required merchant information and press submit, once the screen refreshs and you again see what you have inputted is the same, you are done!

    Security Note:

    If you are using AIM Method, you will have another button in the Admin Console called,
    Transaction Database. This Database should be Viewed Daily.

    All Compeletd Transactions, should be Viewed, Processed if (AUTH_ONLY), Printed and Deleted!

    These transaction records could assist you in charge back issues, so Print and then Delete them!!

    Keep this database as empty as possible for Security Reasons and Database size constraints.....

    *************** Examples ***************

    CGI-BIN: Directory Structure Example
    /users/www/yourdomain/cgi-bin/acart/             ← Program files
    /users/www/yourdomain/cgi-bin/acart/data/        ← Database files
    /users/www/yourdomain/cgi-bin/acart/orders/      ← Order work files
    /users/www/yourdomain/cgi-bin/acart/originals/   ← Original Configuration files
    /users/www/yourdomain/cgi-bin/acart/secure1/     ← Authorize.net account info files
    /users/www/yourdomain/cgi-bin/acart/secure2/     ← Authorize.net account info files
    
    SECURITY NOTE:
    You can and should locate your Secure1, Secure2, Orders and Data directories to somewhere on your Server that is more secure and not accessible from the web. i.e.:
    /users/www/acart/data/ ← Database files /users/www/acart/orders/ ← Order work files /users/www/acart/secure1/ ← Authorize.net account info files /users/www/acart/secure2/ ← Authorize.net account info files
    As long as you put the correct corresponding path in the Main Program Configuration section of the Administrator's Setup/Configuration Console you should be fine!
    ROOT: Directory Structure Example
    /users/www/yourdomain/acart            ← Product html pages
    /users/www/yourdomain/acart/down/      ← Download directory
    /users/www/yourdomain/acart/help/      ← Program Help Pages
    /users/www/yourdomain/acart/images/    ← Program Image directory
    /users/www/yourdomain/acart/reports/   ← Program exported report files
    /users/www/yourdomain/acart/uploads/   ← Program Upload directory
    
    

    If you run into problems, Please write down what error message you are getting along
    with any other messages and Email me at, webmaster@spads.com and I'll try to help!
    If you think your in over your head! We can install this script for you, Cost $50.
    Error Note: If you have a problem running the progam, you might want to check the
    very first line of the program script (at the very top) you will see,
    #!/usr/bin/perl - you may have to change this to point to your servers perl program,
    #!/usr/local/bin/perl - or something like that. if your not sure were it is, ask your ISP.

    also run the testenv.pl it can give you important path information that will help you to
    setup the program! just call it from the browser http://www.yourdot.com/cgi-bin/testenv.pl

    Contact: webmaster@spads.com
    Thanks, enjoy!


  • © Copyright 1996 / 2005, SPADS ©   Apple Cart ©