Acts as Amazon Product
Ruby
Pull request Compare This branch is 24 commits behind netphase:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
generators/acts_as_amazon_product_migration
lib
tasks
test
.gitignore
CHANGELOG
COPYING
README
Rakefile
init.rb
install.rb
uninstall.rb

README

= ActsAsAmazonProduct

This "acts_as" module makes it extremely simple to add Amazon integration to an 
existing model.  

== Setup

This code does not require changing any current database tables.  It only requires 
adding one migration for a single new table used to cache responses from Amazon.
Run the following to create the migration:

  script/generate acts_as_amazon_product_migration

== Using acts_as_amazon_product

Add the "acts_as" line to your model.  Only :access_key is required.  The :asin and 
:name assignments override what attributes in your class should be used for a direct 
lookup (item_looup) or general search (item_search).  If no value is assigned to :asin 
then a general search is made and the first item (sorted by salesrank) is assigned 
(this functionality will likely change).

	require 'acts_as_amazon_product'

	class Book < ActiveRecord::Base
	  acts_as_amazon_product :asin => 'isbn', :name => 'title', 
				:access_key => '0123456', :associate_tag => 'assoc-20'
	end

You can now access the Amazon data in your views like so (see):

	@book = Book.new(:title => 'Getting Things Done')
	@book.amazon.isbn
	@book.amazon.title
	@book.amazon.author
	@book.amazon.small_image_url
	
	or
	@book.amazon.get('itemattributes/foobar')

== Unit tests

There are tests you can run in the [gem]/test directory.  Just create a 
test/config.yml from the example and run "Rake test" from the [gem] directory.

= Credits
acts_as_amazon_product was created by Scott Nedderman and Chris Beck from netphase.com

We'd love to here how you like it.  Also, if you'd like us to help out with your next 
project, let us know. 

http://netphase.com