=== AmazonSimpleAdmin ===
Tags: amazon, admin, bbcode, collections, simple, product, preview, sidebar
Contributors: worschtebrot
Requires at least: 2.0
Tested up to: 4.3
Stable tag: 0.9.17

Lets you easily embed Amazon products into your WordPress posts by use of [asa]ASIN[/asa] shortcodes. Supports the use of templates. You can choose from various presentation styles and of course create your own template in a few seconds.

== Description ==

AmazonSimpleAdmin lets you easily integrate Amazon products into your WordPress pages.
By using the template feature, you can present the products in different styles on different pages. All by typing simple BBCode tags.

For the latest information visit the plugin homepage:

http://www.wp-amazon-plugin.com/

Here you can find a detailed documentation:

http://www.wp-amazon-plugin.com/guide/

Features:

* Ease of use with asa-**Shortcode** tags
* Lets you design your own product **templates**
* Supports all Amazon webservice **country codes**: CA, CN, DE, ES, FR, IN, IT, JP, UK, US
* Use your Amazon **tracking ID** for making money
* Features **collections**. You can define and mangage sets of products as a collection an show them on a page with only one BBCode tag or just the latest added product in your sidebar
* Backend translation: supported so far are English, German, Spanish and Serbian. Contact me to help translate.
* Supports product **preview layers** (for US, UK and DE so far)
* New with version 0.9.5: **Caching** Speeds up your blog when adding many products to your posts!
* New with version 0.9.6: Parsing [asa] tags in user comments 
* Since version 0.9.6 compatible with Amazons Product Advertising API changes by August 15, 2009 which require all requests to be authenticated using request signatures
* Version 0.9.7 supports customer reviews again!
* Version 0.9.11 brings AJAX mode (optional) for faster page load
* Error handling options
* Test section

Credits:

Thanks for translations

Serbian: Ogi Djuraskovic (http://firstsiteguide.com/)
Spanish: Andrew Kurtis (http://www.webhostinghub.com/)
Russian: Ivanka from Coupofy (http://www.coupofy.com/)
French: Marie-Aude (http://www.lumieredelune.com/)

Help me translate ASA in your language: http://www.wp-amazon-plugin.com/contact/

== Installation ==

Just unpack the `amazonsimpleadmin` folder into your plugins directory and activate it on your wordpress plugins page.
Then you will have the option `AmazonSimpleAdmin` on your wordpress options page.

== Configuration ==

Go to the new option page `AmazonSimpleAdmin`. On the `Setup` panel you can set your Amazon Access Key ID and Secret Access Key.

Here you can find a detailed documentation:

http://www.wp-amazon-plugin.com/guide/

== Change Log ==

= 0.9.17 =
* Tweak: Main price handling improved
* Improvement: Security updates
* Improvement: Prepared for WP 4.3

= 0.9.16 =
* Bugfix: Due to changes in the structure of the API's XML result, the second product image was used.
* Added: French translation

= 0.9.15 =
* New feature: Export / import collections
* Added language file: Serbian. Thanks to Ogi Djuraskovic (http://firstsiteguide.com/)
* Added update notice for template backup (Please also read: http://www.wp-amazon-plugin.com/2015/13280/keeping-your-custom-templates-update-safe/)
* New placeholder: {$OffersMainPriceAmount} Always keeps the main Amazon price. You can set the text it should show if the price is empty.
* New placeholder: {$OffersMainPriceCurrencyCode} The main price currency code.
* New placeholder: {$OffersMainPriceFormattedPrice} Always keeps the main Amazon formatted price (with currency code). You can set the text it should show if the price is empty.

= 0.9.14 =
* New feature: Test section. Test a ASIN with your template or check if the ratings can be retrieved.
* Improved error handling options
* New placeholder: {$Class}. You can use it like {$Comment} e.g. to put a custom CSS class in it. [asa demo, class="my_css_class"]B00AKHKTVI[/asa]
* Improvement: On some servers the rating images could not be loaded. This has been improved.

= 0.9.13 =
* New feature: Added support for indian country store. You can now advertise with Amazon India.
* New feature: ASA is ready for translation. It supports english and german so far.
* Layout adjustments for the new WordPress 3.8 backend.
* Minor bug fixes

= 0.9.12 =
* New feature: New cache option: Do not use cache when logged in as admin
* New feature: Now you can place your template files in your theme directory in a subdirectory called "wp-content/themes/[your-theme]/asa". Supported file extensions are ".htm" and ".html". This is optional, the subdirectory "tpl" of the plugin directory will work as usual.
* New placeholder: {$TrackingId}
* New placeholder: {$AmazonShopURL}
* New placeholder: {$ProductReviewsURL}
* Improvement: Added collection name filtering
* Improvement: Collections are tested successfully in WordPress Multisite environment
* Bugfix: asa / asa_collection shortcode regex fix
* Bugfix: Collection browse select will keep the selected item
* Fix: Removed PHP notices
* Fix: PHP Notice: has_cap was called with an argument that is deprecated since version 2.0! on menu creation

= 0.9.11.2 =
* Bugfix: Ajax mode did not work for not logged-in users
* Bugfix: Removed double usage of Amazon price formatting function
* Added: Placeholders {$Prime}, {$PrimePic}

= 0.9.11.1 =
* Bugfix: Functions asa_item und asa_get_item resulted in an error when used with custom templates (file_get_contents warning)
* Bugfix: Placeholder {$PercentageSaved} should show 0 if nothing is saved instead of it being blank
* Added: Custom CSS class for Ajax container called "asa_async_container_" + template name. So you can add a custom Ajax loading image per template.

= 0.9.11 =
* Added: AJAX mode for asynchronous loading to improve page load speed
* Added: HTML tag support for $Comment placeholder
* Added: Shortcode handler for better integration with other plugins / widgets
* Added: Options panel
* Added: FAQ panel
* Fixed: Behavious of {$AmazonPrice}
* Fixed: On adding items to collections, the collection name stays selected

= 0.9.10.2 =
* Added: Option for using shorter Amazon links (as they were in previous versions)
* Added: Debugging mode (you can activate it on the setup panel)
* Added: Better error handling/reporting on connection/setup errors
* Fix: Removing whitespace on updating Amazon credentials (trim)
* Fix: Minor bugfixes

= 0.9.10.1 =
* Fix: Fixed error: Class 'Asa' not found in .../AsaCore.php on line 384 

= 0.9.10 =
* Fix: Update to API version 2011-08-01. The associate tag is now mandatory!
* New: Support of Amazon Italy, Spain and China
* New: With this version comes a backup mechanism for your custom templates. Further updates should keep your custom files.
* Fix: Fixed a bug in rendering placeholder $AmountSaved->FormattedPrice

= 0.9.9.3 =
* hotfix: Solves a problem when accessing the Amazon customer rating page for parsing the results
          I will check this in detail and provide some more options on this in the admin panel later on

= 0.9.9.2 =
* Fixed: issue with currency and price not displaying properly
* Added: Widget for displaying collections in sidebar
* New placeholder: {$LowestNewOfferFormattedPrice}
* New placeholder: {$LowestUsedOfferFormattedPrice}
* New placeholder: {$AmazonPriceFormatted}
* New placeholder: {$ListPriceFormatted}
* Keeps user templates after update and does not overwrite custom templates. 
  The built-in templates are now place in directory "tpl/built-in". 
  Do not change these build-in template as I could change them for future updates.
  For your own template copy a build-in into the directory "tpl" and change it there.
  If templates with same names exist, always the one in "tpl" will be used.
* New feature: Personal comment [asa comment="Hello world"]ASIN[/asa] The comment can be displayed with placeholder {$Comment}
* Added: New build in template: mp3
* Improved default / built-in templates: default, book, dvd, mp3
* Added: When browsing a collection in the backend, the price of an item is listed
* New plugin homepage: http://www.wp-amazon-plugin.com/

= 0.9.9.1 =
* Added: Support for the excerpt
* Added: 2 new parameters for [asa_collection]: "items" and "type". 
         "items=2" for example lets you limit the collection items to be displayed.
         type supports "random", so "type=random" shows randomly selected collection items. 
         By default the latest added item will be displayed first.
         You may combine the two parameters, separated by comma: [asa_collection items=2, type=random]Products01[/asa_collection]
         If you want to use a template: [asa_collection book, items=2, type=random]Products01[/asa_collection]
* Added: Support for placeholders: Languages, Subtitles (for DVDs), Model, 
         ListPrice->FormattedPrice, ListPrice->CurrencyCode, AmountSaved->FormattedPrice, AmountSaved->CurrencyCode
         
= 0.9.8 =
* Bugfixes
          
= 0.9.7 =
* Fixed: Customer reviews. Due to amazon api changes in November 2010 the customer reviews did not work any more.
         The api now provides a url to an iframe where the reviews are generated for 24 hours. I implemented a way
         to grab the 5-stars image and the total reviews so the old placeholders are still supported. I hope this 
         way works. If you have any problems please let me know.
* Added: News placeholders: LowestOfferFormattedPrice, RatingStarsSrc (the url to the image file) 

= 0.9.6 =
* Added: Compatible with request authentification
* Added: Parsing [asa] tags in user comments (optional) (feature request from Sebastian, thanks)
* Bugfix: Browsing a collection list which contained an item without an image caused an error (bug report by Lingus, thanks)
* Bugfix: Product with multiple artists caused an error (bug report by Aaron, thanks)

= 0.9.5 =
* Added: Caching
* Added new placeholders: ProductDescription, AmazonDescription, Artist
* Bugfix: Template parsing bug fixed

= 0.9.4.1 = 
* Fixed: Installation of collections (form for installation was not displayed)
* Added function asa_item for use in PHP code everywhere eg sidebar: <?php asa_item('B000TKHBDK'); ?>
* (User request) Added placeholder "CustomRating" which can be used like this [asa custom_rating=3.5]0316015849[/asa] 

= 0.9.4 = 
* Adapated to wordpress version 2.5
* Added some new DVD related placehoders (Director, Actors, RunningTime, Format, Studio)
* Added an exemplary dvd template

= 0.9.3.1 = 
* Bugfix: Fixed error in deleting collection items

= 0.9.3 = 
* Bugfixes
* Added new placeholders: AverageRating, TotalReviews, RatingStars

= 0.9.2 = 
* Added new placeholders: ASIN, ISBN, EAN, NumberOfPages, ReleaseDate, Binding, Author, Creator, Edition
* Added template book.htm
* Fixed: Delete collection items with qutations in title

= 0.9.1 = 
* Added a PHP Version checker. If plugin gets activated under PHP 4 it will be reversed.

== Info ==

If you find any bugs please send me a mail (support@NOSPAM_wp-amazon-plugin.com, remove the NOSPAM_) or use the comments on the [plugin's homepage](http://www.wp-amazon-plugin.com/ ). Please also contact me for feature requests and ideas how to improve this plugin. Any other reactions are welcome too of course.

== Frequently Asked Questions ==

= For category music CDs what is the placeholders for artist? = 
{$Artist}

= Are there any special placeholders for MP3 downloads? = 
There is a special built-in template for mp3 files. Use [asa mp3]ASIN[/asa]

= The plugin does not show the price for Kindle ebooks correctly. = 
Unfortunately the Amazon webservice does not support Kindle prices at the moment. See https://forums.aws.amazon.com/thread.jspa?messageID=208072

= I get the PHP-Error: Warning: domdocument::domdocument() expects at least 1 parameter, 0 given in \wp-path\plugins\amazonsimpleadmin\lib\Zend\Service\Amazon.php on line 129 = 
There are two very similarly named PHP extensions, dom and dom_xml - the dom extension is built into php5 and loading the dom_xml extension (designed for php4) will override the default extension.
I suspect that loading php_domxml.dll (on Windows) in your php.ini is the cause of this problem. Try to disable it and see if that helps.


== Screenshots ==

1. Setup screen
2. Options panel
3. Collections manager panel
4. Collection rendered in post
5. Widget
6. Widget rendered on page
7. Integrated help
8. For more information visit http://www.wp-amazon-plugin.com/
9. Error log
10. Error reporting notification email