WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Image Formatr

Formats all content images on a page / post giving them captions and popups.

To get WordPress Gallery images to popup, this plugin must run at a priority greater (later) than the [gallery] shortcode which runs at priority 11. Therefore set the priority setting to 12 in the Administration Options.

Overrides

The actions of the plugin are enabled and disabled with administration settings but can be overridden on each individual image.

  • usemysize - true/false - true = do not ignore an image width and height
  • usemya - true/false - true = do not ignore a parent anchor tag
  • nocap - true/false - true = do not create a caption
  • nofx - true/false - true = no popup effect
  • link - string url - make the caption a link to the url
  • hint - string txt - this will be the new image title
  • asis - true/false - true = don't change nuthin
  • group - string txt - separate popup slideshows
  • thumb - string url - image thumbnail (version 0.9.7)
  • page - single/!single/front/!front - page filtering (version 0.9.7)

If you want to surround an image with an anchor tag <a>, then you should add a usemya attribute within the image tag or else your anchor will be ignored and replaced. If you do not want the popup effect at all, add a nofx attribute to the image. If you do not want any caption, you can specify nocap, or just leave the title blank. And to have the plugin completely ignore an image and output the content directly from the post, use the asis attribute.

Example

<a href="http://www.example.com/">
<img
  src="/images/picture.jpg"
  title="Click to visit website"
  nocap="true"
  usemya="true"
/></a>

Note: concerning the true/false overrides, do not include "false" parameters like <img usemya="false">, i.e these overrides should only include the attributes for which you want to designate a "true" value.

Credits

Image Formatr is Copyright 2014 Steven Almeroth and licensed under a GPL license.

Based on: image-caption by Yaosan Yeo.

PrettyPhoto: The JavaScript Image thumbnail viewer library by Stephane Caron is licensed under GPLv2.

Website

More information, including how to contact me, is available at warriorself.com.

Translations

  • If you would like to contribute a translation of the administration settings screen please have a look at the .pot file and post to the support forum of e-mail to me.

ToDo List

  • add screenshot of output image with caption

Wish List

  • phone-home feature, activate/deactivate stats helper with version number
  • add admin option for html/xhtml <img/> closing tags
  • add admin option for moving title attribute to alt attribute should it overwrite an existing alt?
  • debug mode could show images not found and whatnots and profiling stats
  • change [flickrset id="1234"] to [flickr set="1234"]
  • change [flickr pid="123"] to [flickr img="123"]
  • show "the_content" ordering vis a vie wp-hooks-filters-flow.php Priority 8 : WP_Embed->run_shortcode() WP_Embed->autoembed() Priority 10 : wptexturize() convert_smilies() convert_chars() wpautop() shortcode_unautop() prepend_attachment() Priority 11 : capital_P_dangit() do_shortcode() Priority 20 : ImageFormatr->filter()

Bug List

  • bug: add_settings_field() <label for="s"> not <label for="stdthumb"> work-around is to only use unique single char id fields defined as constants

Requires: 2.9 or higher
Compatible up to: 3.9.2
Last Updated: 2014-7-2
Downloads: 13,935

Ratings

4 stars
4.9 out of 5 stars

Support

1 of 2 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,2,2 100,1,1
100,1,1
100,1,1
100,1,1
100,1,1 100,1,1 100,1,1 0,1,0
100,1,1
100,1,1
100,1,1
100,1,1
100,2,2
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1