Setup¶
Once you have installed Moola : Amazon Edition you will need to set up a few things for your initial usage.
Main Configuration¶
From the Admin backend, go to Components->Moola : Amazon Edition. This will bring you to the main admin page for the component. This page will verify that your Amazon credentials are present and correct whenever you open it.
With the initial install you will not have any credentials saved, so you will need to do that first.
Parameters¶
Towards the upper-right of the screen there should be a button labeled "Parameters", click on that to open up the parameters window for Moola : Amazon Edition.
There are several fields within this window. The most important ones are 'Access Key ID' and 'Secret Access key', these are provided by Amazon and are required to allow you to remotely interface with their API (which is what this component does). If you do not have these keys you can sign up at https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html (this may also require you to sign-up for additonal services).
Access Key ID, Secret Access Key, and Associate ID are all required parameters!
You must set the following parameters for the plugin to work:
- Access Key ID
- Secret Access Key
- Associate ID
These 3 values must all be associated with each other. You can't use a random associate ID, you must use the associate ID that owns the Secret Access Key.
Once you have your credentials you can enter them into the parameters window and click on 'Save'. the 'Access Key ID' and the 'Secret Access key' are the only parameters that are required for the component to work. The fields for 'Keywords' and 'Search Index' allow you to specify defaults that the component will use if not specified anywhere else. If you also have an Amazon Associate's ID, you can enter that into the last field in order to get money back from Amazon when people purchase products from your site.
Making Sure it Works¶
Once you save your credentials in the parameters window, you should refresh your browser or simply visit the admin page for Moola : Amazon Edition again. This will cause the component to attempt to use your new credentials to interface with Amazon. If any problems occur the system will tell you what errors were returned by Amazon. Typically, the only issues will be that of incorrect credentials.
Once the page displays the Congratulations text, informing you that it was able to succesfully communicate with Amazon, you can safely leave the page and begin using the component and modules themselves.
Next Step: Using The Component