{"id":2258,"date":"2007-11-27T11:31:26","date_gmt":"2007-11-27T11:31:26","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/amazon-machine-tags\/"},"modified":"2010-01-28T10:24:14","modified_gmt":"2010-01-28T10:24:14","slug":"amazon-machine-tags","status":"publish","type":"plugin","link":"https:\/\/lmo.wordpress.org\/plugins\/amazon-machine-tags\/","author":283207,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"3.0.2","stable_tag":"3.0.2","tested":"2.9.2","requires":"2.3","requires_php":"","requires_plugins":"","header_name":"Amazon Machine Tags","header_author":"Martin Kliehm","header_description":"","assets_banners_color":"","last_updated":"2010-01-28 10:24:14","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.amazon.de\/gp\/registry\/wishlist\/18XSF4H22J4L8\/","header_plugin_uri":"http:\/\/learningtheworld.eu\/2009\/amazon-authorization\/","header_author_uri":"http:\/\/learningtheworld.eu\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":16751,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.1.0","1.1.1","1.1.2","1.1.3","2.0","3.0","3.0.1","3.0.2"],"block_files":[],"assets_screenshots":{"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":"1539080","resolution":"2","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1539080","resolution":"1","location":"plugin"}},"screenshots":{"1":"Admin interface","2":"The plugin in a sidebar"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[209,1556,86,166,6895],"plugin_category":[43,48,57],"plugin_contributors":[88535],"plugin_business_model":[],"class_list":["post-2258","plugin","type-plugin","status-publish","hentry","plugin_tags-amazon","plugin_tags-api","plugin_tags-post","plugin_tags-posts","plugin_tags-web-services","plugin_category-customization","plugin_category-language-tools","plugin_category-taxonomy","plugin_contributors-kliehm","plugin_committers-kliehm"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/amazon-machine-tags.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/amazon-machine-tags\/trunk\/screenshot-1.png?rev=1539080","caption":"Admin interface"},{"src":"https:\/\/ps.w.org\/amazon-machine-tags\/trunk\/screenshot-2.jpg?rev=1539080","caption":"The plugin in a sidebar"}],"raw_content":"\n

Simple inclusion of Amazon items through machine tags.<\/p>\n\n

    \n
  1. Identifies any tag in the machine or triple tag<\/a> form book:isbn=1234567890<\/code> or amazon:asin=1234567890<\/code>. Works with native tags from WordPress 2.3 and later, Bunny\u2019s Technorati Tags, and Jerome\u2019s Keywords.<\/li>\n
  2. Gets the item information and a thumbnail image from the Amazon Web Services API<\/strong>.<\/li>\n
  3. Displays the item(s) in the sidebar or in a blog article with a link to the visitor\u2019s best match (if the ip2country<\/a> plugin is installed) or a default Amazon shop of your choice.<\/li>\n
  4. If you are an Amazon Associate for that locale, your Associate ID is included automatically.<\/li>\n<\/ol>\n\n

    You can edit the server-side, semantic and valid XHTML output via XSLT, change the CSS, or translate the admin interface through PO-files.<\/p>\n\n\n

      \n
    1. Upload the whole amazon-machine-tags<\/code> folder into the wp-content\/plugins\/<\/code> directory.<\/li>\n
    2. Activate the plugin through the 'Plugins' menu in WordPress. Make sure that you don\u2019t run it on localhost<\/code> as XML files on the server need to be reached from the outside.<\/li>\n
    3. Get your own Amazon Web Services Access Key Identifyers<\/a>.<\/li>\n
    4. Create a wp-content\/cache\/<\/code> directory with permissions set to 755, or 777 if you create the directory as root<\/code> user.<\/li>\n
    5. Put <?php AMTAP::get_items(); ?><\/code> in your sidebar and start using machine tags.<\/li>\n
    6. Edit amtap-blog.css<\/code> if you like.<\/li>\n
    7. If you want to use tags in a blog article, write [amtap book:isbn=1234567890]<\/code> or [amtap amazon:asin=1234567890]<\/code>.<\/li>\n<\/ol>\n\n\n
      \n
      Does it work in the sidebar on Pages, too?<\/dt>\n

      Posts have tags, pages don\u2019t, so it doesn\u2019t work on those by default. But there\u2019s a plugin called tags4page<\/a> that enables tags for pages. Works like a charm.<\/p><\/dd>\n

      Is there a limit of how many items can be requested?<\/dt>\n

      Yes, Amazon has a limit of 10 items per request. Since they are separate requests, you can use a maximum of 10 items in the content plus a maximum of 10 in the sidebar.<\/p><\/dd>\n

      Would it be possible to cache the images?<\/dt>\n

      Technically it wouldn\u2019t be a problem, but the Amazon Product Advertising API license<\/a> explicitly forbids caching of images (see 5.1.10). Sorry.<\/p><\/dd>\n

      I need to a larger thumbnail (medium), but can\u2019t seem to find a place to edit the size of the image being requested.<\/dt>\n

      The image size can be edited in the XSLT. The original result is a XML file that is transformed by Amazon using your local copy of amtap-html-sidebar.xsl<\/code> and amtap-html-content.xsl<\/code>, respectively. Replacing every occurance of .\/\/aws:TinyImage<\/code> with .\/\/aws:MediumImage<\/code> in lines 73-83 should do the trick.<\/p>\n\n

      You can view the original XML when you activate the \u201cdebug\u201d option in the admin interface so that the request string is printed as a comment in the sidebar\u2019s source code. XSLT is a very powerful tool, and there\u2019s a lot more in the XML, for example customer reviews.<\/p><\/dd>\n

      Getting an error about \u201cprivate IP address space\u201d?<\/dt>\n

      The error message means you are running the blog on something like localhost<\/code>. Amazon Web Services needs to get an XML file from your server, obviously that is impossible when it\u2019s not located on a server that can be accessed with a public IP address from the outside.<\/p><\/dd>\n

      Are all options really required?<\/dt>\n

      No. The only required fields are the Amazon Web Services Access Key ID and your Secret Access Key. You can leave the others, they are set to defaults then.<\/p><\/dd>\n\n<\/dl>\n\n\n