Amazon Web Services (AWS) Products
Current version: 3.1.0
Amazon Web Services (AWS) Products Documentation
Version History
3.1.0 - 2011/04/23 (Travis Smith, Hop Studios):
- Added error message for missing keys
- Added .at and .es and .it stores
- Changed the AWS server it talks to
- Fixed a bug in “define_keywords”
3.0.0 - 4/24/2011
- First version for EE 2.x
- Added several more fields
- Fixed an error when multiple authors were available for a book
- Includes version 2.0.0 for EE 1.x
2.0.0 - 1/29/2010 (Justin Crawford, Hop Studios):
- Added aws_signed_request function to accommodate the new signed URL requirements on AWS;
- Made major changes to code formatting;
- Made minor changes to logic/data structures;
- Edited comments for brevity/clarity;
- Changed parameters/variable names for consistency with current EE convention;
- Added an item_id parameter for single-item lookups;
- Added a public_key and private_key parameter for signed URLs
- Revised conditional handling
1.0.0 - October 15, 2004 (Christian Leu, http://leumund.ch/):
- First Version based on Lynda’s Amazon Api Plugin
Installation
- Unzip the folder to a temporary location on your local hard drive
- FTP the following folder:
- /expressionengine/third_party/aws_products/
Usage
EXAMPLE 1:
{exp:aws_products:search limit="20" region="com" debug="no" associate_id="hopstudios" public_key="use_your_own" private_key="use_your_own"}
{define_keywords}blogging for dummies gardner{/define_keywords}
{if aws_total_results > 0}total results: {aws_total_results}<br />{/if}
{if aws_count > 0}count: {aws_count}<br />{/if}
{if amz_asin}amz_asin: {amz_asin}<br />{/if}
{if amazon_link}amazon_link: <a href="{amazon_link}">{amazon_link}</a><br />{/if}
{if product_name}product_name: {product_name}<br />{/if}
{if release_date}release_date: {release_date}<br />{/if}
{if catalog_type}catalog_type: {catalog_type}<br />{/if}
{if manufacturer}manufacturer: {manufacturer}<br />{/if}
{if publisher}publisher: {publisher}<br />{/if}
{if sales_rank}sales_rank: {sales_rank}<br />{/if}
{if number_of_pages}number_of_pages: {number_of_pages}<br />{/if}
{if best_price}best_price: {best_price}<br />{/if}
{if list_price}list_price: {list_price}<br />{/if}
{if amz_authors}amz_authors: {amz_authors}<br />{/if}
{if img_small}img_small: <img src="{img_small}" /><br />{/if}
{if img_medium}img_medium: <img src="{img_medium}" /><br />{/if}
{if img_large}img_large: <img src="{img_large}" /><br />{/if}
{if img_small_width}img_small_width: {img_small_width}<br />{/if}
{if img_medium_width}img_medium_width: {img_medium_width}<br />{/if}
{if img_large_width}img_large_width: {img_large_width}<br />{/if}
{if img_small_height}img_small_height: {img_small_height}<br />{/if}
{if img_medium_height}img_medium_height: {img_medium_height}<br />{/if}
{if img_large_height}img_large_height: {img_large_height}<br />{/if}
{/exp:aws_products:search}
EXAMPLE 2:
{exp:aws_products:search item_id="0470230177" associate_id="hopstudios" public_key="use_your_own" private_key="use_your_own"}
Great news! {product_name} only costs ${best_price} today.
{/exp:aws_products:search}
PARAMETERS:
- public_key = your “Access Key ID” THIS IS A REQUIRED ATTRIBUTE
- private_key = your “Secret Access Key” THIS IS A REQUIRED ATTRIBUTE
- item_id=“B000K21D4K” is an Amazon ASIN. THIS IS A REQUIRED ATTRIBUTE, UNLESS USING KEYWORDS TAG PAIR.
- associate_id=“hopstudios” configures an associate ID for Amazon’s affiliate program (default: “hopstudios”).
- region=“com” sets the domain suffix, i.e. which Amazon store (default: “com”). Non-US users may wish to change this.
- index=“Books” configures the search index (default: “Books”).
- limit=“5” sets the limit of results returned in multi-value result sets (default: “5”).
- debug=“yes” puts some additional output in template debugging (default: “no”).
TAG PAIRS:
{define_keywords}search for this, and this{/define_keywords}
allows you to search for keywords. THIS IS A REQUIRED ATTRIBUTE, UNLESS USING ITEM_ID PARAMETER. It doesn’t matter where you place this variable pair, but it MUST be defined inside the tags. If you are going to use a custom field for your keywords, also be sure that it has formatting set to NONE in your publish preferences.
If you’re displaying an image, it’s good practice to check that its width or height are greater than 1, since Amazon may return a blank 1x1 image if none exists.
{if img_small_width > 5}<img src="{img_small}" alt="{product_name}" />{/if}
Other Software
- Amazon Web Services (AWS) Products
Current version: 3.1.0 - Browser Search EExtensions
Current version: 1.0.0 - Deeploy Helper
Current version: 2.0.3 - Defensio for EE
Current version: Decommissioned - Edit This
Current version: 2.1 - Feed URL
Current version: 1.0.0 - Listifier
Current version: 1.0.0 - Publish Improve
Current version: 2.0.1 - Publish That
Current version: 1.0.0 - Reeveal Comments
Current version: 1.0.4 - Tag Extra
Current version: 0.8 - Word Cleaner
Current version: 1.0.0
- ExpressionEngine: Total Guests and Most Visitors
January 31, 2012 - Book Now!
January 30, 2012 - Innovation for a Stanford Journal
January 3, 2012
Tweet
| 604.408.5722 |
| 604.357.5001 |
