PluginProbe ʕ •ᴥ•ʔ
Image Widget / 4.4
Image Widget v4.4
trunk 1.0 2.0 2.1 2.2 2.2.1 2.2.2 3.0 3.0.1 3.0.2 3.0.3 3.0.4 3.0.5 3.0.6 3.0.7 3.0.8 3.0.9 3.1 3.1.1 3.1.2 3.1.3 3.1.4 3.1.5 3.1.6 3.2 3.2.1 3.2.10 3.2.11 3.2.2 3.2.3 3.2.4 3.2.5 3.2.7 3.2.8 3.2.9 3.3 3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 4.0 4.0.1 4.0.2 4.0.3 4.0.4 4.0.5 4.0.6 4.0.7 4.0.8 4.0.9 4.1 4.1.1 4.1.2 4.2 4.2.1 4.2.2 4.3 4.3.1 4.4 4.4.1 4.4.11 4.4.12 4.4.2 4.4.3 4.4.4 4.4.5 4.4.6 4.4.7 4.4.8 4.4.9
image-widget / readme.txt
image-widget Last commit date
lang 9 years ago lib 9 years ago resources 9 years ago views 9 years ago image-widget.php 9 years ago index.php 9 years ago readme.txt 9 years ago
readme.txt
519 lines
1 === Image Widget ===
2 Contributors: ModernTribe, peterchester, borkweb, zbtirrell
3 Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4BSPTNFFY6AL6
4 Tags: widget, image, ad, banner, simple, upload, sidebar, admin, thickbox, resize, arabic, brazilian portuguese, dutch, german, hebrew, italian, japanese, polish, spanish, swedish, widget-only
5 Requires at least: 3.5
6 Tested up to: 4.7.3
7 Stable tag: 4.4
8
9 A simple image widget that uses the native WordPress media manager to add image widgets to your site.
10
11 == Description ==
12
13 Image Widget is a simple plugin that uses the native WordPress media manager to add image widgets to your site.
14
15 Need to add slideshows, lightboxes, or random images? Check out [Image Widget Plus](http://m.tri.be/19mc)!
16
17 = Image Widget Features =
18
19 * Responsive
20 * MU Compatible
21 * Handles image resizing and alignment
22 * Link the image
23 * Add title and description
24 * Versatile - all fields are optional
25 * Upload, link to external image, or select an image from your media collection
26 * Customize the look & feel with filter hooks or theme overrides
27 * Additional features available with [Image Widget Plus](http://m.tri.be/19mc)
28
29 = Quality You Can Trust =
30
31 Image Widget is developed and maintained by [Modern Tribe](http://m.tri.be/19md), the same folks behind [The Events Calendar, Event Tickets, and a full suite of premium plugins](http://m.tri.be/19me).
32
33 This plugin is actively supported by our team and contributions from community members. If you see a question in the forum you can help with or have a great idea and want to code it up or submit a patch, that would be awesome! Not only will we shower you with praise and thanks, it’s also a good way to get to know us and lead into options for paid work if you freelance.
34
35 = Coming Soon - Image Widget Plus! =
36
37 Looking for more features? Our [new Image Widget Plus plugin](http://m.tri.be/19mf) is coming soon!
38
39 Image Widget Plus features include:
40
41 * Multiple image support
42 * Random image
43 * Slideshow
44 * Lightbox
45
46 [Check out Image Widget Plus now!](http://m.tri.be/19mg)
47
48 = Pull Requests & Translations =
49
50 [Check us out on GitHub](https://github.com/moderntribe/image-widget) to pull request changes.
51
52 Translations can be submitted [here on WordPress.org](https://translate.wordpress.org/projects/wp-plugins/image-widget).
53
54 == Installation ==
55
56 = Install =
57
58 Getting started with Image Widget is a breeze!
59
60 1. Download and install the Image Widget plugin
61 1. From your WordPress admin screen, select Plugins from the menu
62 1. Activate the Image Widget plugin
63 1. Go to Appearance > Widget to place the widget in your sidebar in the Design
64
65 If you run into any questions or have suggestions, please visit the forum to post questions or comments.
66
67 = Requirements =
68
69 * PHP 5.2 or above
70 * WordPress 3.5 or above
71
72 == Screenshots ==
73
74 1. Image Widget admin screen.
75 1. Media manager integration.
76 1. Image Widget on the front of a plain WordPress install.
77
78 == Frequently Asked Questions ==
79
80 = How do I log into my site to install this plugin? =
81
82 Visit [the WordPress codex](https://codex.wordpress.org/Login_Trouble) for help with login troubles.
83
84 = Can I display Image Widget on only one page? =
85
86 Yes you can, however, this is not controlled through the Image Widget plugin directly - it is usually managed through a page-specific sidebar display.
87
88 There are several solutions available to accomplish this. A quick search for “WordPress page-specific sidebar display” can help you find the best option for your site.
89
90 = Is there a demo available? =
91
92 Though we do not have a demo available, we do have [screenshots available here](https://wordpress.org/plugins/image-widget/screenshots/).
93
94 = How can I add lightbox, slider, or random image capabilities? =
95
96 These features are part of our Image Widget Plus plugin. You can learn more about [Image Widget Plus](http://m.tri.be/19mh) on our website.
97
98 = Where do I go to file a bug or ask a question? =
99
100 Please [visit the forum to post questions or comments](https://wordpress.org/support/plugin/image-widget/).
101
102 == Documentation ==
103
104 The built in template can be overridden by files within your template.
105
106 = Default vs. Custom Templates =
107
108 The Image Widget comes with a default template for the widget output. If you would like to alter the widget display code, create a new folder called "image-widget" in your template directory and copy over the "views/widget.php" file.
109
110 Edit the new file to your hearts content. Please do not edit the one in the plugin folder as that will cause conflicts when you update the plugin to the latest release.
111
112 New in 3.2: You may now also use the "sp_template_image-widget_widget.php" filter to override the default template behavior for .php template files. Eg: if you wanted widget.php to reside in a folder called my-custom-templates/ and wanted it to be called my-custom-name.php:
113
114 `add_filter('sp_template_image-widget_widget.php', 'my_template_filter');
115 function my_template_filter($template) {
116 return get_template_directory() . '/my-custom-templates/my-custom-name.php';
117 }`
118
119 = Filters =
120
121 There are a number of filters in the code that will allow you to override data as you see fit. The best way to learn what filters are available is always by simply searching the code for 'apply_filters'. But all the same, here are a few of the more essential filters:
122
123 *widget_title*
124
125 This is actually a pretty typical filter in widgets and is applied to the widget title.
126
127 *widget_text*
128
129 Another very typical widget filter that is applied to the description body text. This filter also takes 2 additional arguments for $args and $instance so that you can learn more about the specific widget instance in the process of filtering the content.
130
131 *image_widget_image_attachment_id*
132
133 Filters the attachment id of the image.
134 Accepts additional $args and $instance arguments.
135
136 *image_widget_image_url*
137
138 Filters the url of the image displayed in the widget.
139 Accepts additional $args and $instance arguments.
140 THIS IS DEPRECATED AND WILL EVENTUALLY BE DELETED
141
142 *image_widget_image_width*
143
144 Filters the display width of the image.
145 Accepts additional $args and $instance arguments.
146
147 *image_widget_image_height*
148
149 Filters the display height of the image.
150 Accepts additional $args and $instance arguments.
151
152 *image_widget_image_maxwidth*
153
154 Filters the inline max-width style of the image. Hint: override this to use this in responsive designs :)
155 Accepts additional $args and $instance arguments.
156 Return null to remove this css from the image output (defaults to '100%').
157
158 *image_widget_image_maxheight*
159
160 Filters the inline max-height style of the image.
161 Accepts additional $args and $instance arguments.
162 Return null to remove this css from the image output (defaults to null)
163
164 *image_widget_image_size*
165
166 Filters the selected image 'size' corresponding to WordPress registered sizes.
167 If this is set to 'tribe_image_widget_custom' then the width and height are used instead.
168 Accepts additional $args and $instance arguments.
169
170 *image_widget_image_align*
171
172 Filters the display alignment of the image.
173 Accepts additional $args and $instance arguments.
174
175 *image_widget_image_alt*
176
177 Filters the alt text of the image.
178 Accepts additional $args and $instance arguments.
179
180 *image_widget_image_link*
181
182 Filters the url that the image links to.
183 Accepts additional $args and $instance arguments.
184
185 *image_widget_image_link_target*
186
187 Filters the link target of the image link.
188 Accepts additional $args and $instance arguments.
189
190 *image_widget_image_attributes*
191
192 Filters a list of image attributes used in the image output. Similar to 'wp_get_attachment_image_attributes'
193 Accepts $instance arguments
194
195 *image_widget_link_attributes*
196
197 Filters a list of attributes used in the image link. Similar to 'wp_get_attachment_image_attributes'
198 Accepts $instance arguments
199
200 = Have You Supported the Image Widget? =
201
202 If so, then THANK YOU! Also, feel free to add this line to your wp-config.php file to prevent the image widget from displaying a message after upgrades.
203
204 define( 'I_HAVE_SUPPORTED_THE_IMAGE_WIDGET', true );
205
206 For more info on the philosophy here, check out our [blog post](http://tri.be/define-i-have-donated-true/)
207
208 == Changelog ==
209
210 = 4.4 =
211
212 * Feature - Add srcset and size attribute support (props @philwp)
213 * Tweak - Readme adjustments
214 * Tweak - Additional refinements to notice code.
215
216 = 4.3.1 =
217
218 * Tweak - Upgrade admin notice code
219
220 = 4.3 =
221
222 * Translations - fixed compatibility with translate.wordpress.org
223 * Translations - restored the pot file for easier community translations
224 * Tweak - fixed a typo
225 * Tweak - Minor code cleanup
226
227 = 4.2.2 =
228
229 * Feature - Include registered image sizes in the list of selectable items (props to aaemnnosttv for the pull request!)
230
231 = 4.2.1 =
232
233 * Feature - Removing Freemius. Interesting experiment, but ultimately, not our cup of tea. Thanks for sticking with us!
234
235 = 4.2 =
236
237 * Security - Prevent direct access to directories (thank you @ramiy)
238 * Translations - Remove po/mo files, migrate to translate.wordpress.org language packs
239 * Feature - Add support for the rel attribute
240 * Feature - Adding an opt-in integration with Freemius
241
242 = 4.1.2 =
243
244 * Tweak - Added support for an id attribute on links (Props to amyh for the work on this!)
245
246 = 4.1.1 =
247
248 * Tweak - Retiring the use of PHP 4 style constructors
249
250 = 4.1 =
251
252 * Remove accidentally deployed image size update.
253
254 = 4.0.9 =
255
256 * Fix image stretching bug in admin (Thanks @kyleunzicker)
257 * Add polish translation (thank you @difreo)
258 * Add hebrew translation (thank you Ariel Klikstein)
259 * Add german translation (thank you Daniel Schmidt)
260 * Fix "Alt" text in the widget source to use actual "Alt" text (thanks @adoliver and @Degas)
261
262 = 4.0.8 =
263
264 * Responsive support in honor of Josh Broton's WordCamp SF talk about responsive design. max-width now defaults to 100%;
265
266 = 4.0.7 =
267
268 * Add Spanish translation (thank you @mzaweb)
269
270 = 4.0.6 =
271
272 * Rename all language files and implement a couple more minor language bug fixes a la @understandard
273 * Added support for the constant 'I_HAVE_SUPPORTED_THE_IMAGE_WIDGET' to turn off the message that appears after upgrading. (@crienoloog, i hope this puts a smile on your face.)
274
275 = 4.0.5 =
276
277 * Added Japanese (and fixed a minor language string bug - thank you @understandard)
278 * Added Arabic (thank you @modmenpc)
279
280 = 4.0.4 =
281
282 Super minor fix to enable saving of a blank caption. (thanks @crdunst)
283
284 = 4.0.3 =
285
286 Fixed javascript bug caused by log message.
287
288 = 4.0.2 =
289
290 Fix oversized screenshot.
291
292 = 4.0.1 =
293
294 Language updates:
295
296 * Brazilian Portuguese (Thank you @guhemama)
297 * Spanish (Thank you @javiandgo)
298
299 = 4.0 =
300
301 * Significant upgrades to support the new WordPress media manager (Thank you @kyleunzicker, @dancameron, @dudekpj, @JakePT)
302 * Significant improvements the administrative user interface.
303 * Abstracted support for older versions of WordPress so that that we don't break old versions with this upgrade (Though there's no reason you should up grade this widget and NOT your WP install! You should always keep WordPress core up to date!)
304 * Added 'image_widget_link_attributes' filter to easily process link attributes and to default to having the link 'title' be the 'alt' or 'title' content. (Thank you @ZeroGravity, @pixelyzed, and @javiandgo)
305 * Updated Translations
306 ** Swedish (Tomas Lindhoff <tomas@xhost.se>)
307 ** Dutch (Presis <contact@presis.nl>)
308 ** Italian (@maxgx)
309
310 = 3.3.8 =
311
312 * Added italian translations courtesy of @maxgx
313
314 = 3.3.7 =
315
316 * Add filters so that people can more easily adjust the output of the widget as per @TCBarrett's request.
317
318 = 3.3.6 =
319
320 * Czech translation courtesy of Vladislav Musilek at blogísek (http://blog.musilda.cz).
321
322 = 3.3.5 =
323
324 * Fix filtered media library inserts thanks to @miraclemaker as well as @oxyc, @BjornW and innumerable others in the support forum (http://wordpress.org/support/topic/plugin-image-widget-add-image-upload-an-image-select-insert-into-widget-no-image-is-shown)
325 * Adjusted HTTPS/SSL handling so that it's only applied in the view. ( thanks @TheFluffyDoneky and @aerobrent )
326 * Added a filter for the image url: 'image_widget_image_url'
327 * Add Dutch language translation ( thank you Carsten Alsemgeest - presis.nl )
328 * Rename all language files to lowercase image_widget to match the localization string.
329
330 = 3.3.4 =
331
332 * Fix javascript bugs in the widget admin UI. ( thanks for filing this @joo-joo )
333 * Fix notices in php error log.
334 * Add widget description filter $args and $instance ( thanks @jeffreyzinn )
335 * Fixed localization and renamed key to 'image-widget'
336
337 = 3.3.3 =
338
339 * Romanian translation courtesy of Alexander Ovsov at Web Geek Science (http://webhostinggeeks.com).
340
341 = 3.3.2 =
342
343 * Remove extra esc_attr() from the $title display. (Thank you @romaspit)
344
345 = 3.3.1 =
346
347 * Add minor security updates.
348 * Update readme, thumbnails and other minor descriptors.
349
350 = 3.3 =
351
352 * Fix to allow the widget to work in the non-async (browser) uploader. Props Bjorn Wijers
353
354 = 3.2.11 =
355
356 * Yet another minor JS fix to hopefully address issues of lightbox not working
357
358 = 3.2.10 =
359
360 * Fix JS typo.
361
362 = 3.2.9 =
363
364 * Minor JS fix to hopefully address issues of lightbox not working
365 * Use new the new [jQuery.fn.on](http://api.jquery.com/on/) method for forward compatibility.
366
367 = 3.2.8 =
368
369 * Minor bugfix courtesy of Takayuki Miyauchi (@miya0001)
370 * Polish translation courtesy of Łukasz Kliś
371
372 = 3.2.7 =
373
374 * Update javascript to work with the new version of WordPress (thanks Matt Wiebe!!! @mattwiebe)
375 * Added Japanese translation courtesy of Takayuki Miyauchi (@miya0001)
376
377 = 3.2.6 =
378
379 * Add HTTPS support courtesy of David Paul Ellenwood (DPE@SGS)
380
381 = 3.2.5 =
382
383 * Added Swedish translation courtesy of Tomas Lindhoff (@Tomas)
384
385 = 3.2.4 =
386
387 * Added javascript conflict prevention code thanks to @rcain.
388
389 = 3.2.3 =
390
391 * Added French translation courtesy of Dominique Corbex (@Domcox)
392
393 = 3.2.2 =
394
395 * Added Portuguese translation courtesy of Gustavo Machado
396
397 = 3.2.1 =
398
399 * Fix image widget public declaration bug.
400
401 = 3.2 =
402
403 * Abstract views for widget output and widget admin.
404 * Support theme override of the widget output! Now you can layout the widget however you'd like.
405 * Added filter to override template call.
406
407 = 3.1.6 =
408
409 * Fixed Wordpress 3.0 bugs. (Thanks @kenvunz)
410
411 = 3.1.5 =
412
413 Fixed PHP 5 bug. Removed 'public' declaration. http://wordpress.org/support/topic/362167 Thanks @mpwalsh8, @jleuze, @PoLaR5, @NancyA and @phoney36
414
415 = 3.1.4 =
416
417 * Added support for ALT tags. If no alt tag is entered the title is used.
418
419 = 3.1.3 =
420
421 * Added German language support (Thank you Rüdiger Weiß!!!)
422
423 = 3.1.2 =
424
425 * Fix bug: XHTML Compliance (thanks HGU for offering a patch and thanks @webmasterlistingarts for filing the bug)
426 * Replaced `<p>` with `<div>` in description to also improve XHTML compliance.
427
428 = 3.1.1 =
429
430 * Fix bug: php4 reported error: PHP Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' (thanks @natashaelaine and @massimopaolini)
431
432 = 3.0.10 =
433
434 * Fix bug: improve tab filters.
435
436 = 3.0.9 =
437
438 * Fix bug: update tabs filter to not kill tabs if upload window is for non widget uses.
439
440 = 3.0.8 =
441
442 * Remove the "From URL" tab since it isn't supported.
443 * Replace "Insert into Post" with "Insert into Widget" in thickbox.
444
445 = 3.0.7 =
446
447 * Fix Dean's Fcuk editor conflict. (Thanks for the report Laurie @L_T_G)
448 * Fix IE8 bug (Remove extra comma from line 66 of js - thanks for the report @reface)
449 * Update functions and enqueued scripts to only trigger on widget page.
450
451 = 3.0.6 =
452
453 * Fix crash on insert into post.
454
455 = 3.0.5 =
456
457 Thank you @smurkas, @squigie and @laurie!!! Special thanks to Cameron Clark from http://prolifique.com a.k.a @capnhairdo for contributing invaluable javascript debugging skills and throwing together some great code.
458
459 * PHP4 compatibility
460 * Tighter integration with the thickbok uploader attributes including caption, description, alignment, and link
461 * Tighter image resize preview
462 * Add Image link becomes "Change Image" once image has been added
463
464 = 3.0.4 =
465
466 * Minor description changes
467
468 = 3.0.3 =
469
470 * Fixed the broken "Add Image" link (THANK YOU @SMURKAS!!!)
471
472 = 3.0.2 =
473
474 * Added PHPDoc comments
475 * Temporarily fixed install bug where no image is saved if resize is not working. (thank you Paul Kaiser from Champaign, Il for your helpful QA support)
476
477 = 3.0.1 =
478
479 * Added 'sp_image_widget' domain for language support.
480
481 = 3.0 =
482
483 * Completely remodeled the plugin to use the native WordPress uploader and be compatible with Wordpress 2.8 plugin architecture.
484 * Removed externalized widget admin.
485
486 = 2.2.2 =
487
488 * Update <li> to be $before_widget and $after_widget (Thanks again to Lois Turley)
489
490 = 2.2.1 =
491
492 * Update `<div>` to be `<li>` (Thanks to Lois Turley)
493
494 = 2.2 =
495
496 * Fixed missing DIV close tag (Thank you Jesper Goos)
497 * Updated all short tags to proper php tags (Thank you Jonathan Volks from Mannix Marketing)
498
499 = 2.1 =
500
501 * Link Target
502
503 = 2.0 =
504
505 * Multi widget support
506 * WP 2.7.1 Compatibility
507 * Class encapsulation
508
509 == Upgrade Notice ==
510
511 = 4.0 =
512
513 Please be advised that this is a significant upgrade. You should definitely back up your database before updating in case your existing image widgets have any problems.
514
515 Also, several languages will no longer be supported until new translations are submitted. Currently, we have support for Italian, Dutch, and Swedish. If you would like to contribute your own language files, please post links here:
516
517 http://wordpress.org/support/topic/image-widget-40-translations-needed-2
518
519