This repository has been archived by the owner on Nov 11, 2017. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
284 lines (216 loc) · 11.1 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
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
=== Amazon Widgets Shortcodes ===
Contributors: oncletom
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=752034
Tags: amazon, affiliate, shortcode, shortcodes, monetization, context, links, product, preview, carrousel, documentation, plugin, slideshow, admin, post, page, tinymce, wysiwyg, wpmu
Requires at least: 2.5
Tested up to: 3.1
Stable tag: 1.6.1
Keep your time and save your money with these Amazon widgets shortcodes. Standard compliants, easy to use and so on !
== Description ==
Easy management of Amazon Links & Widgets on your blog. Preserve your post consistency, use copy/paste Amazon code or build your links with an easy to use interface
**Hot Features**
* switch from TinyMCE to HTML without loosing anything!
* international Amazon support (Canada, France, Germany, Japan, United Kingdom, USA)
* easy insertion from TinyMCE
* autoconfigure from copy/paste code
* minimal shortcodes (1 option and it runs)
* inline documentation for people who want to manually write Amazon Shortcodes
**Other Features**
* XHTML Strict validation
* RSS feed filtering (don't spam your feeds)
* Amazon Context Links
**Available Amazon Widgets**
* Carrousel Widget
* Deals Widget
* MP3
* My Favorites Widget
* Product Preview
* Product Links
* Slideshow Widget
* Product Cloud Widget
* Wishlist Widget
**Built-in Translations**
* Belorussian (by [Fat Cow](http://www.fatcow.com/))
* English
* French
* Hebrew (by [Sagive SEO](http://www.sagive.co.il))
* Italian (by [Gianni Diurno](http://gidibao.net/))
* Russian (by [ilyuha](http://antsar.info/)]
* Uzbek (by [Alexsandra Bolshova](http://www.comfi.com/)]
Don't forget to look at the [screenshots](http://wordpress.org/extend/plugins/amazon-widgets-shortcodes/screenshots/) if you are not convinced.
== Installation ==
The plugin is very basic and is primarily made for my own usage.
1. Simply upload the `amazon-widgets-shortcodes` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go in the `Settings` admin panel to customize at least your Amazon Tracking ID
Now you plug 'n play 'n earn money ;-)
== Todo-list ==
1. Provide an API to let other developers to plug-in
1. Blog sidebar Widgets
1. Profile management
1. Widgets management
1. Amazon Associate browsing in the same window
1. Support for these widgets:
* aStore
* Banners
* Dynamic Links
1. Makes you earning a lot of money thanks to this widget ;-)
== Changelog ==
= Version 2.0 =
*Work in progress*.
Please notice that this forthcoming version **will require at least**:
* PHP 5.1.2 (so that the `spl_autoload` function is available)
* WordPress 3.0
= Version 1.6.2 =
* fix: widget product was shown in French for Italian users
* fix: double dashed Tracking ID were not properly detected
* i18n: added Hebrew translation
= Version 1.6.1 =
* fix: disabled widgets messed up things when none set (as said, always...)
= Version 1.6 =
* added support for Amazon Italia (restricted to Products so far)
* admin: you can now enable/disable some widgets
* i18n: updated strings
* widget: fixed Link Enhancer for Germany (was displaying Canadian links)
* widget: fixed Amazon Products for Germany (was displaying Canadian links)
* widget: fixed Link Enhancer for Japan (was displaying French links)
* multisite: by default, all new blogs have the plugin enabled
* multisite: by default, a new blog import your Tracking ID and region
= Version 1.5.2 =
* i18n: added Russian translation
* i18n: added Uzbek translation
= Version 1.5.1 =
* fixed plugin uninstall process ([report topic](http://wordpress.org/support/topic/241974))
* ui: fixed *apply the magic* color for WordPress 2.8
* widget: fixed Amazon Product widget alternate pattern parsing ([report topic](http://wordpress.org/support/topic/293885))
* widget: fixed Amazon Product widget display for Amazon Japan ([report topic](http://wordpress.org/support/topic/292387))
= Version 1.5 =
* support of the `Changelog` feature
* i18n : fixed relocated WordPress folder for WordPress 2.7+ ; translations were not loading due to wrong path
* ui: documentation tab now displays the ... documentation (it helps a bit ...)
* widget: added MP3 Widget
* widget: fixed 'apply the magic' parser which missed some ASIN codes with alpha chars inside (reported by [DavidBorrink](http://wordpress.org/support/profile/20995))
* widget: fixed Germany widgets (reported by [jetztlernin](http://wordpress.org/support/profile/3392887))
* widget: fixed some inconsistencies with titles and regions
= Version 1.4.1 =
* i18n: new Belorussian translation thanks to [Fat Cow](http://www.fatcow.com/)
= Version 1.4 =
* added configuration link within plugins list
* added support for Amazon Germany
* added support for Amazon Japan
* fixed typo in documentation (`Amazon My Favourites` example)
* tinymce: fixed tracking ID parsing with some Flash Widget (messed up with classID)
* widget: added Deals Widget
* widget: fixed Context Links for Amazon Japan (missing feature so far)
= Version 1.3.2 =
* fixed classname typo for "My Favourites widget"
* fixed an issue on some hosting plans which display a 404 page in TinyMCE Editor
* removed inlined CSS to use .alignleft, .aligncenter, .alignright WP classes (props of tbrincefield)
= Version 1.3.1 =
* fixed Product Preview bug on plugin activation
= Version 1.3 =
* inline documentation is now more displayed by default
* huge code overhaul for easier maintenance
* tracking images are now enabled for Product Links
* tinymce: fixed RTE/HTML switching causing removal of all `<span>` tags
* tinymce: rich formating inside shortcode is now removed (avoid to break shortcode display on the frontend)
* tinymce: tracking ID and region are filled automatically from copy/paste feature
* widget: region and/or tracking ID can be overridden individually
* widget: added My Favorites Widget
* widget: Product Widget now handles text+image, image and text
* widget: added Product Cloud Widget
* wordpress: Wordpress 2.7 compatibility
HUGE thanks to [Kathryn Presner](http://www.zoonini.com) for testing and reporting problems.
Kudos to LesBessant and fredl for reporting usage problems with Wordpress µ and Wordpress 2.7.
= Version 1.2.2 =
* wordpress: support of Wordpress µ 2.5+
= Version 1.2.1 =
* small reorganization of screenshots on WP.org plugin page
* i18n: new Italian translation thanks to [Gianni Diurno](http://gidibao.net/)
= Version 1.2 =
* Copy/Paste HTML feature
* Small code bug fixes
* tinymce: Compressed plugin for faster loading
= Version 1.1 =
* secured plugin directory using new WP 2.6 constants (backward compatibility for WP 2.5)
* improved welcoming text to give more accurate hyperlinks
* fixed typo issues
* added the ability to hide the documentation from writing pages
* this same documentation is also available from the configuration page
* the old way call for the carrousel is now obsolete, please follow the usage provided by the widget documentation
* tinymce: added Amazon Widgets rich text editor button:
* insert or edit current widgets in one click
* handles all supported widgets for now
* easy inclusion without having to read the documentation
* widget: reintroduced the slideshow shortcode which was accidentally removed
= Version 1.0 =
* added Strict Standards compliance mode (`object` instead of `iframe`)
* markup fix (no more `<p>` embracing the shortcode)
* amazon: added region support for United Kingdom
* amazon: Amazon Partner developer center aware of the plugin (not a feature I admit)
* widget: added Slideshow widget support
= Version 1.0 beta 1 =
* inline documentation in the edit page/post screen
* added extra links to declare bugs and official homepage
* revamped some parts of code
* improved stability while plugin is a symlink (activation hook now works)
* updated the options pages with a tabbed view
* added screenshots to convince you it's a good plugin ;-)
* amazon: added region support (USA, Canada and France for now)
* i18n: fixed some translation issues
* widget: added Product Preview support
= Version 1.0 alpha 3 =
* "hide widgets in feed" renamed as "show widgets in feed" to match better the setting name (more natural)
* i18n: internationalisation support (english and french)
* widget: basic support of context links (no options for now)
= Version 1.0 alpha 2 =
* file organization revamping
* new option to define default alignment of widgets
* handling widget alignment (previously customizable but not used)
* added CSS class to widget container to ease their styling from your stylesheets
* options are handled by the admin dashboard, no need to edit config.php anymore
* widget: added Amazon Product (text + picture)
= Version 1.0 alpha 1 =
* Improved documentation
* Provides filter for syndication feed publishing (avoid the display of affiliate media in your feed)
* Separation of the code ; `trunk` is for dev version
== Frequently Asked Questions ==
= What are those shortcodes? =
It is a bundled Wordpress feature. It looks like this : `[shortcode]sample value[/shortcode]`.
It looks like nothing but it is an expandable feature so we can plug our own shortcodes ... like with this widget.
= How can I use the shortcodes? =
You have 2 ways to using them:
* by writing yourself the shortcode as plain text
* by using the shortcode wizard provided with the Rich Text Editor (TinyMCE)
You can even insert them through the copy/paste feature.
= What is the copy/paste feature you talk about? =
It's easy : when you want to insert a widget through the RTE wizard, you have a copy/paste tab.
It's waiting you to copy/paste the Amazon's provided HTML.
It then auto-fills every single field needed.
That is smart. You save time, you gain in quality usage.
= Won't context links garbage my whole page? =
No it won't.
I added a filter so the context links areas are confined to post and page contents.
If politely asked, I can make this customizable from the plugin management page.
= Can I translate your plugin? =
Yes for sure but do it only if it's not already translated in your language.
For this, check Wordpress documentation about [translating a plugin](http://codex.wordpress.org/Writing_a_Plugin#Internationalizing_Your_Plugin) and [translating Wordpress](http://codex.wordpress.org/Translating_WordPress)
Once you have done your first translation from the trunk, [contact me](http://case.oncle-tom.net/contact).
= How is organized the translation =
There are 3 steps:
1. code freezing
2. translation
3. code release
The code freeze will ... freeze the code in the repository. It means there won't be any changes, except some small bug fixes which don't impact translating work.
All the translation team will be notified by email about the code change and will let 1 week to translate new chains.
Once all the translations are up, they are added in the repository and the new plugin released.
= Nespresso, what else? =
Yep, what else?
But no, George Clooney neither Nespresso are a feature of this plugin. Too bad!
== Screenshots ==
1. Widget selection via Rich Text Editor (with TinyMCE)
2. Widget configuration via Rich Text Editor (TinyMCE)
3. Copy/Paste feature
4. Main configuration panel
5. Extra tools configuration panel
6. Inline documentation