=== All In One Image Viewer – Zoom, Maps & Comparison  ===
Contributors: abuhayat, bplugins, tomorbplugins
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, before after slider, image gallery, photo viewer, gutenberg block
Requires at least: 6.5+
Tested up to: 7.0
Stable tag: 1.0.7
Requires PHP: 7.4
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

A Gutenberg block to display images with zoom, magnify, map, pan viewer, comparison slider, masking, transform, and more.

== Description ==

All In One Image Viewer is a powerful and feature-rich WordPress Image Viewer Plugin designed for Gutenberg. It helps you create interactive image experiences using Image Zoom, Image Magnifier, Image Map, Image Rotation, Hotspot Annotations, Image Comparison Slider, Zoom Pan Viewer, Image Overlay, Image Masking, Image Transform, Viewport Controls, and Aspect Ratio management.

Whether you run an eCommerce store, photography portfolio, real estate website, educational platform, art galleries, media website, agency, or business website, this plugin makes it easy to display images more engagingly and interactively.

**[Image Viewer](https://bplugins.com/products/image-viewer/)** | [**Pricing**](https://bplugins.com/products/image-viewer/pricing/) | **[Documentation](https://bplugins.com/docs/image-viewer)  | [**Support**](https://bplugins.com/support/)**


### Key Features – Free Version

– **Four Image Viewer Modes**: Choose from Zoom, Magnify, Map, and Rotation viewer modes to display images in the most suitable way for your content.

– **Zoom Viewer with Full Controls**:  Enable or disable Pan, Zoom, X-Axis, and Y-Axis, set Start Scale, and control Zoom Step for precise image inspection.

– **Magnify Viewer Options**: Highlight specific image areas using magnification with adjustable speed and timeout settings.

– **Interactive Image Map**: Add multiple map items on an image with full control over: Link URL, Link target, Title, Width & height, Top & left positioning, Drag & drop placement for each map item.

– **Rotation Viewer**: Rotate images smoothly with options to: Set custom width and height, Enable or disable auto-rotation, Control auto-rotate speed, Hide or show rotation controls.

– **Responsive & Touch Friendly** : Works smoothly on desktop, tablet, and mobile devices, including touch gestures.

– **Unlimited Usage**: Use the Image Viewer block unlimited times across posts and pages.

– **Theme Compatibility**: Fully compatible with all standard WordPress themes.

– **Lightweight & Performance Optimized**: Clean and optimized code ensures fast loading and smooth interaction.


###  Pro Version Features

– **8 Premium Viewer Styles**:  Choose from 8 professionally designed styles for modern and visually appealing image presentation.

– **Fully Responsive Design**:  All Pro styles are 100% responsive, optimized for desktop, tablet, and mobile devices.

– **Custom Styling Options**: Control border radius, background colors, shadows, padding, margins, and image positioning — design each viewer your way.

– **Advanced Typography Controls**: Customize font family, size, weight, line height, color, and alignment for titles, labels, and captions.

– **Zoom Pan Viewer**: Advanced zoom and pan image viewing with full control over viewer width & height, zoom in/out, drag & pan interaction, header buttons, and smooth mouse, scroll, and touch gesture support.

– **Transform Image**: Advanced image transformation with full control over viewer width & height, image rotation angle, flip direction, brightness and contrast adjustment, and one-click reset for precise visual tuning.

– **Masking**: Creative image masking with full control over mask shape, size, position, repeat behavior, and custom width & height to highlight or reveal specific areas with precision.

– **Image Comparison Slider**: Interactive before/after image comparison with full control over viewer width & height, image swap, label show/hide, label position, custom before/after texts, divider icon customization, and optional control buttons for a clear comparison experience.

– **Image Viewport**: Device-based image viewport control with separate width and height (settings for desktop, tablet, and mobile, ensuring perfectly optimized image display on every screen.

– **Multi Image Overlay**: Display multiple images in layered overlay mode with add, delete, and duplicate, individual visibility toggle, opacity control, and precise width & height settings for advanced visual composition.

– **Hotspot Annotations**: Create interactive image hotspots with add, delete, and duplicate hotspot support, precise X/Y positioning, tooltip enable/disable, ping animation toggle, footer show/hide, custom hotspot title & description, button icon, button text, URL linking with new-tab option, and full control over viewer width & height.

– **Image Aspect Ratio**: Choose predefined aspect ratios (1:1, 16:9, 4:3, 3:2, 21:9) with object-fit modes (cover, contain, fill) and custom background color control to ensure perfectly proportioned images across all layouts and devices.

### Why Choose All In One Image Viewer?

If you are looking for a complete Image Viewer Plugin for WordPress, this plugin provides multiple image interaction tools in a single Gutenberg block. All In One Image Viewer combines multiple image interaction technologies into a single Gutenberg block, allowing website owners to create engaging, responsive, and interactive image experiences without writing code.

Whether you need an Image Zoom Plugin, Image Magnifier, Interactive Image Map, Before After Image Slider, Hotspot Image Viewer, or Zoom Pan Viewer, this plugin provides everything in one solution.

### With All In One Image Viewer, you can:

✔ Create interactive Image Zoom effects

✔ Add Image Magnifier functionality

✔ Build clickable Image Maps

✔ Create Before & After Image Comparison Sliders

✔ Add Hotspot Annotations with tooltips

✔ Enable smooth Zoom and Pan interactions

✔ Rotate images interactively

✔ Create layered Multi Image Overlays

✔ Apply creative Image Masking effects

✔ Transform images with rotation and flipping

✔ Control image display using responsive Viewports

✔ Manage custom Aspect Ratios across devices

✔ Improve image engagement and user interaction

✔ Enhance WooCommerce product image presentation

✔ Display professional photography portfolios


### Why is All In One Image Viewer such a game-changer? 

* **Configure** — You can easily modify the Image Viewer plugin to suit your needs. Your work will go more quickly thanks to the Image Viewer plugin's features and simplicity of use.

* **There are eight different viewer types** — rotate, zoom, map, zoom pan viewer, viewport, comparison slider, aspect ratio, masking, multi image overlay, hotspot, and transform.

* **Customer Service** — Our staff is always available to assist you. It's easy for users to <a href="https://bplugins.com/support" target="_blank">**ask questions**</a> and get quick answers.

* **Updates** — With frequent updates, we bring the functionality and performance of the plugin up to date. Upgrading to newer versions is also easy, ensuring uninterrupted service.



###  How to use 
– First, install the All In One Image Viewer plugin.
– Add the Image viewer block from the block category called "Widgets" in the Gutenberg editor.
– You can change block settings from the right-side settings sidebar.
– Enjoy!

* For installation help, click on the Installation Tab

== External Services ==

This plugin connects to the following external services from the admin dashboard:

= bPlugins Products API =

* **Service URL:** [https://api.bplugins.com](https://api.bplugins.com)
* **Purpose:** The plugin's admin dashboard fetches product comparison data and pricing information to display relevant upgrade options and feature details.
* **Data Sent:** Only the plugin slug is transmitted; no personal or site data is collected.
* **Terms of Service:** [https://bplugins.com/terms-of-service/](https://bplugins.com/terms-of-service/)
* **Privacy Policy:** [https://bplugins.com/privacy-policy/](https://bplugins.com/privacy-policy/)

= Freemius (wp.freemius.com) =
* **Endpoint:** https://wp.freemius.com/
* **Used for:** Processing plugin opt-in consent form submissions.
* **Data sent:** Only after explicit user opt-in — user name, email, site URL, WP/PHP version, plugin version.
* **Terms of Service:** [https://freemius.com/terms/](https://freemius.com/terms/)
* **Privacy Policy:** [https://freemius.com/privacy/](https://freemius.com/privacy/)

= WordPress.org Plugins API =

* **Service URL:** [https://api.wordpress.org](https://api.wordpress.org)
* **Purpose:** The admin dashboard queries the official WordPress.org Plugins API to retrieve and display a curated list of other plugins by the same author ("Our Plugins" section).
* **Data Sent:** Plugin slugs and author name; no personal or site data is collected.
* **Terms of Service:** [https://wordpress.com/tos/](https://wordpress.com/tos/)
* **Privacy Policy:** [https://wordpress.org/about/privacy/](https://wordpress.org/about/privacy/)

== Third-Party Libraries ==
* **Source / GitHub:**  [**Bpl-Tools GitHub**](https://github.com/bPlugins/bpl-tools)
* **License:** [**GPL-2.0-or-later**](https://www.gnu.org/licenses/gpl-2.0.html)
* **Purpose:** Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* **External Services:** The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: [https://github.com/bPlugins/bpl-tools#external-requests–why-they-are-made](https://github.com/bPlugins/bpl-tools#external-requests–why-they-are-made)

== Installation ==

= From Gutenberg Editor: =
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Image viewer**
3. Click on the **Image viewer** to add the block

= Download & Upload: =
1. Download the **Image viewer** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`imager-viewer.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

= Manually: =
1. Download and upload the **Image viewer** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress

== Frequently Asked Questions ==

= Is Image viewer free? =

Yes, Image viewer is a free Gutenberg block plugin.

= Does it work with any WordPress theme? =

Yes, it will work with any standard WordPress theme.

= Can I change block settings? =

Yes, you can change block settings from the Gutenberg block editor's right sidebar.

= How many times can I reuse a block? =

You can use unlimited times as you want.

= Does this block require any coding knowledge? =

No, this block is beginner-friendly and does not require any coding knowledge to use.

== Screenshots ==

1. Zoom Preview
2. Zoom Settings
3. Magnify Preview & Settings
4. Map Preview & Settings
5. Map Settings
6. Pano or Rotation Preview & Settings
7. Transform Image Preview & Settings
8. Masking Preview & Settings
9. Viewport Preview & Settings
10. MultImage Overlay Preview
11. MultImage Overlay Settings
12. Aspect Ratio Preview
13. Aspect Ratio Settings
14. Hotspot Annotations Preview
15. Hotspot Annotations General Settings
16. Hotspot Annotations Style Settings
17. Zoom & Pan Viewer Preview
18. Zoom & Pan Viewer General & Style Settings
19. Image Comparison Slider Preview
20. Image Comparison Slider General & Style Settings


== Changelog ==

= 1.0.7 – 4 June 2026 =
* Updated API version for improved performance and compatibility.
* Improved notice modal UI with a new modern design style.
* Fixed naming consistency issues across the plugin for improved clarity and uniform structure.

= 1.0.6 – 18 May 2026 =
* Updated Shortcode UI for better usability.
* Removed block preview and added Theme Switcher.
* Improved Pro Modal UI design and interaction.

= 1.0.5 – 4 March 2026 =
* Added hotspot annotation size and text elements.

= 1.0.4 – 23 February 2026 =
* Fixed the scroll wheel issue.
* Fixed the image cropping issue.
* Duplicate styles of hotspot annotation styles have been removed.


= 1.0.3 – 29 January, 2026 =
* Added New 8 Premium Image Viewer Styles.

= 1.0.2 – 17 April, 2025 =
* Added default image.

= 1.0.1 – 29 June 2024 =
* Changed plugin display name, block name, updated banner, and updated feature map.

= 1.0.0 =
* Initial Release


== Upgrade Notice ==

= 1.0.7 – 4 June 2026 =
* Updated API version for improved performance and compatibility.
* Improved notice modal UI with a new modern design style.
* * Fixed naming consistency issues across the plugin for improved clarity and uniform structure.

= 1.0.6 – 18 May 2026 =
* Updated Shortcode UI for better usability.
* Removed block preview and added Theme Switcher.
* Improved Pro Modal UI design and interaction.

= 1.0.5 – 4 March 2026 =
* Added hotspot annotation size and text elements.

= 1.0.4 – 23 February 2026 =
* Fixed the scroll wheel issue.
* Fixed the image cropping issue.
* Duplicate styles of hotspot annotation styles have been removed.

= 1.0.3 – 29 January, 2026 =
* Added New 8 Premium Image Viewer Styles.

= 1.0.2 – 17 April, 2025 =
* Added default image.

= 1.0.1 – 29 June 2024 =
* Changed plugin display name, block name, updated banner, and updated feature map.

= 1.0.0 =
* Initial Release