These macros recreate the amazon linking functionality from Chat11

For the Codegeist 2007 contest I wrote an Amazon Web Services Plugin.

First we'll show the simplest versions of the macros, later we'll show more advanced usage of the macro system to add more features. These macros are User Macros, and are available for system administrators to install in their wiki.

Documentation about macros:

• http://confluence.atlassian.com/display/DOC/User+Macros
• Wiki markup in macros: http://jira.atlassian.com/browse/CONF-3887
• Velocity macro documentation: http://confluence.atlassian.com/display/DOC/Velocity+Template+Overview

Basic Link To A Book On Amazon.com

This macro recreates the isbnlink functionality from Chat11

This macro makes a basic link to a book on Amazon.com

• Go to Administration > User Macros > Create User Macro
• Macro name: amazon
• Uncheck Macro has a body
• Output: Macro generates HTML markup
• Template:

  <a href="http://www.amazon.com/exec/obidos/ASIN/$param0/webmill0c32-20">$param1</a>
  

Usage: First parameter is the ISBN number, the second parameter is the book title.

{amazon:067232847X|Red Hat Fedora 5 Unleashed}

Which is rendered as: Red Hat Fedora 5 Unleashed

It's also possible to use named parameters.

<a href="http://www.amazon.com/exec/obidos/ASIN/$paramisbn/webmill0c32-20">$paramtitle</a>

can be used as

{amazon2:isbn=067232847X|title=Red Hat Fedora 5 Unleashed}

which renders as: Red Hat Fedora 5 Unleashed

Link Including The Book Cover

This html will render with a picture of the book cover. Macroname: amazonpic <table><tr><td> <a href="http://www.amazon.com/exec/obidos/ASIN/$paramisbn/webmill0c32-20" target="books"> <img src="http://images.amazon.com/images/P/$paramisbn.01.MZZZZZZZ.jpg" border="0" alt="Cover of ISBN $paramisbn"></a></td> <td width=120> <a href="http://www.amazon.com/exec/obidos/ASIN/$paramisbn/webmill0c32-20" target="books"> $paramtitle</a></td></tr></table> This wikitext: {amazonpic:isbn=067232847X|title=Red Hat Fedora 5 Unleashed}

Which is rendered as: Red Hat Fedora 5 Unleashed

Another Amazon Macro

There is also an Amazon plugin included with the Confluence download. This requires you to use a java compiler to compile the macro, then include it in the file system for Confluence. This is not too difficult.

The one that came with my version of Confluence (2.4.5), was broke, and I wrote an article about how to debug and fix it: Confluence Example Plugin - Amazon Web Services Plugin

My Amazon Macro

See Amazon Web Services Plugin.