Extension:Amazon-Linker

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
Amazon-Linker

Release status: beta

Description Easily create Amazon.com product links by just entering their ASIN or ISBN
Author(s) Kolomona Myer (Hapatalk)
Latest version 0.6.1 beta (March 2009; 5 years ago (2009-03))
MediaWiki 1.9.3, 1.10.0, and 1.13.3
License GPLv3 and CC-BY-SA
Download Project page
Subversion [Help]

Browse source code
View code changes
Note: no localisation updates provided by translatewiki.net.
Readme

Example {{#ASIN:B001EUBSL0}} Produces:

[1] Adobe Photoshop CS4

Parameters

$wgalAWSAccessKey
$wgalAssociatesTag
$wgalFullTextLink
$wgalUseProductPreview
$wgalSharePercent

Translate the Amazon-Linker extension if possible

Check usage and version matrix; code metrics

Notice[edit | edit source]

This extension currently doesn't work due to Amazon's Product Advertising API Authentication policy change. Product Advertising API

I am current rewriting this extension and I should have a working version in a week or so. The good news is that I the new version I'm working on will be much easier to use. (hopefully) --Hapa 05:34, 25 August 2009 (UTC)

Inspiration[edit | edit source]

Inspiration for this extension was the ISBN feature that MediaWiki has. I wanted to use it to monetize my Wiki so I made a hack to the parser.php

While this worked it became a pain to maintain as I had to rehack the parser.php file every time I upgraded my wiki.

So I made this extension.

Please leave me feedback on my talk page User_talk:Hapa

Enjoy.


What can this extension do?[edit | edit source]

This extension provides an easy way to insert Amazon.com product links into your wiki pages making it simple to monetize your wikis

Notes on Current Design - Circa March 2011[edit | edit source]

The BookSources page on a standard MediaWiki v1.16.2 displays Amazon Books correctly only if the ISBN-10 (1847198201) number is given and is expected to go for example to:

http://www.amazon.com/CMS-Made-Simple-1-6-Beginners/dp/1847198201

The same book's ISBN-13 (978-1847198204) number errors out but should actually go to:

http://www.amazon.com/gp/search/?search-alias=stripbooks&field-isbn=9781847198204

This is only a search page that displays the book in summary form unlike the latter which displays it in detail form.

See It In Action[edit | edit source]

You can see this in action on my wiki http://www.opentutorial.com/Make_fire_text_using_photoshop#Amazon.27s_Related_Products


Usage[edit | edit source]

{{#ASIN:B001EUBSL0}}

Where "B001EUBSL0" can be any Amazon.com product number

This will automatically lookup the ASIN using Amazon Web Services (AWS) and return the following to your wiki page:

ASIN B001EUBSL0 Adobe Photoshop CS4

The link generated will include your own Amazon.com Associates ID number allowing you to get credit if a user purchases the product, or any other product on Amazon.com

Customizable Templates[edit | edit source]

The extension also provides for customizable output via a rudimentary templating system. Allowing for greater flexibility.

The templates can pull the following variables from Amazon.

  • %alink%
    • This is the link to the product which includes your associates tag.
  • %ASIN%
    • This is Amazon.com's unique product number for the item.
  • %name%
    • The name of the product.
  • %Manufacturer%
    • The manufacturer of the product
  • %Price%
    • Amazon's current price for the item.


Download instructions[edit | edit source]

Get the code from Google Code Here


Installation[edit | edit source]

Unzip the contents of the zip file to a directory titled "Amazon-Linker" in your extenstions directory

Read the readme.txt file contained in the zip file for instructions on how to install this extension


Configuration parameters[edit | edit source]

Read the readme.txt file


Amazon.com Infoboxes[edit | edit source]

If you would like to have the Amazon.com infoboxes like the ones seen on http://www.opentutorial.com/Make_fire_text_using_photoshop#Amazon.27s_Related_Products

Place the following code at the end of your skin php file just before the </body> tag:

<!-- *************************  BEGIN AMAZON ENHANCED LINK SCRIPT ****************** -->

<script type="text/javascript" src="http://www.assoc-amazon.com/s/link-enhancer?tag=tsickist-20&o=1">
</script>
<noscript>
    <img src="http://www.assoc-amazon.com/s/noscript?tag=tsickist-20" alt="" />
<!-- *************************  END AMAZON ENHANCED LINK SCRIPT ****************** -->