Plugin info

Total downloads: 9,546
Active installs: 700
Total reviews: 10
Average rating: 4.9
Support threads opened: 0
Support threads resolved: 0 (0%)
Available in: 1 language(s)
Contributors: 2
Last updated: 4/23/2025 (252 days ago)
Added to WordPress: 11/30/2018 (7 years old)
Minimum WordPress version: 4.1
Tested up to WordPress version: 6.8.3
Minimum PHP version: 7.0

Maintenance & Compatibility

Maintenance score

Stale • Last updated 252 days ago • 10 reviews

42/100

Is WP ImageViewer abandoned?

Likely maintained (last update 252 days ago).

Compatibility

Requires WordPress: 4.1
Tested up to: 6.8.3
Requires PHP: 7.0

Similar & Alternatives

Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.

No similar plugins found yet.

Description

ImageViewer is an image viewer inspired by Google Photo’s.
It may also look familiar to users of Ebay.com or Tweakers.net.

It provides a modal for images, similar to modals as lightbox, colorbox and fancybox, just in a somewhat more abstract way.

Features

  • Smooth dragging and panning images.
  • Support touch devices.
  • Double tap to zoom in/zoom out.
  • Pinch in / pinch out to zoom in/out.
  • Snap view for easier panning and zooming experience.
  • Exposed API to control zoom programmatically.

Anti-Features

  • Clean user interface, no bells, no whistles, no horns.
  • Lightweight code (no PHP, 2 JS files and 1 CSS file).
  • No settings page (really).
  • No database queries.

Upstream Project

You can look at Github for the original code.
This project is integrated in this WordPress plugin and all ready to use.

Compatibility

This plugin is compatible with ClassicPress.

Contributions

This plugin is also available in Codeberg.

Installation

Installation

  • Install the plugin through the admin page “Plugins”.
  • Alternatively, unpack and upload the contents of the zipfile to your ‘/wp-content/plugins/’ directory.
  • Activate the plugin through the ‘Plugins’ menu in WordPress.
  • That’s it.

It should just work on the standard WordPress gallery and images.

Frequently Asked Questions

I have an image, but when I click nothing happens

This plugin expects the same html layout as lightbox, colorbox and fancybox. The image/thumbnail should be inside a link, an a element.
That link should point to the main media image, not the attachment page or a custom link. Only when the link points to an image file, it will show the viewer,

I am using Nextgen Gallery

You can go to Gallery > Other Options > Lightbox Effect-tab and select None for the Lightbox Effect.

I would like to use custom options for the viewer

This code should help you, you can change these default values and put this PHP code in the functions.php file of your theme (preferably a child theme).

<?php
function imageviewer_custom_options() {
    ?>
    <script>
    imageviewer_custom_options = {
        zoomValue: 100,
        snapView: true,
        maxZoom: 500,
        refreshOnResize: true,
        zoomOnMouseWheel: true
    };
    </script>
    <?php
}
add_action( 'wp_footer', 'imageviewer_custom_options' );
?>

Review feed

Marcel Pol
3/10/2019

Simple and nice

Simple and nice modal plugin. It should just work on most images that provide a modal. If an image doesn't work, let me know in the support forum.

Screenshots

No screenshots available

Changelog

2.0.7

  • 2024-11-15
  • Set z-index to 10000 for Twenty Twelve theme.

2.0.6

  • 2022-10-28
  • Add callback for after showing an image.

2.0.5

  • 2021-08-12
  • Add possibility to use custom options for the viewer.

2.0.4

  • 2021-02-22
  • Fix deprecated jQuery calls with WP 5.6 and jQuery 3.5.

2.0.3

  • 2020-11-03
  • Support images which have extra ?get parameters.

2.0.2

  • 2020-10-19
  • Do not slide on touch when zoomed in.

2.0.1

  • 2020-02-21
  • Fix check for active viewer.

2.0.0

  • 2020-02-18
  • Update to upstream 2.0.0 iv-viewer.
  • Add navigation with arrow keys.
  • Only add hide-event to ‘body’ once, not for every image.
  • Only run expensive code when viewer is active.

1.2.0

  • 2019-07-12
  • Support Enter and Esc key to open or close viewer.

1.1.2

  • 2019-04-16
  • Do not swipe on multitouch.

1.1.1

  • 2019-03-29
  • Add z-index to close button.

1.1.0

  • 2019-03-11
  • Support touch events for swiping.

1.0.2

  • 2019-01-03
  • Slightly bigger navigation buttons again, should be less sticky.

1.0.1

  • 2018-12-01
  • Slightly bigger navigation buttons.
  • Add z-index to navigation.

1.0.0

  • 2018-11-30
  • Initial release.