{"id":2661,"date":"2008-03-15T15:58:28","date_gmt":"2008-03-15T15:58:28","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/amazon-search\/"},"modified":"2009-03-26T22:33:51","modified_gmt":"2009-03-26T22:33:51","slug":"amazon-search","status":"publish","type":"plugin","link":"https:\/\/tah.wordpress.org\/plugins\/amazon-search\/","author":319439,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.0","stable_tag":"1.2.0","tested":"2.7.1","requires":"2.2","requires_php":"","requires_plugins":"","header_name":"Amazon Search","header_author":"Andy Maloney","header_description":"","assets_banners_color":"","last_updated":"2009-03-26 22:33:51","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/imol.gotdns.com\/","header_plugin_uri":"http:\/\/wordpress.org\/extend\/plugins\/amazon-search\/","header_author_uri":"http:\/\/imol.gotdns.com\/","rating":5,"author_block_rating":0,"active_installs":10,"downloads":7828,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.2","1.1","1.1.1","1.1.2","1.1.3","1.2.0"],"block_files":[],"assets_screenshots":{"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1566829","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1566829","resolution":"3","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1566829","resolution":"1","location":"plugin"}},"screenshots":{"1":"An example search using the classic theme.","2":"The admin screen","3":"The Amazon link button in the editor"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[209,5333,6878,6928,1779],"plugin_category":[43],"plugin_contributors":[92151],"plugin_business_model":[],"class_list":["post-2661","plugin","type-plugin","status-publish","hentry","plugin_tags-amazon","plugin_tags-amazon-associate","plugin_tags-amazon-links","plugin_tags-amazon-shortcode","plugin_tags-books","plugin_category-customization","plugin_contributors-asmaloney","plugin_committers-asmaloney"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/amazon-search.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/amazon-search\/trunk\/screenshot-1.png?rev=1566829","caption":"An example search using the classic theme."},{"src":"https:\/\/ps.w.org\/amazon-search\/trunk\/screenshot-2.png?rev=1566829","caption":"The admin screen"},{"src":"https:\/\/ps.w.org\/amazon-search\/trunk\/screenshot-3.png?rev=1566829","caption":"The Amazon link button in the editor"}],"raw_content":"<!--section=description-->\n<p>This plugin allows you to link directly to items in your\nposts using a special tag of the form:<\/p>\n\n<p><strong>[amazon ASIN=0123456789]Fancy Title[\/amazon]<\/strong><\/p>\n\n<p>The plugin lets you set associate IDs for each international amazon server and set one server\nas the default for your site.<\/p>\n\n<p>It also includes an Amazon Search widget which will search any of the amazon servers\nand produce search results with direct links to products.<\/p>\n\n<p>It also provides an XSLT file for the amazon server to access, which processes it together with the XML results of\nthe search, and then returns HTML.  This saves your server from having to process the XML itself.<\/p>\n\n<p>It uses css to format the search widget and the search results.  It will look in its css dir for theme-specific css files\ntoo, so if you have one in there called <strong>your-theme-name.css<\/strong>, it will include it after <strong>default.css<\/strong>.  This way you may\ncustomize 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\na css file for each one and the search will look correct when it is switched.<\/p>\n\n<h4>Version History<\/h4>\n\n<ul>\n<li><p>v1.2.0 [23 March 2009]<\/p>\n\n<ul>\n<li>[fix] fixes for potential installation problems on WordPress 2.7<\/li>\n<li>[new] add buttons to the TinyMCE and QuickTag editors to make the Amazon markup easier [code from <a href=\"http:\/\/sillybean.net\">Stephanie Leary<\/a> - thanks Stephanie!]<\/li>\n<li>[new] new editor buttons are optional [They are on by default but may be turned off in the preferences.]<\/li>\n<li>[new] made the search part of the plugin optional [If you just want to use the text links, search may be completely disabled in the preferences.]<\/li>\n<li>[other] code reorganization and cleanup<\/li>\n<\/ul><\/li>\n<li><p>v1.1.3 [20 July 2008]<\/p>\n\n<ul>\n<li>[fix] fix dumbness introduced in 1.1.2<\/li>\n<\/ul><\/li>\n<li><p>v1.1.2 [20 July 2008]<\/p>\n\n<ul>\n<li>[new] code refactoring of the ipNation stuff for some future work<\/li>\n<li>[new] check if the ip2Nation database is installed when displaying options on the admin page<\/li>\n<\/ul><\/li>\n<li><p>v1.1.1 [23 May 2008]<\/p>\n\n<ul>\n<li>[fix] fix for PHP 4.x<\/li>\n<li>[fix] better integration with Silver Light theme<\/li>\n<\/ul><\/li>\n<li><p>v1.1.0 [26 Apr 2008]<\/p>\n\n<ul>\n<li>[new] added ability to specify a text link in posts by using a special tag: [amazon asin=0123456789]link text[\/amazon]<\/li>\n<li>[new] new text links will use <a href=\"http:\/\/www.ip2nation.com\/ip2nation\">ip2Nation database<\/a> to do simple geo-location<\/li>\n<\/ul><\/li>\n<li><p>v1.0.2 [02 Apr 2008]<\/p>\n\n<ul>\n<li>[fix] fix default XSL path<\/li>\n<\/ul><\/li>\n<li><p>v1.0.1 [22 Mar 2008]<\/p>\n\n<ul>\n<li>[new] add CSS for Silver Light theme<\/li>\n<li>[fix] fix incorrect paths due to last-minute name change<\/li>\n<\/ul><\/li>\n<li><p>v1.0.0 [08 Jan 2008]<\/p>\n\n<ul>\n<li>initial version<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h3>Configuring The Plugin<\/h3>\n\n<p>In the Admin section, under <strong>Settings -&gt; Amazon Search<\/strong> you may configure the following:<\/p>\n\n<h4>Associate IDs<\/h4>\n\n<p>In this section, fill in any associate IDs you have.  You may also select one of the servers to be the\ndefault for your users.  If you live in France, you might choose the amazon.fr server, for example.\nAny IDs left blank will be filled in with mine.<\/p>\n\n<h4>Development Contribution<\/h4>\n\n<p>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],\nthe links which are produced use my\nassociate IDs.  You can choose a value for 'N' here.  No need to go hacking if you don't want to support\ndevelopment - just set it to 0 and it won't ever substitute my associate IDs.<\/p>\n\n<h4>Text Links<\/h4>\n\n<p>If <strong>Use Text Links<\/strong> is on, the plugin will process your posts looking for a special markup and convert them to links.<\/p>\n\n<p>To add a text link to an Amazon product, simply use the following format:<\/p>\n\n<p>[amazon ASIN=0743279794]Fancy Title[\/amazon]<\/p>\n\n<p>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'.<\/p>\n\n<p>This tag will be converted to a link of the form:<\/p>\n\n<p>&lt;a href=\"http:\/\/www.amazon.com\/dp\/0743279794\/?tag=yourTag-20\"&gt;Fancy Title&lt;\/a&gt;<\/p>\n\n<p>If you have <strong>Use ip2Nation<\/strong> checked and the <a href=\"http:\/\/www.ip2nation.com\/ip2nation\">ip2Nation database<\/a> is installed, it may be used to locate the best Amazon site for the visitor.  Any country not handled specially will\nuse your default Amazon server.  If you have the <strong>Development Contribution<\/strong> set in your prefs, a page load will count as a 'search'.<\/p>\n\n<p><strong>NOTE:<\/strong> The handling of which Amazon site is best per country is incomplete at best.  I would appreciate any feedback or additions\/corrections\nto the list [which is found in the getAmazonServerFromIP() function in amz-search.php].<\/p>\n\n<p><strong>Add Editor Buttons<\/strong> allows you to turn off the additional buttons in the editors which provide a quick way to enter an amazon link.<\/p>\n\n<h4>Searching<\/h4>\n\n<p><strong>Use Searching<\/strong> allows you to turn off the search capability completely in case you just want to use the text links.<\/p>\n\n<p><strong>Default Category<\/strong> is the one that will be used when the user searches from the widget.  When they\nget the results, they will be able to change the category on the search page.<\/p>\n\n<p><strong>Default Search Term<\/strong> is what is used if the user doesn't enter a search term.  Right now it defaults\nto 'WordPress'.  You will probably want to change it to something appropriate to your site.<\/p>\n\n<p>You may specify an XSLT file that will be sent to the amazon servers for processing.  <strong>This file must be publicly\naccessible<\/strong> because the amazon servers will be reading it to provide formatting. \nIf you don't know what this means, you better leave it alone.  The XSLT file may be edited if you want to\ncustomise the results produced by the search.  I am certainly <em>not<\/em> an XSLT expert, so if you have any suggestions,\nplease contact me.<\/p>\n\n<p>You may also set the size of the images that are to be returned in the search or 'None' to turn them off.\nWatch out if you set this to 'Large'!<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the whole amazon-search directory to your \/wp-content\/plugins\/ directory [it must be called amazon-search]<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Configure it using the <strong>Settings -&gt; Amazon Search<\/strong> page in WordPress<\/li>\n<li>Go to the <strong>Appearance -&gt; Widgets<\/strong> page and drag the <strong>Amazon Search<\/strong> widget into a sidebar.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Why do I just get a bunch of text when I search?<\/dt>\n<dd><p>Check that <strong>XSL file<\/strong> is set properly in your prefs and is a full URL to an externally visible file.  The Amazon servers will grab\nthis file to format your results.<\/p>\n\n<p>Note that if you change the XSL file it may take a minute or two for the Amazon server's cache to update it.<\/p><\/dd>\n<dt>What did you use for development?<\/dt>\n<dd><ul>\n<li>WordPress 2.7.1<\/li>\n<li>MAMP 1.7.1<\/li>\n<li>Firefox 3.1b3<\/li>\n<li>MacOS X 10.5.6<\/li>\n<\/ul><\/dd>\n<dt>What are some of the limitations?<\/dt>\n<dd><ul>\n<li>you cannot choose the sorting order<\/li>\n<li>you cannot choose which item data that is shown in the result [unless you know XSLT]<\/li>\n<li>the search part of the plugin requires that your HTTP server have cURL support<\/li>\n<\/ul><\/dd>\n<dt>Uh... Why?<\/dt>\n<dd><p>I originally wrote this for the Geeklog CMS.  When I wrote it, Amazon did not provide widgets,\nand Amazon Associates received more income for direct links than for others.  So I wrote this so Associates could\ngenerate more direct-link income from their sites.<\/p>\n\n<p>Amazon now provides a widget that does most of what the search provides.  What it doesn't do is integrate nicely with your website.  This plugin\nis intended to provide seamless integration with your site's theme and give you more control over the layout and information presented.<\/p>\n\n<p>After porting the search facility I added support for the special tags to add text links to posts. <a href=\"http:\/\/sillybean.net\">Stephanie Leary<\/a> then\nprovided me with some code to add buttons to the editors which I modified and included with the plugin.<\/p>\n\n<p>If I get decent feedback and people are using it, I will continue to improve it.<\/p><\/dd>\n<dt>How do I contact you?<\/dt>\n<dd><p>You can email my gmail account <strong>imol00<\/strong>.<\/p><\/dd>\n\n<\/dl>","raw_excerpt":"Lets you add links to Amazon using a special markup. Also includes an optional widget to search Amazon and display results in your blog.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/2661","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=2661"}],"author":[{"embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/asmaloney"}],"wp:attachment":[{"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=2661"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=2661"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=2661"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=2661"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=2661"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tah.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=2661"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}