Amazon Store Module

This is an implementation of the Amazon Product Advertising API (formerly Amazon Associates Web Service, or AAWS) for Drupal. You can install this and right away you have an Amazon Associates Store. Get yourself an Associates ID and then all purchases made through your store will result in a commission going to you. Allows searching, provides product pages, and manages a shopping cart.

Dependencies

  • Amazon module
  • Because of Amazon module you must have PHP5.2+

Nice-to-have

  • Panels module. If Panels is installed, there is a default amazon product page and multiple panel panes provided so you can customize it.
  • If thickbox is enabled then you get large-size images when you click on a product image.

Does not work with...

Amazon Store module does not work with the No Anonymous Sessions module, as it uses sessions.

Installation

  • Install and enable the module as usual. Prerequisites include
    the Amazon module (http://drupal.org/project/amazon) and optionally
    the panels module (http://drupal.org/project/panels)
  • Configure the various items in admin->settings->amazon.
    • You must enter an Access key and a Secret Access Key. You can get a free Amazon AWS account that will give you these here.
    • On the "storage" tab be sure to select either 24 hours or 12 hours.
    • In the 2.x versions of Amazon Store, you may use the various Amazon locales (UK, France, Germany, etc.). In 1.x, only US is supported.
  • Configure the various items in admin->settings->amazon store.
  • Optionally enable and configure the Item Detail Page panel. A default panel is provided. (Note that the 1.x releases support only Panels 2, and 2.x supports Panels 3.)
  • Make sure that cron is running at least daily or the items in the Amazon Store cache will quickly be out of date. To comply with your agreement with Amazon.com, you must make sure you don't cache things more than 24 hours.
  • Make sure that Amazon Module is set to retain cached items no more than one day. See admin/settings/amazon/storage.

Populating the basic store page

The module creates a store at /amazon_store - together with a menu link to it.

Via configuration for the Amazon Store Settings, you can populate this in three ways: via Amazon's default Search Index for a setting you choose (say, for books); via a "browsenode" (an Amazon code for sub-section of Amazon site - maybe not so well supported by Amazon), or by providing list of up to 10 product numbers for Amazon products.
You can find product numbers on product pages - look down left side for "Product Details": might be ISBN, or Amazon code. Note that if you list numbers, can separate with a comma only - no spaces.

Enabling and configuring the Item Detail Panel

To use a customizable panel for the Item Detail page, enable the panel in the "Panels" admin area, or on Panels 3, admin/build/pages. You can then specify the content, rearrange it, select boxes around the elements, etc. (Note: If using Panels 3, you must enable the Chaos Tools Page Manager module in order to enable and configure the Item Detail Panel.)

Theming

Most of the critical elements of display have .tpl.php files.

You can just copy the template file to your theme and modify it to suit.

For example, if you'd like to change the search results page, simply copy amazon_store_search_results.tpl.php to your theme directory and modify.

The Item display page also has a complete panels implementation. You can enable the panel and then mix and match panels to suit.

Please add your own information to this documentation. Together we can all improve it. Recipes on how to use Amazon and Amazon Store are solicited!

Making custom store pages using Views

The Amazon module offers excellent views support, and with Amazon Store installed, the links all go to the Amazon Store product detail page.

Guide maintainers

rfay's picture