We'll create fresh WordPress site with Amazon Search installed. You have 20 minutes to test the plugin after that site we'll be deleted.
This plugin allows you to link directly to items in your
posts using a special tag of the form:
[amazon ASIN=0123456789]Fancy Title[/amazon]
The plugin lets you set associate IDs for each international amazon server and set one server
as the default for your site.
It also includes an Amazon Search widget which will search any of the amazon servers
and produce search results with direct links to products.
It also provides an XSLT file for the amazon server to access, which processes it together with the XML results of
the search, and then returns HTML. This saves your server from having to process the XML itself.
It uses css to format the search widget and the search results. It will look in its css dir for theme-specific css files
too, so if you have one in there called your-theme-name.css, it will include it after default.css. This way you may
customize search results for a given theme by dropping in a new css file. So if you allow your users to switch themes, you can include
a css file for each one and the search will look correct when it is switched.
v1.2.0 [23 March 2009]
v1.1.3 [20 July 2008]
v1.1.2 [20 July 2008]
v1.1.1 [23 May 2008]
v1.1.0 [26 Apr 2008]
v1.0.2 [02 Apr 2008]
v1.0.1 [22 Mar 2008]
v1.0.0 [08 Jan 2008]
In the Admin section, under Settings -> Amazon Search you may configure the following:
In this section, fill in any associate IDs you have. You may also select one of the servers to be the
default for your users. If you live in France, you might choose the amazon.fr server, for example.
Any IDs left blank will be filled in with mine.
Ah, here’s the hook! I’ve set it up so that every ‘N’ searches [or page displays if you are using the text links],
the links which are produced use my
associate IDs. You can choose a value for ‘N’ here. No need to go hacking if you don’t want to support
development – just set it to 0 and it won’t ever substitute my associate IDs.
If Use Text Links is on, the plugin will process your posts looking for a special markup and convert them to links.
To add a text link to an Amazon product, simply use the following format:
[amazon ASIN=0743279794]Fancy Title[/amazon]
ISBN may be used in place of ASIN – they are effectively the same thing. It is a case-insensitive match, so ‘asin’ is the same as ‘ASIN’.
This tag will be converted to a link of the form:
<a href=”http://www.amazon.com/dp/0743279794/?tag=yourTag-20″>Fancy Title</a>
If you have Use ip2Nation checked and the ip2Nation database is installed, it may be used to locate the best Amazon site for the visitor. Any country not handled specially will
use your default Amazon server. If you have the Development Contribution set in your prefs, a page load will count as a ‘search’.
NOTE: The handling of which Amazon site is best per country is incomplete at best. I would appreciate any feedback or additions/corrections
to the list [which is found in the getAmazonServerFromIP() function in amz-search.php].
Add Editor Buttons allows you to turn off the additional buttons in the editors which provide a quick way to enter an amazon link.
Use Searching allows you to turn off the search capability completely in case you just want to use the text links.
Default Category is the one that will be used when the user searches from the widget. When they
get the results, they will be able to change the category on the search page.
Default Search Term is what is used if the user doesn’t enter a search term. Right now it defaults
to ‘WordPress’. You will probably want to change it to something appropriate to your site.
You may specify an XSLT file that will be sent to the amazon servers for processing. This file must be publicly
accessible because the amazon servers will be reading it to provide formatting.
If you don’t know what this means, you better leave it alone. The XSLT file may be edited if you want to
customise the results produced by the search. I am certainly not an XSLT expert, so if you have any suggestions,
please contact me.
You may also set the size of the images that are to be returned in the search or ‘None’ to turn them off.
Watch out if you set this to ‘Large’!