PhotoMosaic for WordPress

PhotoMosaic for WordPress

WPMeta Score

Did you know?

Plugin Popularity 5.0
Author Activity 3.7
  • 🎖 Plugin ranks 20,851 amongst 50,000+ plugins.
  • ❤️ Other plugins from this team are not picking up well. Proceed with caution.
  • 🎂 This plugin celebrated it's 8th anniversary 1 month ago.


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.15.1 (October 10th, 2016)

  • Bug Fix : corrects a regression that prevented lightboxes from being disabled via Inline Attributes

v2.15 (September 8th, 2016)

  • Enhancement : adds the PhotoMosaic.refreshPage() hook to better support for mosaics loaded via ajax
  • Bug Fix : corrects bug that prevented resize-transitions from being turned off

v2.14.1 (August 13th, 2016)

  • Bug Fix : corrects a regression that caused the plugin to fail to load for some users

v2.14 (August 12th, 2016)

  • Bug Fix : updates dependencies to correct PHP7 error

v2.13 (September 2nd, 2015)

  • Bug Fix : corrects a bug that caused images on phones to be incorrectly sized when the page loads

v2.12.4 (July 3rd, 2015)

  • Enhancement : better support for HiDPI (a.k.a. ‘Retina’) screens
  • Enhancement : adds caching to improve page-load times

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