Amazon plugin

Freshness Warning
This blog post is over 19 years old. It's possible that the information you read below isn't current and the links no longer work.

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, Youll 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...

This discussion has been closed.

Recently Written

The Trap of The Sales-Led Product (Dec 10)
It’s not a winning way to build a product company.
The Hidden Cost of Custom Customer Features (Dec 7)
One-off features will cost you more than you think and make your customers unhappy.
Domain expertise in Product Management (Nov 16)
When you're hiring software product managers, hire for product management skills. Looking for domain experts will reduce the pool of people you can hire and might just be worse for your product.
Strategy Means Saying No (Oct 27)
An oft-overlooked aspect of strategy is to define what you are not doing. There are lots of adjacent problems you can attack. Strategy means defining which ones you will ignore.
Understanding vision, strategy, and execution (Oct 24)
Vision is what you're trying to do. Strategy is broad strokes on how you'll get there. Execution is the tasks you complete to complete the strategy.
How to advance your Product Market Fit KPI (Oct 21)
Finding the gaps in your product that will unlock the next round of growth.
Developer Relations as Developer Success (Oct 19)
Outreach, marketing, and developer evangelism are a part of Developer Relations. But the companies that are most successful with developers spend most of their time on something else.
Developer Experience Principle 6: Easy to Maintain (Oct 17)
Keeping your product Easy to Maintain will improve the lives of your team and your customers. It will help keep your docs up to date. Your SDKs and APIs will be released in sync. Your tooling and overall experience will shine.

Older...

What I'm Reading

Contact

Adam Kalsey

+1 916 600 2497

Resume

Public Key

© 1999-2021 Adam Kalsey.