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

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.

== 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 'Presentation > Sidebar Widgets'

== 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.

= 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.

This is the structure of the HTML that is produced:

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

== Screenshots ==

1. Configuring Amazon Showcase
2. Sample output