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,
  codes.pl,
  select_codes.pl,


Next CHMODE the 'data' , 'order' , 'secure' , 'templates' 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 re 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
/users/www/yourdomain/cgi-bin/acart/templates/   ← Database Display template files 

Note: The templates directory can be placed any were on your site,
but you have to put the correct location in the config section!

# Template directory
$tmpl_dir = "/users/www/yourdomain/cgi-bin/acart/templates"; ← Default

OR

$tmpl_dir = "/users/www/yourdomain/templates"; ← Might look like this!

HTML ROOT: Directory Structure
    

    /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

    
# 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 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 or try Clicking Here! 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

    

Products Admin console:

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

    
The Search Box can be changed in the Products Admin console!

    
There you can edit Text for Search Box Titles, Category Names and Codes, add Products, Upload Images and Databases to suit.