Associate-O-Matic v5 Documentation   Last Updated: 2013-11-26
 
 
   STORE
· Getting Started
· Amazon
· Categories
· Home Page
· Merchant
· Shopping Cart
· Site
· Subcategories
 
   CONTENT
· Built-In Boxes
· Custom Boxes
· Custom Pages
· Currency
· Display
· Meta Descriptions
· Meta Keywords
· Reviews
· RSS
· Search
· Titles
 
   APPEARANCE
· Background
· Buttons
· Colors
· CSS
· Images
· Layout
· Tabs
· Text
· Themes
 
   OPTIMIZE
· Advanced
· Cache
· Errors
· Filters
· Reports
· SEO
 
 
 New Installation Instructions
 
If you are upgrading from a previous version of Associate-O-Matic or from the Trial to the Full version please read the Upgrade Instructions.

- OR -

If you are installing Associate-O-Matic for the first time, please follow the installation steps below:
 
 

1. Unzip the files contained in the Associate-O-Matic ZIP or EXE file to your local hard drive. Make sure they retain the original directory structures. Make sure you see an /aom directory after you unzip the files.

TIP: To unzip .ZIP files you need a program such as WinZip.
   
2. Open your FTP client software (or use the control panel provided by your web host) and upload the Associate-O-Matic files to your server (web host).

TIP: Some FTP client software examples are FileZilla, CuteFTP and SmartFTP.

First, upload (FTP) the encrypted PHP files in BINARY mode which are:
  • shop.php
  • admin.php
Then, upload all of the remaining files and let your FTP software decide the mode to use whether it be ASCII or BINARY.
  • /aom/[all the files]
  • /aom/cache/
  • /aom/colors/
  • /aom/css/
  • /aom/images/
  • /aom/includes/
  • /aom/item/
  • /aom/js/
  • /aom/lang/
  • /aom/themes/
  • /aom/tpl/
  • /ioncube/
Ideally, you would FTP the files to your main public site directory. Just make sure you don't overwrite any of your existing non-AOM files if they happen to be named the same.

Example Store URLs:
  • http://www.yoursite.com/shop.php (best choice, shortest URL)
  • http://www.yoursite.com/dir1/dir2/shop.php (also works, longer URL)
The shop.php and related files can be placed anywhere off your public directories so long as the hierarchy of Associate-O-Matic files remains the same in relation to themselves.
   
3. Set the permissions for provided files/directories.

Normally this can be done by right-clicking on the file or directory from your FTP client.

NOTE: Windows users should contact their web hosting provider to determine the best method for changing file/directory permissions. Most likely they will provide a mechanism to do this within their control panel.

The permissions for Linux/Unix users are as follows and can vary from web host to web host:

NOTE:  You may need to modify your permissions beyond the below recommended settings. You'll know because Associate-O-Matic will give you cues that you still need to write and/or read enable a particular folder such as /aom. For example if 775 doesn't work you may need to make it 777.
  • shop.php  [CHMOD 644]
  • admin.php  [CHMOD 644]
  • /aom directory and subdirectories [CHMOD 755]
  • /ioncube directory [CHMOD 755]
  • all other permissions should be fine by default
   
4. We use ionCube PHP Encoder to protect our source code. Associated files are found in the /ioncube directory.

For step-by-step instructions on what you need, open the /ioncube/loader-wizard.php in a browser.

If you have any problems related to ionCube, please more in-depth ionCube installation instructions.
   
5. You can rename your shop.php and admin.php files or leave them as is.

If you rename the files, be sure to keep the .php extension on the end.

For example, instead of:
http://www.yourdomain.com/shop.php

You could name it:
http://www.yourdomain.com/best_store_ever.php
   
6. Now that all of the files are on your server, it's time to open the Associate-O-Matic Control Panel.

This would be the admin.php file or the new name if you renamed it.

For example, in a web browser open the address replacing "yourdomain" with your domain name:
http://www.yourdomain.com/admin.php

NOTE:  The first time you open the Control Panel, you'll be asked to enter your login username and password. Once set, you'll be asked for this login on all subsequent visits. If you ever decide to change your login, simply delete the file in the /aom directory called cfg.login.php. You'll then have a chance to reset the password. You can also reset the login from within the control panel.
   
7. Once you enter the Control Panel, you'll start in the Getting Started section.

At this point you'll want to make sure you enter your correct Amazon Associate ID, Amazon Access Key ID and Amazon Secret Access Key. Please see the Amazon section of our documentation for more information. Also, enter the main information for your store. Please see the Site section of our documentation for more information.

Don't be overwhelmed by the number of customizations you have at your disposal. You can actually save your settings at this point just to make sure everything works. Or go ahead and enter some more of your site details and then save. In the Control Panel Settings section of our online documentation, we describe in much more detail each of the various settings. You can login to your Control Panel at any time and update your settings.
   
8. If you would like your domain name to point to your store page (shop.php), please read this post in the Tips & Tricks section of our forum:

http://www.associate-o-matic.com/forum/viewtopic.php?t=52
   
9. Congratulations! You're done. Lastly, view your store from within a web browser. For example:
http://www.yoursite.com/shop.php
 

IMPORTANT NOTE:
If you see a blank screen or errors, please see our troubleshooting section.

ANOTHER IMPORTANT NOTE:
Make sure you are using an Amazon Associate ID that matches the locale of your store otherwise you won't receive credit for sales from Amazon.

Register at the appropriate locale:

Amazon.com  (United States)
Amazon.co.uk  (United Kingdom)
Amazon.ca  (Canada)
Amazon.de  (Germany)
Amazon.fr  (France)
Amazon.co.jp  (Japan)
Amazon.it  (Italy)
Amazon.cn  (China)
Amazon.es
 (Spain)