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, or your cgi-bin is not active, 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 Cyphermint Configuration
  • Program Bank of America Configuration
  • Program VeriSign Configuration
  • Program PayPal 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: You have to re login when you change your Usename or Password!

    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!

    *************** 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: (Unix/Linux Chmode all below directories and files to 766) 
    
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



    Notes: Installation Variables

    
# Windows uses double back slashs "\\" and Unix uses single forward slash "/"
# on machine paths to your sites directories on the server
# i.e. $htmlroot = "\\yourdirectory\\acart";  ←  Windows servers
# i.e. $htmlroot = "/yourdirectory/acart";    ←  Unix/Linux servers

# This is the machines path to your root directory
$htmlroot = "/users/www/yourdomain/acart";   ← directory where Product html pages are keep

Note: You don't have to use the ACART directory or any of the pages,
(They are there as a guide for you to use or not and you can do whatever you want to them to make them yours!)

you can put files in your root directory if you want to just change the path to
$htmlroot = "/users/www/yourdomain";

The $htmlroot is a very important because all other paths are taken from this path.
To make sure it is correct, I have given you a small program called testenv.pl

Just call it from your browser, i.e. http://www.yourdomain.com/cgi-bin/acart/testenv.pl
and hit enter on your keyboard. When the program runs you will be presented with your sites
environment report, which you will see the paths you need as well as other important information.

You will also see at the bottom of the page a button that Says See Perl Modules Installed
Press it to see if your server has the necessary Perl modules installed to run your payment options!

Whatever you are missing write it down and ask your host to install them for you,
(they are free) as these modules can not be installed by anyone other than the Servers Administrator or they won't work!

# Program Directory in the cgi-bin were the program files are kept
$homedir = "/users/www/yourdomain/cgi-bin/acart";   ←  Program directory in the /cgi-bin/acart

# Program Download Directory if you are selling downloads
$download_dir = "/users/www/yourdomain/acart/down";  ← Download directory in the /yourdomainroot/acart

    


    
Admin console:

    
The Login page is admin_install.htm Default username: admin password: today