Formats all content images on a page / post giving them borders and captions.
Image Formatr is a simple plugin that goes through all the content images on
posts & pages, and with zero user changes:
- gives them a standardized thumbnail format using CSS
- puts a caption underneath each one using the title
- 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
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
library
- Outputs standard XHTML compliant markup
Screenshots
Image Formatr administration screen
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.
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 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