PhotoMosaic for WordPress

PhotoMosaic for WordPress

PhotoMosaic adds an option to Wordpress’ Create Gallery flow that allows you to select “PhotoMosaic” as your gallery’s theme. Your Wordpress Gallery is then transformed into a visually-striking design piece by giving it a fresh masonry layout worthy of your favorite design blog.


  • Works with WordPress’ native gallery system. Simply select “PhotoMosaic” from the template field when you create your gallery
  • Galleries can be made from a list of images, images attached to a post/page, and categories and tags in any taxonomy (default and custom)
  • Plugin Options Page to easily configure all of your PhotoMosaic galleries
  • Supports inline shortcode params (eg: [photomosaic width=”500” height=”300”])
  • Template Tag support (eg: <?php wp_photomosaic() ?>)
  • Widget support
  • Fully Responsive
  • Masonry Layout
  • Customizable columns, width, padding, and more!
  • Supports Lazy Loading
  • Uses all of your WordPress image renditions to choose the best image for the mosaic layout
  • Have images link to a URL (with option to open that URL in a new window/tab), open a larger version of the image in a Lightbox, or don’t make them links at all.
  • CSS3 loading animations
  • Works with your favorite Lightbox plugin (or use the packaged PrettyPhoto)
  • Includes code areas for Custom CSS and an onReady Callback
  • Uses the default WordPress gallery for tried and true SEO
  • Gracefully degrades to the standard WordPress gallery in old (feature poor) browsers or if a user doesn’t have Javascript enabled

v2.12.3 (April 30th, 2015)

  • Enhancement : Randomized mosaics now have a less jagged bottom edge (when ‘Prevent Cropping’ is turned on)
  • Bug Fix : corrects a regression that caused the wp_photomosaic() template tag to fail
  • Bug Fix : corrects a regression that caused “category” mosaics not to link to posts

v2.12.2 (April 28th, 2015)

  • Bug Fix : corrects custom lightbox regression introduced in 2.12 commit
  • Bug Fix : adds logic check to suppress “array_diff_key” warning

v2.12.1 (April 23rd, 2015)

  • Bug Fix : adds deprecation adjustment for “onready_callback” changes

v2.12 (April 21st, 2015)

  • Enhancement : adds Lightbox Bridge capacity and 4 lightbox bridges
  • Enhancement : JS not loads in page footer
  • Enhancement : adds “Minimum Column Width” setting
  • Enhancement : adds support for Media Library categories/tags when using “category” to filter a taxonomy
  • Bug Fix : inline CSS is now only included once per page
  • Bug Fix : corrects bug that caused loading spinners to disappear prematurely in certain conditions

v2.11 (March 2nd, 2015)

  • Breaking Change : (could break custom CSS) prefixes ’.loading’ and ’.loaded’ classes with ‘photomosaic-’ to prevent collisions.
  • Breaking Change : (could break custom CSS) separates the image and the loading-spinner into unique containers
  • Enhancement : moves from absolute positioning to translations (performance improvements)
  • Enhancement : old (feature poor) browsers (e.g. IE 8 & Safari 5.5) now fallback to the default WP or NextGen gallery
  • Enhancement : “width” and “height” now accept %
  • Enhancement : “category” mosaics now use post_title as the caption
  • Enhancement : updates React 0.11.2 >>> 0.12.2
  • Bulletproofing : css bulletproofing to prevent problems caused by themes with crazy-specific selectors
  • Bulletproofing : prevents array_count_values from getting an empty array because of plugins that nuke image metadata
  • Bug Fix : escaped characters no longer appear in the Gallery Settings select inputs
  • Bug Fix : corrects a bug that threw an error when the number of images was less than the number of hardcoded columns
  • Bug Fix : corrects a regressions that broke automatic Jetpack support
  • Bug Fix : removes a debug statement

v2.10 (October 8th, 2014)

  • Enhancement : ‘Columns’ now accepts a range (for responsive min/max values)
  • Enhancement : adds option to set which image size opens in the lightbox
  • Enhancement : adds 2 new layouts (‘Rows’ and ‘Grid’) (currently in alpha) (only available as inline attributes)
  • Bug Fix : corrects an error that caused “category” to throw an error when “limit” was omitted
  • Bug Fix : corrected a bug that prevented multiple “category” shortcodes from appearing on the same page

v2.9.1 (September 21st, 2014)

  • Enhancement : adds support for HTML in captions

v2.9 (September 17th, 2014)

  • Enhancement : “category” now accepts taxonomic prefixes
  • Enhancement : adds “Custom CSS” and “onReady Callback” buckets
  • Enhancement : adds unique class to each mosaic (for easier CSS targeting)
  • Enhancement : reduced file size by 50%
  • Change : makes the loading spinner an element (allows more styling options)

v2.8.5 (September 3rd, 2014)

  • Bug Fix : refines transform settings (large galleries should see drastic performance improvements on mobile)

v2.8.4 (August 28th, 2014)

  • Bug Fix : corrects a bug that caused lazyloading to load images prematurely

v2.8.3 (August 27th, 2014)

  • Enhancement : “category” now accepts multiple slugs (separated by commas)
  • Bug Fix : corrects the Chrome (Win) scroll/flicker issue

v2.8.2 (July 17th, 2014)

  • Bug Fix : corrects regression that prevented captions from appearing on the page
  • Bug Fix : Lazyloading now targets the bottom of the viewport when set to ‘0’

v2.8.1 (July 15th, 2014)

  • Enhancement : “Group Images” now includes better deeplinking support

v2.8 (July 13th, 2014)

  • Bug Fix : corrects $—> jQuery that broken Jetpack Carousel support
  • Bug Fix : loading spinner is no longer visible after the image has loaded
  • Bug Fix : corrects the bug that caused large galleries to, randomly, fail to render
  • Enhancement : events are now debounced
  • Enhancement : moves from static HTML manipulation to ReactJS
  • Enhancement : updates Moderizr 2.6.2 >>> 2.8.3
  • Change : removes JSTween dependency
  • Change : removes Mustache dependency
  • Change : ‘Responsive Transition’ has been renamed to ‘Resize Transition’ for clarity

v2.7.5 (June 7th, 2014)

  • Enhancement : increased the amount of the viewport the default lightbox (PrettyPhoto) uses
  • Bug Fix : corrects the bug that prevented items that should line up in a perfect grid from doing so
  • Bug Fix : corrects the bug that allowed mosaics to be placed incorrectly

v2.7.4 (May 15th, 2014)

  • Enhancement: updates WaypointsJS to v2.0.5
  • Bug Fix : prevents conflicts with other versions of WaypointsJS

v2.7.3 (April 25th, 2014)

  • Enhancement: progressive enhancement now only progressively enhances when necessary (prevents FOUC in older browsers)

v2.7.2 (April 24th, 2014)

  • Bug Fix: prevents IE’s that “support” the console from incorrectly stating that they don’t

v2.7.1 (April 16th, 2014)

  • Enhancement: adds ability to skip lazyloading

v2.7 (April 13th, 2014)

  • Enhancement: adds ability to make a mosaic from all recent posts
  • Enhancement: adds ability to make a mosaic from recent posts from a category
  • Enhancement: mosaic images are now lazyloaded by default

v2.6.4 (March 22nd, 2014)

  • Bug Fix: corrects a bug that caused apostrophes to be improperly escaped

v2.6.3 (March 13th, 2014)

  • Bug Fix: corrects a bug that caused PrettyPhoto to fail to load in certain server environments

v2.6.2 (March 8th, 2014)

  • Bug Fix: corrects a regression that caused images without dimension data to fail to load

v2.6.1 (March 7th, 2014)

  • Change: uses jQuery.Migrate.sub() to create an isolated jQuery instance (JQPM)
  • Bug Fix: corrects filename capitalization

v2.6 (March 6th, 2014)

  • Enhancement: minified JS is now 60% smaller
  • Enhancement: falls back to the default [gallery] layout for users with JS turned off or for pages with JS errors
  • Enhancement: updates ImagesLoaded to v3.1.4
  • Change: updates admin icon to the new WP3.8 style
  • Bug Fix: corrects the check that looks for a preexisting ‘theme’ select
  • Bug Fix: corrects ‘addPreloadData’ regression introduced in the last release

v2.5.3 (March 4th, 2014)

  • Enhancement: adds the ability to be updated through the Wordpress Admin
  • Change: switches to the jQuery included with Wordpress (no longer supports WP older than v3.3)

v2.5.2 (March 1st, 2014)

  • Bug Fix: cleans up some leaking JS vars
  • Bug Fix: NextGen mosaics no longer uses thumbnails when they shouldn’t
  • Bug Fix: removes politeness check that sometimes prevented [gallery theme=”photomosaic”] shortcodes from being mosaic’d

v2.5.1 (October 13th, 2013)

  • Update: changes run-priority to support the recent Jetpack Carousel update
  • Change: ignores the ‘thumbnail’ size if it doesn’t have the same aspect ratio as the full-sized image
  • Change: protects references to the native Date object in case it has been modified by MooTools
  • Deleted: removes PHP Output Buffer as it is no longer needed

v2.5 (September 27th, 2013)

  • Deleted: removed ‘Image Links’ setting (now part of ‘Link Behavior’) (shortcodes using “links” will continue to work)
  • Deleted: removed ‘Link to URL’ setting (now part of ‘Link Behavior’) (shortcodes using “link_to_url” will continue to work)
  • Enhancement: adds “Link Behavior” setting
  • Enhancement: adds ability to link to WP Image Attachment Page

v2.4.9 (September 21h, 2013)

  • Bug Fix: corrects a regression that caused images to fail to appear in certain conditions

v2.4.8 (September 20th, 2013)

  • Enhancement: improves animation support for older browsers
  • Bug Fix: guards against multiple instances of Modernizr introducing whitespace bugs in classnames
  • Change: adopts Wordpress’ prefered method for checking the post_content to see if other post_gallery filters have already been applied

v2.4.7 (August 29th, 2013)

  • Bug Fix: the image loading animation wasn’t being shown in some cases if images’s weren’t links

v2.4.6 (August 20th, 2013)

  • Bug Fix: corrects issue that caused PhotoMosaic to break some other [gallery] plugins

v2.4.5 (August 19th, 2013)

  • Bug Fix: ‘Theme’ option wasn’t appearing on New Post/Page pages (appears to be because of a change in WPv3.6)
  • Bug Fix: accounts for the odd situation when Jetpack’s markup isn’t properly escaped
  • FAQ: updates ‘Why are my images stretched and distorted?’

v2.4.4 (August 13th, 2013)

  • Enhancement: improved logic for selecting and hot-swapping NextGen thumbnails
  • Enhancement: default PrettyPhoto has PhotoMosaic-specific event namespacing (should prevent event conflicts with non-PM PrettyPhoto plugins)
  • FAQ: Why are my images stretched and distorted?
  • Bug Fix: ‘Theme’ option wasn’t displaying in certain browsers

v2.4.3 (July 26th, 2013)

  • Enhancement: image size picking is now done on a per-image basis instead of globally for all images
  • Enhancement: improved detection of image arrival and animation ending: loading spinners don’t disappear until after the image loading animation has completed
  • Bug Fix: corrects blank admin tabs: checks server settings and uses appropriate file-loading method

v2.4.2 (July 16th, 2013)

  • Bug Fix: corrects the issue that caused errors when deleting posts and when activating the plugin
  • Bug Fix: prevents Kriesi’s Avia framework from overwriting PM’s image position
  • Bug Fix: corrects AutoCols logic that caused (#imgs < #cols) to not fill the specified width
  • Change: preloaded image matching is now based on the unique ID (rather than URL)

v2.4.1 (July 9th, 2013)

  • Enhancement: Adds support for Jetpack :: Carousel
  • Change: Renames “Template” gallery setting to “Theme” (shortcodes using “template” will continue to work)
  • Bug Fix: Renames Markdown files from .md to .txt to prevent IIS mime type blocking
  • Bug Fix: Corrects behavior that caused disabling “Image Links” to also disable “Image Loading Transition”

v2.4 (June 18th, 2013)

  • Enhancement: now supports [gallery] shortcode with photomosaic attribute
    [gallery photomosaic="true"]
  • Enhancement: now supports [gallery] shortcode with template attribute
    [gallery template="photomosaic"]
  • Enhancement: PhotoMosaic can now be selected during the Create Gallery flow - Create Gallery -> template

v2.3.8 (June 16th, 2013)

  • Bug Fix: corrects edge-case Auto-column math glitch

v2.3.7 (June 10th, 2013)

  • Bug Fix: PrettyPhoto: all global jQuery references now point to the scoped reference

v2.3.6 (June 9th, 2013)

  • Enhancement: now supports NextGen Albums with ngaid attribute
    [photomosaic ngaid="1"]

v2.3.5 (June 2nd, 2013)

  • Bug Fix: images that 404 get removed from the mosaic

v2.3.4 (May 26th, 2013)

  • Enhancement: NextGen: “Link to URL” no longer cares which field contains a URL and which a caption
  • Bug Fix: corrects regression introduced in v2.3.3 – responsive stopped working

v2.3.3 (May 25th, 2013)

  • Enhancement: WP image “Alt Text” conveys to IMG ‘alt’ attribute
  • Enhancement: JS has been concatenated in order to load fewer files

v2.3.2 (May 6nd, 2013)

  • Bug Fix: WP was injecting paragraph tags into some users gallery info

v2.3.1 (May 2nd, 2013)

  • Bug Fix: caption are no longer removed when opening non-image content in the lightbox
  • Bug Fix: lightbox-gallery order now matches input-gallery order regardless of layout-order
  • Bug Fix: not all mosaics on a page were being actively responsive
  • Bug Fix: shortcode wasn’t honoring inline “lightbox” and “custom_lightbox” settings

v2.3 (April 16th, 2013)

  • New “Prevent Crop” setting (much requested)
  • New lightbox settings and docs to make integration easier
  • Updates core JS and PrettyPhoto to work with jQuery 1.9.1
  • Fixed NextGen bug that caused “Link to URL” urls to appear as the caption
  • and a bunch of smaller tweaks and improvements