=== WordPress-Amazon-Associate === Contributors: mdbitz Tags: amazon, associate, affiliate, carousel, widget, filter, search, short code, ip2nation Requires at least: 3.0.0 Tested up to: 3.0.1 Stable tag: trunk Quickly and eaily monetize your webiste through the integration of Amazon products and widgets tagged with your associate id. == Description == Easily and quickly integrate Amazon Products and Widgets into your website. This plugin enables you to easily monetize your website with your amazon associate id with editor support for searching and inserting amazon products and images, content replacement of static links with your associate tag, and support for inserting Amazon Widgets through WordPress ShortCode, Widget Admin, or PHP code. This plugin fully supports amazon localization to supported markets: Canada (CA), Germany (DE), France (FR), Japan (JP), United Kingdom (GB), and the Unites States (US).
In addition the plugin contains basic support for link filtering of Amazon's Italy (IT) and China (CN) markets. The [WordPress Amazon Associate](http://labs.mdbitz.com/wordpress/wordpress-amazon-associate-plugin/?utm_source=wordpress&utm_medium=plugin-readme&utm_campaign=plugin) plugin is designed to be your all inclusive source for enriching you website with Amazon Products and Widgets embedded with your own Amazon Associate Tag. Below is a brief overview of the supported features: 1. **Amazon Widget Support**
To date the plug-in supports all Amazon Widgets that can be created using Amazon's [Widget Source](https://widgets.amazon.com/Widget-Source/) including the Carousel Widget, MP3 Clips Widget, My Favorites Widget and Search Widget
All widgets can be inserted into your website in any of 3 methods:
*Short Code*
`[amazon-carousel]`
*WordPress Widget Admin*
*PHP code*
Inserting widgets in templates is done through the usage of the AmazonWidget class that provides static methods for rendering the different widgets. `` 1. **Amazon Associate Tag Filtering**
To make management of your site easier we have included an optional filter that when enabled will modify static amazon product links to include your specified associate tag. This feature checks the locale of the amazon link and uses the correct localized associate tag so that you maximize your returns. 1. **Amazon Product Linking**
When writing content for your website you may find the need to include product links and images. The WordPress Amazon Associate plugin makes this task easier by including an amazon associate tinyMCE control that lets you quickly search for a product and insert either an image or link to the desired product that is automatically tagged with your associate id. In addition ShortCode and PHP code handles are provided to provide complete support. `` `[amazon_link id="0756406412" ]Shadowrise[/amazon_link]` 1. **Amazon Product Preview**
If your website contains product links Amazon's 'Product Preview' enhances your links by providing overlay products when a visitor rolls over the links. This plugin allows you to easily enable/disable this feature through it's admin panel. 1. **Link Localization**
For websites that want to provide the most relevant product links to their visitors they can enable links to be localized to the visitors Amazon. This means that visitors from France will be directed to amazon.fr and etc. If you have visitors from multiple countries this feature is for you. 1. **Complete Administrative control**
We want this plugin to be as unobtrusive as possible for that goal we give you full control over what features you want to use. Including enabling/disabling the Amazon Widgets and Associate Tag Filter if they are unused by your website freeing up valuable screen space and processing. == Installation == 1. Upload the `wordpress-amazon-associate` folder and all it's contents to the `/wp-content/plugins/` directory 1. Activate the plugin through the *Plugins* menu in WordPress 1. Modify Plugin settings through the *WP - Amazon* menu in WordPress 1. Insert Products and Widgets into your website through your template, page/post content or the *Widget* admin screen in WordPress == Frequently Asked Questions == = Do I need to configure the Amazon Web Service Keys = No, however by not inputting a valid Amazon Web Service you will not be able to insert amazon product links and images through ShortCode or the content editor's tinyMCE control. = Why can't I set Italy or China as my Primary Locale? = The WordPress Amazon Associate plugin utilized the Amazon Product API to lookup product urls and details from Amazon. At this time both Italy and China locales are not supported by the API. Once Amazon updates the API to support these locales you will be able to select these as your primary location. Until then, only the Link Filter functions for these locales. = What is Link Localization? = Link Localization is the generation of a product link that is localized to the users version of Amazon. To give a quick example if you have your default locale set to United States and a visitor of your website is from France then they would be presented with a link to the amazon.fr website instead of amazon.com. This is an optional feature that makes use of the free [ip2nation](http://ip2nation.com) database. To make things as easy as possible the WPAA plugin includes the ability to detect if you have ip2nation installed and if not install it for you. = Can I choose which locales to support? = Yes, not everyone will want to support link localization for all of Amazon's Locales. This is why we have built in the ability to disable locales you don't want to support. If a visitor from a disabled locale visits your website they will be presented with a product link localized to your default locale. = Why is Product Preview not working for my website? = At this time there is a confirmed bug with the Amazon Product Preview code that in some wordpress themes the previews do not occour. This error is due to the Amazon script including it's own version of jQuery into the page causing a conflict. To resolve the issue an optional jQuery.noConflict call to remap jQuery is included if selected by the user on the admin screen.
Also at this time product preview is only supported for 1 locale at a time. We are in the process of reviewing the code to see if this can be overwritten to allow for product previews of all locales instead. = My website currently uses other plugins for displaying Amazon Widgets, How can I switch to your plugin without rewritting my content? = In version 1.1 we introduced a new compliance module to the plugin. This enables you to make WPAA compliant with the ShortCode used in various other WordPress plugins for rendering Amazon Widgets. For the full list of compliant plugins visit WP - Amazon > Compliance in your WordPress Admin pages. = Does Wordpress Amazon Associate support I18n localization? = Yes, we have built the plugin to support localization, and have provided a wpaa.pot file in the languages folder of the plugin. If you have a translation for the plugin please send the po/mo files to [matt@mdbitz.com](mailto:matt@mdbitz.com) and I can incorporate it into the project for other users. = How can I report a bug? request help? request a feature? = If you find a bug in the WordPress Amazon Associate plugin then please let me know by emailing it to [matt@mdbitz.com](mailto:matt@mdbitz.com). You can also report it through my [trac project](http://trac.mdbitz.com/WordPresssAmazonAssociate/) using the login credential of "user" with password "guest". Another way you can reach me is through my [website](http://labs.mdbitz.com/wordpress/wordpress-amazon-associate-plugin/?utm_source=wordpress&utm_medium=plugin-readme&utm_campaign=plugin) = I notice that the associate tag for some links do not have my id, is this a bug? = No, this is not a bug. We have built into the plugin the ability to support the developers by having x% of links tagged with our associate id. By default this is set to 0% but can be turned on if desired by the user by visiting the `WP - Amazon` menu in your WordPress admin and select 0 in the Support Us options. == Screenshots == 1. Amazon Carousel Widget 2. Amazon MP3 Clips Widget 3. Amazon My Favorites Widget 4. Amazon Search Widget 5. WordPress Amazon Widget Panel Control 6. WordPress Amazon Associate Configurations Panel 7. Amazon Product Preview example 8. Page/Post editor TinyMCE plugin to insert amazon product 9. WordPress Amazon Associate - Compliance Panel == Changelog == The full project changelogs can be found at [http://labs.mdbitz.com/wordpress/wordpress-amazon-associate-plugin/changelog](http://labs.mdbitz.com/wordpress/wordpress-amazon-associate-plugin/changelog/?utm_source=wordpress&utm_medium=plugin-readme&utm_campaign=plugin) = 1.2.2 = * Admin Support for Italy and China Associate Tags * Inline links to the amazon associate website for all locales * Static Link Filtering support for China and Italy Locales = 1.2.1 = * Optimization to ip2nation check - only queries ip2nation for latest version when a user is on the WP-Amazon > ip2nation admin screen = 1.2.0 = * Support for Associate Tags for all Amazon Locales * Link localization support through utilizing ip2nation database * ip2nation support module to install/update ip2nation database * enhanced filter logic to replace static links with localized associate tags * Bug Fix for obtaining product links in Japan Locale = 1.1.0 = * Ability to preview Widgets within the Appearance > Widget page * I18n Language localization support * Enhanced Access Key Validation * Plugin Compliance support - enable compatability with ShortCode from other Amazon Widget plugins * Bug Fixes to My Favorites and Search plugins = 1.0.2 = * Optional jQuery noConflict wrapper for Amazon Product Preview to fix Amazon script conflicts in some theme/plugin combinations. = 1.0.1 = * Updated default settings to comply with WordPress guidelines = 1.0 = * Support for Amazon Widgets * Support for Associate Tag Filter * Support for Amazon Product Preview * Support for Amazon Product Links and Images == Supported Amazon Widgets/Links == = Carousel = * `` * `[amazon_carousel]` = MP3 Clips = * `` * `[amazon_mp3_clips]` = My Favorites = * `` * `[amazon_my_favorites]` = Search = * `` * `[amazon_search]` = Product Link = * `` * `[amazon_link id="0345518705"]link text[/amazon_link]` = Product Image = * `` * `[amazon_image id="0345518705" link="true"]alt text[/amazon_image]`