Title: Image Formatr
Author: huntermaster
Published: <strong>January 5, 2010</strong>
Last modified: December 13, 2015

---

Search plugins

![](https://ps.w.org/image-formatr/assets/banner-772x250.jpg?rev=696371)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/image-formatr_29ab8f.svg)

# Image Formatr

 By [huntermaster](https://profiles.wordpress.org/huntermaster/)

[Download](https://downloads.wordpress.org/plugin/image-formatr.1.2.6.zip)

 * [Details](https://pcd.wordpress.org/plugins/image-formatr/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/image-formatr/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/image-formatr/#installation)
 * [Development](https://pcd.wordpress.org/plugins/image-formatr/#developers)

 [Support](https://wordpress.org/support/plugin/image-formatr/)

## Description

Image Formatr is a simple plugin that goes through all the content images on
 posts&
pages, and with zero user changes:

 1. gives them a standardized thumbnail format using CSS
 2. puts a caption underneath each one using the title
 3. makes them linked so they popup in full size

Thumbnails are not generated, but will be used if available in the media library.

This plugin is driven by the [prettyPhoto](http://www.no-margin-for-errors.com/projects/prettyPhoto/)
library so we could call this plugin a prettyPhoto integration plugin.

*Note: Supports images on **Flickr**.

#### Usage

_This only applies to the images you put in your content, not theme graphics._

    ```
    <img
      src="/images/picture.jpg"
      class="alignright"
      title="A sample caption"
      link="http://example.com/"
      hint="Image borrowed from example.com"
    />
    ```

After the plugin runs, the output to the browser looks like:

    ```
    <div class="img alignright">
      <a
        href="/images/picture.jpg"
        rel="prettyPhoto[main]">
        <img
          src="/images/picture.jpg"
          title="Image borrowed from example.com" alt=""
          width="140" height="90"/>
      </a>
      <div style="width: 100%;">
        <a href="http://example.com/" target="_blank">A sample caption</a>
      </div>
    </div>
    ```

#### Documentation

You can find plugin documentation at http://warriorself.com/blog/about/image-formatr/

#### Features

 * Standardizes all thumbnails without altering posts
 * Supports displaying images from Flickr: <img flickr=”1234567890″
    title=”The 
   magnificent Ceiba at the Archaeological Site of Palenque.”>
 * Generates image captions using the image `title` or `alt`
 * Integrates WordPress media library thumbnails
 * Gives popups for WordPress gallery images (adjust priority setting to 12)
 * Shows all content images on the blog as small thumbnails
    (does not create new
   thumbnails but can use Media Library for thumbs)
 * Allows for fine-grained control of each image’s format
 * Zooms image to large size when clicked using the
    [prettyPhoto](http://www.no-margin-for-errors.com/projects/prettyPhoto/)
   library
 * Outputs standard XHTML compliant markup

### Gallery Support

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](https://pcd.wordpress.org/plugins/image-formatr/sroth77@gmail.com?output_format=md)
and
 licensed under a GPL license.

Based on: [image-caption](https://wordpress.org/extend/plugins/image-caption/)
 
by [Yaosan Yeo](http://www.channel-ai.com/blog/).

PrettyPhoto: The JavaScript
 [Image thumbnail viewer](http://www.no-margin-for-errors.com/projects/prettyPhoto/)
library by Stephane Caron is licensed under GPLv2.

### Website

More information, including how to contact me, is available at
 [warriorself.com](http://warriorself.com/blog/about/image-formatr/).

### Translations

 * If you would like to contribute a translation of the administration settings
   
   screen please have a look at the [.pot](https://plugins.svn.wordpress.org/image-formatr/trunk/languages/image-formatr.pot)
   file and post to the [support forum](https://wordpress.org/support/plugin/image-formatr)
   of [e-mail to me](https://pcd.wordpress.org/plugins/image-formatr/sroth77@gmail.com?output_format=md).

### 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

## Screenshots

 * [[
 * Image Formatr administration screen

## Installation

Installation:

 1. Download and extract the plugin to your computer
 2. Extract the files keeping the directory structure in tact
 3. Upload the extracted directory (image-formatr) to your WordPress plugin
     directory(
    wp-content/plugins)
 4. Activate the plugin through the _Plugins_ menu in WordPress admin

## FAQ

1.) _WordPress “smiley” emoticons like `:)` keep showing up with the other
 images.
How can I prevent smileys from being effected?

Starting with version 0.9.6 this plugin includes a _class exclusion list_ which

prevents an image from being processed by the plugin if it contains a CSS class 
that is in the list. WordPress uses “wp-smiley” for their smileys so enter wp-smiley
into the exclusion classes in the WordPress administration settings for Image-formatr
then click “Update Options”.

2.) _These image attributes (e.g. page, nocap, link, etc) are not XHTML
 standard
attributes. Why do you use them?

The Image Formatr _override_ attributes do not get written to the browser.
 They
are only used by the plugin for format configuration of individual images. Unless
you specify the `asis` attribute, all images in your content are deconstructed then
rebuilt sending only XHTML compliant markup to the client.

## Reviews

![](https://secure.gravatar.com/avatar/987a9a8f0a8d2c188a2865d0e0908faed64d068786dba8834043c15d7b387100?
s=60&d=retro&r=g)

### 󠀁[This plugin rocks!](https://wordpress.org/support/topic/this-plugin-rocks-55/)󠁿

 [quadeg](https://profiles.wordpress.org/quadeg/) March 30, 2022

Thanks a lot for sharing this, I lost 2+ hours ten days ago looking for a plugin
that does exactly what this plugin does and I couldn’t find any. I found it today
by chance, when searching for a plugin to manage the captions of my website’s images.
Hint to the Developer: maybe you should refine the plugin’s description so others
in the situation I was ten days ago will be able to find it. The keyword I used 
last week, that was of no use, was “force dimensions for all images”, and “force
image dimensions on the fly”. I was desperate, after two years having problems with
my website’s images. Where the mess of different sizes was more evident was when
I created views with the Content Views plugin and both the sliders and the grids
were malformed due to the different sizes of the thumbnails. My advice for others
looking for a way to make the sizes of their site’s images in a Wordpress site consistent/
uniform in size is this: 1) Don’t use Wordress media sizes in Settings > Media Settings
because A) It wastes too much space on the server and B) It degrades the images 
when it converts it to different sizes. Just enter 0 in every size field, and deactivate
the “Crop thumbnail to exact dimensions (normally thumbnails are proportional)” 
option. Only leave the “Organize my uploads into month and year-based folders” option
enabled, if you think it makes sense to you (it makes sense to me, so I keep this
enabled). 2) Don’t ever use a media cleaning plugin, or a regenerate thumbnails 
plugin. This will not solve your problems of having images with different sizes 
in the front end, and it has a high potential of deleting a lot of images that I
shouldn’t delete, and you will lose a lot of time restoring the images it deleted
to the post and pages it effaced. I lost the whole Saturday night ten days ago to
fix the mess that both the “Force Regenerate Thumbnails” and “Media Cleaner” plugins
did to my website. I was lucky, though, since they deleted only ~30-40 images in
a website with ~600 images and photos. 3) Install this plugin, because it does exactly
what you are looking for. PS: to the developer, I think one feature that would make
this plugin a killer app 100% (as of now is 95% of a killer app for me) is if you
add an option to use the image description meta (the description that appears in
the attachment page) as caption. Like I said, my website has around 600 images and
both the alt and the title metas I configured are not really fit to work as thumbnails,
but the description is. I will look for a plugin that copies the description to 
the alt field to add captions with your plugin, if I can’t find it I guess I will
use the nocaption option until either you add the option or I get around I spending
3-4 hours coping the description text to the alt text. Anyway, thanks a lot again,
and sorry if this was a long review.

 [ Read all 3 reviews ](https://wordpress.org/support/plugin/image-formatr/reviews/)

## Contributors & Developers

“Image Formatr” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ huntermaster ](https://profiles.wordpress.org/huntermaster/)

“Image Formatr” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/image-formatr/contributors)
for their contributions.

[Translate “Image Formatr” into your language.](https://translate.wordpress.org/projects/wp-plugins/image-formatr)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/image-formatr/), check
out the [SVN repository](https://plugins.svn.wordpress.org/image-formatr/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/image-formatr/) 
by [RSS](https://plugins.trac.wordpress.org/log/image-formatr/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.2.6

 * 2015-12-13 Flickr https API
 * Fix Flickr API calls to use https instead of http

#### 1.2.5

 * 2014-07-02 Standardize-thumbnails patch
 * Fix Standardize-thumbnail setting, redeux

#### 1.2.4

 * 2014-07-01 Internationalization
 * Add Serbian translation of admin screen
 * Fix Standardize-thumbnail setting
 * Add license file & info

#### 1.2.3

 * 2014-05-20 PrettyPhoto settings admin
 * Fix priority default when upgrading from previous version
 * Fix PHP notice when not using captions
 * Add admin options for PrettyPhoto: social buttons, theme, speed
 * Add admin option validation for priority setting
 * Changed admin styling to use retina icons
 * Changed prettyPhoto social buttons option logic, simplified
 * Changed default prettyPhoto popup theme

#### 1.2.2

 * 2014-05-14 Plugin priority patch
 * Add admin option to adjust the plugin execution order, no longer hard-coded
 * Fix activation warning, default options-collection to array
 * Fix Media Library thumbnail display

#### 1.2.1

 * 2014-05-11 WordPress Gallery support
 * Add [gallery] shortcode support, looks for “attachment-thumbnail” class
 * Add settings link in Admin plugins list
 * Change plugin priority from 10 to 12
 * Remove explicit support for BBcode (popups still work)

#### 1.1

 * 2013-04-12 Media library image thumbnail support
 * Add admin option to enable using media library auto-generated images as
    thumbnails

#### 1.0.1

 * 2013-03-25 Dynamic filter loading removal patch
 * reverse moving _add\_filter_ from _image-formatr_ to _class.formatr_
 * remove admin option to toggle processing of page/post content
 * remove admin option to toggle processing of WP Text Widget content
 * remove usage of _output buffering_ to build the image div
 * fix _Caption attribute_ drop-down to properly show the option value
 * move _activate/deactivate_ callbacks from class.admin to class.base

#### 1.0

 * 2013-03-24 Admin UI layout with info popups
 * redo Admin with a better UI using settings information popups
 * add admin option for name to use for default prettyPhoto slideshow group
 * add admin option to toggle processing of page/post content
 * add admin option to toggle processing of WP Text Widget content
 * fix Flickr loop bug if we could not open the image url

#### 0.10.1

 * 2012-12-12 Remove asis attribute and add caption css class
 * Remove the asis attribute if provided
 * add php5 constructor, move old constructor to base
 * add admin option to add css-class to caption div
 * simplify width styling

#### 0.10.0

 * 2012-11-25 Add Flickr support and remove Highslide library
 * The Highslide JavaScript image viewer library had a license that was not
    compatible
   so it was replaced with the PrettyPhoto library
 * Flickr image support with [flickr pid=”123″] or
 * Flickr set support with [flickrset id=”123″]
 * Note: [flickrset id=”123″] usage is deprecated and will become [flickr
    set=”
   123″] next release

#### 0.9.7.5

 * 2011-11-03 BBCode [img] support
 * Added: support for [img]http://mydomain.com/image.jpg[/img]
 * Added: CSS image class modification options

#### 0.9.7.4

 * 2011-07-17 Small images not up-sized
 * Changed css style width to max-width

#### 0.9.7.3

 * 2011-06-12 Internet Explorer patch
 * Fixed: JavaScript obect trailing comma removed from hs.addSlideshow() call
 * Added: Highslide library disable option if you already use Highslide
 * Changed: Auto determine orientation admin setting now defaults to off

#### 0.9.7

 * 2011-03-21 Administration upgrade version
 * Fixed: style-sheet displayed correctly allowing height attribute without width
 * Fixed: trailing slash on image tag no longer required <img/>
 * Fixed: admin options for thumbnail dimensions UI bug
 * Fixed: image aspect ratio now correctly calculated
 * Added: ‘thumb’ attribute to show a thumbnail image
 * Added: ‘page’ attribute to allow for image to be excluded from certain pages
 * Added: uninstall plugin option which can clean Image Formatr out of the database
 * Changed: home page image dimensions expanded to include single page, etc.
 * Changed: admin options to serialize all settings into one table row
 * Changed: class getting kinda big so I split it up into three classes
 * Changed: admin screen updated to current WordPress API standards
 * Removed: admin html include file no longer needed with new API

#### 0.9.6

 * 2011-02-13 Smiley exclusion patch
 * Added: Exclude image style class list which prevents smileys from being included
 * Added: import Highslide Integration plugin settings upon Image Formatr activation
 * Added: forgot to include graphics directory in 0.9.5 release

#### 0.9.5

 * 2011-01-18 Highslide integrated directly into Image-formatr plugin
 * Added: Admin option for the mouse-over hint “Click here to enlarge”
 * Added: Admin option to use different image dimensions on the home page
 * Added: Admin option for Highslide settings
 * Added: restrict image url protocols to http, https, ftp, file
 * Added: “Group” image attribute can separate Highslide popup slideshows
 * Added: Highslide JavaScript library w/gallery (highslide.js) 4.1.9 (2010-07-05)
 * Removed: Highslide Integration plugin requirement
 * Changed: “Strip title” admin option now actually strips the title
 * Changed: “Hint” image attribute gets displayed differently

#### 0.9.4

 * 2011-01-13 Class structure used and performance increased
 * Added: Class structure encapsulation
 * Added: Admin setting to disable image inspection (speed increase)
 * Changed: Admin setting “Thumbnail dimensions” to allow zero,
    which then calculates
   based on aspect ratio
 * Removed: PHP-GD library call and Snoopy call (speed increase)

#### 0.9.3

 * 2011-01-13 Bugfix patch
 * Changed: admin settings bug fixes

#### 0.9.2

 * 2010-04-16 Smiley/emoticon displayed
 * Changed: Smileys like 🙂 were causing errors so I added a check to make
    sure
   we are not effecting emoticon graphics within the post. Now smileys display fine,
   thanks to http://blog.andrewkinabrew.com/

#### 0.9.1

 * 2010-03-9 Standard thumbnail dimensions
 * Changed: Allow for zero length long or short thumbnail dimension in the
    administration
   settings

#### 0.9

 * 2010-01-26 Initial beta release
 * Renamed the `usemyanchor` image modifier attribute to `usemya` with no
    deprecated
   support for the old one
 * Fixed: caption administration setting not working
 * Added: force-root image location mangler administration setting
 * Added: administration setting to standardize all thumbnail sizes
 * Added: `usemysize` attribute to allow for individual image sizing
 * Changed: no longer supports MyCSS plugin

#### 0.8

 * 2010-01-5 Initial alpha release

## Meta

 *  Version **1.2.6**
 *  Last updated **10 years ago**
 *  Active installations **40+**
 *  WordPress version ** 2.9 or higher **
 *  Tested up to **4.4.34**
 *  Languages
 * [English (US)](https://wordpress.org/plugins/image-formatr/) and [Serbian](https://sr.wordpress.org/plugins/image-formatr/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/image-formatr)
 * Tags
 * [caption](https://pcd.wordpress.org/plugins/tags/caption/)[flickr](https://pcd.wordpress.org/plugins/tags/flickr/)
   [formatting](https://pcd.wordpress.org/plugins/tags/formatting/)[images](https://pcd.wordpress.org/plugins/tags/images/)
   [post](https://pcd.wordpress.org/plugins/tags/post/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/image-formatr/advanced/)

## Ratings

 4 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/image-formatr/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/image-formatr/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/image-formatr/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/image-formatr/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/image-formatr/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/image-formatr/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/image-formatr/reviews/)

## Contributors

 *   [ huntermaster ](https://profiles.wordpress.org/huntermaster/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/image-formatr/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=sroth77@gmail.com&item_name=Image+Formatr+Wordpress+plugin)