=== WordPress-Amazon-Associate === Contributors: mdbitz Donate Link: http://labs.mdbitz.com/donate/ Tags: amazon, associate, affiliate, carousel, widget, filter, search, short code, ip2nation, localization, omakase, my favorites, mp3 clips, multi-user, multi-author, product cloud Requires at least: 3.0.0 Tested up to: 3.1.2 Stable tag: trunk Quickly and easily monetize your webiste through the integration of Amazon products and widgets tagged with your and/or authors' associate ids. == Description == Easily and quickly integrate Amazon Products and Widgets into your website. This plugin enables you to monetize your website through the use of Amazon's Affiliate Program. By entering your amazon associate id for Amazon's supported locales you will earn referral fees for all products users purchase through your website. The Plugin features tinyMCE editor support for searching and inserting of amazon products and images into your content, content replacement of static links with your associate tag, and support for inserting Amazon Widgets through WordPress ShortCode, tinyMCE,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 unique 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 in addition to the Omakase and Product Cloud Widgets.
All widgets can be inserted into your website in any of 4 methods:
*Short Code* `[amazon_carousel]`
*tinyMCE Editor Button*
*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. **Multi-Author Support**
If your website has multiple authors contributing content, then you have the option of having content they write tagged with their associate id. If enabled users will have the ability to insert their associate tags on their profile page in the admin and any pages/posts they write will have the links/widgets in the content area set to their associate id. And links or widgets in the non-content (header/footer/sidebar/etc) will still be tagged with the associate ids configured in the settings page. 1. **Complete Administrative control**
We want this plugin to be as unobtrusive as possible and for that goal we give you full control over what features you want to use on your website. Including enabling/disabling of the Amazon Widgets and Associate Tag Filter if they are unused by your website freeing up valuable screen space and processing time. == 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. Access the Plugin settings by clicking the *WP - Amazon* menu option 1. Enter your Amazon Associate Id 1. Enter your Amazon Web Services Keys 1. Install the ip2nation database if you wish to support Geo Localization, by selecting the *WP - Amazon* > *ip2nation* menu option 1. Configure the Plugin Cache by visiting the *WP - Amazon* > *Cache* menu option 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 utilizes 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. = Does this plugin support Multi-Author websites? = Yes! As of version 1.4 of the plugin we have included a Multi-User module that if enabled allows authors to set their Amazon Associate Ids on the users profile page. Product links in page/post content will then be tagged with the author's associate ids, and if not set will default to the ids configured on the *WP - Amazon * > *Settings* page. = 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. If product previre still does not function for your website review your page source to see if additional jQuery versions are loaded, if so they need to be set to noConflict.
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 rewriting my existing 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. From this page you can also import your Amazon Associate Tags/Ids from the Amazon Link and Amazon Link Localizer plugins. = 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/WordPressAmazonAssociate/) 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 selecting to use our associate tag for X% of links. == Screenshots == 1. Amazon Carousel Widget 2. Amazon MP3 Clips Widget 3. Amazon My Favorites Widget 4. Amazon Search Widget 5. Amazon Omakase Widget 8. Amazon Product Preview example 6. WordPress Amazon Widget Panel Control 13. Page/Post Quick Links Component 9. Page/Post editor TinyMCE plugin to insert amazon product links/widgets 7. WordPress Amazon Associate Settings Panel 10. WordPress Amazon Associate - Compliance Panel 11. WordPress Amazon Associate - ip2nation Panel 12. WordPress Amazon Associate - Cache 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.5.2 - 05/09/2011 = * Fixed author associate id usage on Amazon Products/Enhanced Ads * Added alt & title support to Amazon Product Image Shortcodes * Added title support to Amazon Product Link Shortcodes * Refactored ShortCodeHandler to reuse AmazonProduct functions = 1.5.1 - 04/28/2011 = * Author level users now have access to the TinyMCE interface to create widgets/links * Fixed Associate Filter logic so that multiple links in page to same url would not be double tagged. = 1.5.0 - 03/01/2011 = * Support for Amazon Product Cloud Widget * Support for Amazon Enhanced Display Ads * Amazon Product Links support for rel attribute (defaults to nofollow) * Bug with Quick Links unable to insert images corrected * Amazon Product Links and Images updated with container and container_class attributes for additioanl flexibility in styling links * Cache logic updated to check for changes in associate id and updating if needed * TinyMCE editor updated with display of price and links to Amazon, thanks Sean Malone for sharing your changes to the plugin = 1.4.1 - 12/28/2010 = * Quick Links update - included logic for inserting links when in HTML editor using send_to_editor * Added class optional attribute to Product Images ShortCode to allow for alignment = 1.4.0 - 12/11/2010 = * Product Caching - introduced new Cache module to store product information in local db to minimize calls to Amazon Product API. * Multi-User Support - enabled ability to have user specific associate tags so that authors get credit for links in their content. * 2 Step Quick Links - new post/page sidebar component that enables users to search and insert links/images in 2 steps. * Associate Tag imports - ability to import associate tag settings from Amazon Link and Amazon Affiliate Link Localizer plugins. * Code cleanup - removal of PHP Notices caused by the plugin. = 1.3.1 - 12/03/2010 = * Bug Fix to MP3Clips widget's shortcode options = 1.3.0 - 12/03/2010 = * Support for Amazon Omakase (Leave it to us) Widget * tinyMCE support for inserting Widget ShortCode * filter removal of 'shortcode_unautop' to correct empty content bug * Admin Panels updated with Social Network links * Widget Geo Localization support * Fixed label styling of Widget controls = 1.2.3 - 11/26/2010 = * Corrected default ShortCode Arguments for Amazon Widgets. Attributes were getting removed by the WordPress shortcode_atts method as they were not in the default array of attributes. Thanks to *Ty Lee* for identifying this bug. = 1.2.2 - 11/24/2010 = * 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 - 11/22/2010 = * Optimization to ip2nation check - only queries ip2nation for latest version when a user is on the WP-Amazon > ip2nation admin screen = 1.2.0 - 11/20/2010 = * 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 - 11/14/2010 = * 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 - 11/10/2010 = * Optional jQuery noConflict wrapper for Amazon Product Preview to fix Amazon script conflicts in some theme/plugin combinations. = 1.0.1 - 11/09/2010 = * Updated default settings to comply with WordPress guidelines = 1.0 - 11/07/2010 = * 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]` = Omakase (Leave it to Us) = * `` * `[amazon_omakase]` = Product Cloud = * `` * `[amazon_product_cloud]` = 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]` = Enhanced Product Ad = * `` * `[amazon_enhanced asin="0345518705" ]`