=== Amazon Showcase Wordpress Widget ===
Contributors: forgueam
Donate link: http://www.aaronforgue.com
Tags: Amazon, widget, books, products, money, library
Requires at least: 2.0.2
Tested up to: 2.3.2
Stable tag: 1.2

A widget for showcasing items from Amazon. Simply enter the ASIN/ISBN number of any product and optionally enter an Associate ID.

== Description ==

Amazon Showcase is a Wordpress Widget/Plugin for showcasing items from Amazon. Simply enter the ASIN/ISBN numbers of any products and optionally enter an Associate ID for earning commissions. The product image will be displayed with a link to the product detail page on Amazon.com. More advanced users can have full control over the way the products are displayed.

== Installation ==

1. Unzip and place 'AmazonShowcase.php' and the 'AmazonShowcase_Assets' directory in the '/wp-content/plugins/widgets/' directory on your web server
2. Activate the 'Amazon Showcase' plugin from within the 'Plugins' section of your Wordpress administration area
3. You should now have access to the widget within the 'Presentation > Widgets' section

== Frequently Asked Questions ==

= What configuration options are available? =

There are several attributes available in this widget: Widget Title, Associate ID, Locale and Item ASIN/ISBNs & Image Sizes.

**Widget Title**
Use this attribute for naming your widget. The text entered here will be displayed above the Amazon Showcase items.

**Associate ID**
This is is an optional field that allows Amazon Associates to enter their Associate ID. When you supply an Associate ID, it is automatically inserted appropriately into the item's link. This allows you to earn commissions when people click on the item and purchase it through Amazon.

**Locale**
The locale field allows you to select which of the international Amazon websites you would like to pull items from.
You have 6 options:
* United States (.com)
* United Kingdom (.co.uk)
* Germany (.de)
* Japan (.co.jp)
* France (.fr)
* Canada (.ca)

**ASIN/ISBN**
Use this field to define the Amazon product you would like to display in the widget. This can be any item from the Amazon catalog of the locale you selected. Simply locate the item's ASIN or ISBN and enter it in one of these fields.

Exmaples:
ASIN: B000I1ZWRC
ISBN: 1582345236

**Image Size**
Amazon provides two different product image sizes: small or large. These can vary in dimensions, but typically the small version is about half the size of the large. Select the image size that you would like to use within your widget.

**Template**
Use the template field to define the HTML that is generated for each product. There are several pre-defined 'tags' that you can used as placeholders for product information. For example, any instance of the tag '[author]' in the template will be replaced by the product's author name when outputted.
Available tags: 
* [image] - The HTML for the product image
* [url] - The URL for the product's detail page on Amazon.com
* [title] - The title of the product
* [author] - The author of the product, if available

= Is it possible to change the style of the output? =

I've tried to make the output of the Amazon Showcase widget as clean and customizable as possible. Using CSS, you should be able to customize the look and feel of the item display. Additionally, you may customize the output of the widget to your specifications by using the optional 'Template' field.

This is the default structure of the HTML that is produced:

`<div id="amzshcs">
  <div class="amzshcs-item">
    <a>
      <img />
    </a>
  </div>
  <div class="amzshcs-item">
    <a>
      <img />
    </a>
  </div>
  <div class="amzshcs-item">
    <a>
      <img />
    </a>
  </div>
</div>`

== Screenshots ==

1. Configuring Amazon Showcase
2. Sample output