Amazon plugin

Freshness Warning
This article is over 16 years old. It's possible that the information you read below isn't current.

Note: MTAmazon 2.0 has been released. It allows more flexible product display, better performance, and searching for products related to your blog entries. The documentation for the original version of MTAmazon is provided here primarily for reference. It is recommended that you go to the MTAmazon 2.0 page instead.

MTAmazon is a Movable Type plugin that uses your Amazon Associate membership to retreive products from Amazon. It allows flexible searching and display of products from any of Amazon’s product categories.

Download. You can get MTAmazon by downloading MTAmazon.zip.

Requirements. In order to use MTAmazon, you’ll need to be running Movable Type 2.21 or later and have three Perl modules installed: XML::Simple, LWP::UserAgent, and HTTP::Request. All three are common modules, so there’s a good chance your server has them installed. If they aren’t already on your server, you can download and install them by copying them to Movable Type’s extlib directory.

Installation. Once you’ve downloaded and unzipped MTAmazon.zip, connect to your FTP server and open the directory where you have Movable Type installed.

Create a directory there called plugins if there isn’t one already and copy amazon.pl to the plugins directory.

Using MTAmazon. Once you’ve installed MTAmazon, You’ll have a set of new Movable Type tags.

<MTAmazon></MTAmazon> is a pair of tags that connect to Amazon, runs your search, and builds a list of products. All of the other MTAmazon plugin tags will go inside this pair of tags.

To build your search, you’ll need an Amazon associate ID. You’ll also need to choose whether you want MTAmazon to search for products or display all of the products from an Amazon product category. Lastly, you’ll need to choose which of Amazon’s product lines you want the products to come from.

Searching. If you want to search for products, all you need to do is create a list of search keywords. You can use multiple keywords separated with spaces.

Using Product Categories. To use product categories, you’ll need Amazon’s Browse ID for the category you wich to display. To get the Browse ID, start browsing for products on Amazon. Once you’ve gotten to the category you want to display, look in the address bar of your browser. You’ll see something like http://www.amazon.com/exec/obidos/tg/browse/-/408126/ref=br_dh_1_dah/002-8226029-7182418. The browse ID for this category (DVD Awards) is highlighted in bold. The portion you’ll need is the number after browse/-/.

Product Line. The product line is the section of the store that you want to retreive products from, like books or software. Amazon has a list of valid product lines listed on their Associates site. Their list shows the line as "mode=books," but all you need is the "books" portion.

Once you have all your information, you are ready to build your product links using the following attributes to <MTAmazon>:

  • associateid
    Your Amazon Associate id

  • method (required)
    How do you want to retreive products? You can use either "search" or "browse."

  • search (required)
    The search terms or browse id you would like to use. Multiple search terms can be separated with spaces.

  • line (required)
    The product line that you are searching or browsing. Valid lines can be found on Amazon’s site.

  • lastn
    The number of products you wish to display. Amazon allows a maximum of 15 products, so setting this number to 1 or above will have no effect. If you don’t include the lastn attribute, 15 products will be returned.

Available tags. Inside the <MTAmazon></MTAmazon> container any of the following tags can be used:

<MTAmazonTitle>
The product’s name or title.

<MTAmazonASIN>
The Amazon product ID.

<MTAmazonAuthor>
For books, the author; for movies, the lead actor; for msuic, the artist; for mos everything else, the manufacturer.

<MTAmazonImage>
The URL for the full-size product image.

<MTAmazonSmallImage>
The URL for the thumbnail product image.

<MTAmazonSalePrice>
Amazon’s price. If this is blank, it means that Amazon’s price is so low that it can’t be advertised. A shopper must actually add the product to their Amazon.com shopping cart before seeing it’s price.

<MTAmazonListPrice>
The manufacturer’s suggested, or list, price.

<MTAmazonReleaseDate>
The date that the item was released. You can use MT’s date tag formatting to format this the way you would like. None of the dates include times, so if you use any time values in your formatting, the time is treated as 12:00 am. Some Amazon products do not have a day of the month included with the release date, so even if your date format specifies a day, it won’t be shown for those products.

<MTAmazonAvailability>
The product availabilty.

<MTAmazonLink>
The link to the product. This includes your Associate id, so if someone purchases you’ll get credit for the sale.

Example.

<MTAmazon associateid="kalsey-20" method="search" search="dogs" line="books" lastn="10">
<p><a href="<MTAmazonLink>">
<img src="<MTAmazonSmallImage>" align="left" border="0"><MTAmazonTitle>
</a><br>
<MTAmazonReleaseDate format="%B %e, %Y"><br>
<MTAmazonAuthor><br>
Price: <MTAmazonSalePrice></p><br clear=all>
</MTAmazon>

See it. Visit these sites to see MTAmazon in action:

License. Like our other freeware, this plugin is released under the open-source MIT License. In plain English, that means you can do whatever you want with the software, including modifying it, selling it, or eating it, but we’re not responsible for anything that goes wrong.

Revision History
1.0 - July 14, 2002
Initial public release

Torgny Bjers
July 25, 2002 5:38 AM

I just tried out the plugin, and I cannot get it to work. It doesn't even return errors when I omit the required fields in the MTAmazon tag. What can I do to test if it actually loads the plugin?

Torgny Bjers
July 25, 2002 10:13 AM

Oooh! I actually made it work by recoding the entire plugin with some help from your code and the Amazon XML SDK. I will post this code somewhere so that those that cannot use XML::Simple (like me), can use it...

Torgny Bjers
July 25, 2002 10:31 AM

Adam Kalsey
July 25, 2002 11:54 AM

You can install XML::Simple into your extlib directory just like you can with other MT required modules. The next version of the plugin is coming very soon and will provide more help in checking for and installing the required modules.

Andrew
October 14, 2002 9:48 AM

Hi, Excellent module. Once I copied Simple.pm into the XML folder, it worked fine. I love this stuff!! Many thanks, Andy

Peter
October 25, 2002 8:28 AM

Great module, easy to use but the setup can be a little confusing. I got the search working great but I can't get the browse to return any results. Any hints? Thanks for making this software freely available.

Adam Kalsey
October 25, 2002 9:29 AM

First of all, make sure you are using the latest version of the plugin. The most current version is at http://mtamazon.sf.net/ There's also an email list there where you can post questions about the plugin.

Damian
October 31, 2003 6:46 AM

Hello - The Plug In sometimes works but sometimes I get this error message and have to remove the Amazon Tags from the Individual Entry Template to get the site to rebuild. Any ideas? I am using the Entry Title tag to set the browse if that helps. Damian An error occurred: Building entry 'Nu Jazz Days Festival, Bratislava' failed: Build error in template 'Individual Entry Archive': Error in tag: Error reading XML content: syntax error at line 1, column 49, byte 49 at /usr/lib/perl5/site_perl/5.005/i386-linux/XML/Parser.pm line 185 .

Trackback from Music and Madness
December 5, 2003 11:25 AM

mt amazon it is!

Excerpt: Amazon plugin :: Kalsey Consulting Group amazon plugin homepage, templates and other cool stuff...

Trackback from Mehh? Mehh!
August 2, 2005 1:16 PM

Useful site for MT users

Excerpt: An extremely useful site I came across while installing pluggins for movable type is Adam Kelseys blog which contains such beauties as the related entries plugin which I'm attempting to implement right now (had it working am just trying to...


Your comments:

Text only, no HTML. URLs will automatically be converted to links. Your email address is required, but it will not be displayed on the site.

Name:

Not your company or your SEO link. Comments without a real name will be deleted as spam.

Email: (not displayed)

If you don't feel comfortable giving me your real email address, don't expect me to feel comfortable publishing your comment.

Website (optional):

Follow me on Twitter

Best Of

  • The mouse and me Not only is the mouse very destructive, but it's evaded all attempts to capture or kill it so far.
  • Lock-in is bad T-Mobile thinks they'll get new Hotspot customers with exclusive content and locked-in devices.
  • Newly Digital Newly Digital is an experimental writing project. I've asked 11 people to write about their early experiences with computing technology and post their essays on their weblogs. So go read, enjoy, and then contribute. This collection is open to you. Write up your own story, and then let the world know about it.
  • Pitching Bloggers Forget what you learned in your PR classes. Start acting like a human instead of a marketer, and the humans behind the blogs will respond.
  • California State Fair The California State Fair lets you buy tickets in advance from their Web site. That's good. But the site is a horror house of usability problems.
  • More of the best »

Recently Read

Get More

Subscribe | Archives

16

Recently

Stretching your team (Jun 11)
Stretching your team is one of the best ways to improve your output, your team's happiness, and your velocity. But they'll need coaching.
Physical camera shutter for Cisco Spark Board (Jul 6)
A 3d printable design for a camera shutter for a Cisco Spark Board
My Travel Coffee Setup (Jan 20)
What my travel coffee brewing setup looks like, and how you can build your own for under $100.
Turkey Legs (May 30)
Product naming gone awry.
Speaking for Geeks: Your Slides (Dec 17)
Tips and tricks for creating great slides.
Speaking for Geeks: Writing Your Talk (Dec 14)
Don’t wait until the night before the talk to write it. Crazy, I know.
Speaking for Geeks: Tell a Story (Dec 13)
Telling a story keeps your presentation focused, keeps your audience interested, and makes it easier for you to remember your talk.
Speaking for Geeks: Where to speak (Dec 11)
You've got a great idea for a talk. How do you find conferences to submit it to?

Subscribe to this site's feed.

Elsewhere

Tropo
Voice and communications platforms, including Tropo and Phono. Work.
SacStarts
The Sacramento technology startup community.
Pinewood Freak
Pinewood Derby tips and tricks

Contact

Adam Kalsey

Mobile: 916.600.2497

Email: adam AT kalsey.com

AIM or Skype: akalsey

Resume

PGP Key

©1999-2018 Adam Kalsey.
Content management by Movable Type.