-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathreadme.txt
216 lines (143 loc) · 6.64 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
=== Amazon JS ===
Contributors: makoto_kw
Tags: Amazon, books, post, media, affiliate
Requires at least: 3.3
Tested up to: 5.2.5
Stable tag: trunk
Requires PHP: 5.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Easy to add an Amazon product to your post and you can customize display it by using jQuery template.
== Description ==
AmazonJS displays Amazon products on your WordPress posts and pages. AmazonJS adds a search form to WordPress post form. Then you can search Amazon products by keyword, ASIN or URL, and add shortcode or html to your post from results of search.
AmazonJS uses `amazonjs' shortcode and jQuery template to display Amazon products. View the work data at runtime, Javascript allows various representations. AmazonJS has some template to Amazon products for each Product Group, it can how to display the different Amazon products, such as books and music.
* Requires WorPress 3.3 or later
* Requires your Amazon Product Advertising API
* Plugin Uses API cache by using Transients API
* Customize template by using jQuery template
* HTTPS Support
* Supports Amazon domains ([US](http://www.amazon.com), [UK](http://www.amazon.co.uk), [Germany](http://www.amazon.de), [France](http://www.amazon.fr), [Japan](http://www.amazon.co.jp/), [Canada](http://www.amazon.ca), [China](http://www.amazon.cn), [Italy](http://www.amazon.it), [Spain](http://www.amazon.es))
= Using Amazon Product Advertising API =
AmazonJS requires [Amazon Product Advertising API](https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html)
in order to get Amazon product information from ASIN or keyword.
Thus, you have to sign up Amazon Product Advertising API and specify your **Access Key** and **Secret Access Key**.
And you must set your associate tags for Amazon Associates also.
= Shortcode =
AmazonJS adds a media link above an editor in the editing post page. The form that searches an Amazon product is shown when you click it. AmazonJS adds a simple html code (like WP-amazon) or an `amazonjs` shortcode from form.
AmazonJS supports the `amazonjs' shortcode.
ex)
[amazonjs asin="B00005ED8E" locale="JP" tmpl="Small" title="D・N・A"]
* *asin*: (required) ASIN (ProductID of Amazon)
* *locale*: (required) `US`, `UK`, `DE`, `FR`, `JP`, `CA`, `CN`, `IT` or `ES`
* *tmpl*: (optional) `Small`. if tmpl is empty, apply a template via Product Group of Amazon Product Advertising API.
* *title*: (optional) It will be used for loading message.
* *imgsize*: (optional) Thumbnail image size. `small`, `medium` or `large`.
= Display by javascript =
In first, AmazonJS converts <a/> tag from `amazonjs` short code in server side. Second, in window.load, `amazonjs.js` (it is added by plugin) will replace <a/> tag with formatted html to display Amazon Product by using jQuery template.
= Link =
* GitHub Repository (latest source code and old versions): https://github.com/makotokw/wp-amazonjs
* Japanese article: http://blog.makotokw.com/portfolio/wordpress/amazonjs/
== Installation ==
1. Upload `amazonjs` to the `/wp-content/plugins/` directory
1. Activate the plugin through the `Plugins` menu in WordPress
1. Set your associate tags and your keys of the Product Advertising API through the `Settings` > `Amazonjs` menu in WordPress
= Directory structure =
/wp-content
/plugins/amazonjs
+ /css/*
+ /images/*
+ /js/*
+ /languages/*
+ /lib/*
- *.*
= Settings =
1. Access to /wp-admin/ and click Settings > AmazonJS on menu
1. Set your keys for Product Advertising API
1. Set your Amazon Associate Tag via Amazon Domain
== Frequently Asked Questions ==
== Screenshots ==
1. Click the gray Amazon icon to go to search form in editing entry page.
== Upgrade Notice ==
== Changelog ==
= 0.10 =
* Support Product Advertising API 5.0
= 0.9 =
* Use https link for image and anchor
* Use saved AssociateTag country instead locale country as default
* Added TinyMCE Button to editor on Gutenberg Classic Block
* Fixed to conflict with stylesheet of WP Limit Login Attempts plugin
= 0.8 =
* Supported Transients API for cache (file cache is no longer in use)
* Improved to start rendering
* Fixed to use `get_locale()` instead of `WPLANG`
= 0.7.3 =
* Fixed to save settings by checkbox
* Fixed image url over https
= 0.7.2 =
* Fixed PHP Short Open Tag in PHP5.3 or earlier by @shield-9
* Improved timeout to request Product Advertising API
* Required WordPress 3.3
= 0.7.1 =
* Fixed to parse ItemID into https URL
* Fixed Japanese translation of search form
* Improved to display to display the error response of Product Advertising API
* Bundle the jquery.tmpl
* WordPress Cording Standard
= 0.7 =
* Supported click tracking by Google Analytics
* Added option to overwrite !important style of theme in v0.6.1
= 0.6.1 =
* Fixed to overwrite !important style of theme
* Fixed `imgsize`
= 0.6 =
* Added option to allow animation
* Supported `imgsize` attr of shortcode
* Fixed to display same ASIN for some countries
* Fixed style for smart phone and dark theme
= 0.5 =
* Added DVD template
* Optimized style for WordPress 3.8
* Used wp-ajax to search product in admin page
* Removed minify css and js to avoid to conflict W3 Total Cache
= 0.4.2 =
* Fixed to work in footer with jQuery
* Fixed to enqueue jQuery in admin page
* Fixed to find config file above ABSPATH
* Fixed and improved to display error message
= 0.4.1 =
* Added amazonjs.js script only when needed
* minify css and js
= 0.4 =
* Added option to display customer review, default is off
* Added option to display an Amazon official widget when disabled javascript in web browser, default is off
* Changed priority of wp_print_footer_scripts to execute before other plugin occurred error
= 0.3 =
* Used MediumImage in blog feed for the magazine view of feedly
* Add an Amazon product url to indicator if it has cache data
* Supported disable javascript to display amazon link widget
* Fixed to fetch more 10 products at once
* Fixed some php warnings
= 0.2.1 =
* Fixed to display image on the IE 8
= 0.2 =
* Fixed to use custom style on the child theme
* Improved to display an error message
= 0.1beta5 =
* Added ItemGroup Template for Amazon Kindle Book
* Fixed to display price
= 0.1beta4 =
* Allow to use Unsupported Search Index of Amazon Product Advertising API
* Amazon Product Advertising API Version 2011-08-01
= 0.1beta3d =
* Fixed to return json response with error log
= 0.1beta3c =
* Fixed to detect WP_CONTENT_DIR
= 0.1beta3b =
* Supported WordPress 3.3(beta3)
* Fixed to remove deprecated
* Fixed template
= 0.1beta3a =
* Supported to search by ASIN or URL
* Amazon Product Advertising API Version 2010-11-01
= 0.1beta2 =
* Initial release