.

 

Associate-O-Matic



v4.2.0
Supports US, UK, CA, DE & FR
 
 
Associate-O-Matic v4 Documentation   Last Updated: 2009-06-22
 
· Amazon
· Boxes
· CSS
· Cache
· Categories
· Colors
· Currency
· Custom Boxes
· Custom Pages
· Display
· Errors
· Filters
· Home Page
· Images
· Layout
· Merchant
· Meta Descriptions
· Meta Keywords
· Reports
· RSS
· SEO
· Search
· Shopping Cart
· Site
· Subcategories
· Tabs
· Text
· Titles
 
New Installation Instructions
 
Because of a change in Amazon's API, all versions of Associate-O-Matic prior to v4.2.0 will stop working on August 15, 2009. It is imperative that you upgrade your store to v4.2.0 or newer in order to avoid interruption.


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.

If you are installing Associate-O-Matic for the first time, here are the steps for installation. If you have any problems with the installation, please see the Troubleshooting section of our online documentation:

1. Unzip the files contained in the Associate-O-Matic ZIP 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/images/[all the image files]
  • /aom/cache/

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  [CHMOD 755]
  • /aom/images directory  [CHMOD 755]
  • /aom/cache directory  [CHMOD 755]
  • /ioncube directory
  • 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. Normally, simply uploading these files to your server will be all that is required. 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 see a number of settings.

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 (US)
Amazon.co.uk (UK)
Amazon.ca (CA)
Amazon.de (DE)
Amazon.fr (FR)

 
 
Featured in Inc. Magazine
Inc. Magazine
Featured Cool Site in AWS Blog
Amazon Web Services Blog
Featured in Web User Magazine
Web-User Magazine
CNET Download.com
Rate Associate-O-Matic
Rate us @ PHP Resource Index
 
Rate us @ Hotscripts.com
  
Gyrofly, Inc. © 2003-2009 Gyrofly, Inc.  All rights reserved.
All logos, service marks and trademarks belong to their respective owners.