=== Panorama - 360 degree Virtual Tour, Panoramic Image viewer and More ===
Contributors: bplugins, abuhayat, freemius, shamim10, farazi1
Tags: panorama, 360 degree, 3d, virtual tour, krpano, 
Requires at least: 6.5
Tested up to: 7.0
Stable tag: 1.7.1
Requires PHP: 7.1
Donate link: https://www.buymeacoffee.com/abuhayat
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html


Panorama Viewer displays panoramic images/videos easily on your WordPress site. Supports various files like .png, .jpeg, .mp4, and more.

== Description ==

The plugin is very easy to use and anyone can use the plugin easily without any technical knowledge.

https://youtu.be/yU92XDtcyWg

You can embed any panoramic photos, or videos in Posts, Pages, Widget areas and WooCommerce product pages. It comes with everything you need to make the most of your panoramic pictures.

This WordPress plugin enables seamless display of 360° images, 3D images, videos, and panoramic galleries. With dedicated Gutenberg blocks, shortcodes, and WooCommerce integration, you can display immersive media on any page, post, widget area, or product page.

The Free version comes with fully functional blocks for all media types, including 360° virtual tours (up to 2 scenes and 3 hotspots), interactive product hotspots (up to 3 spots), basic Google Street View embedding, and WooCommerce integration for 360° images and product spots.

Upgrade to the Pro version to unlock unlimited scenes, unlimited product hotspots, full WooCommerce video integration, advanced viewer customization (starting pitch, yaw, and zoom/FOV), inactivity delay auto-rotation, custom navigation controls, galleries with load-more pagination, title/author overlays, and virtual compass guides.
 
 
**[See Live Demos](https://bplugins.com/products/panorama/#demos)** 
**[Get Pro Version](https://bplugins.com/products/panorama/pricing)** 

= Free Features = 

- **WooCommerce Integration (Basic)**: Embed 360° Images and Product Hotspots directly into WooCommerce product pages.
- **Gutenberg Blocks Support**: Includes 8 dedicated blocks (Image 360°, Image 3D, Video, Video 360°, Google Street View, Gallery, Virtual Tour, and Product Spot).
- **360° Virtual Tour (Basic)**: Create interactive tours with up to 2 scenes and 3 hotspots per tour.
- **Product Spot (Basic)**: Highlight product details with interactive hotspots (up to 3 spots).
- **Google Street View (Basic)**: Embed Google Street View panoramas easily by entering the Panorama ID.
- **Media Uploads**: Upload and display panoramic images and videos from the WordPress media library.
- **Auto-Rotation**: Enable auto-rotate and customize rotation speed in degrees per second.
- **Shortcode API & Embed URLs**: Generate shortcodes to place viewers anywhere, and use public URLs to share content.
- **Elementor & Page Builder Compatible**: Works seamlessly with Elementor and other builders using shortcodes.
- **Lightweight & Fast**: Optimized performance to ensure fast loading times without bloat.
 

= Pro Features =

- **WooCommerce Video Integration**: Add 360° and standard panoramic videos directly to WooCommerce product galleries.
- **Unlimited Scenes & Hotspots**: Build massive 360° Virtual Tours and Product Hotspot displays with zero limits.
- **Initial View Settings**: Set precise starting angles (Pitch, Yaw, and Field of View / Zoom) for panoramas.
- **Advanced Navigation & Interaction**: Configure fullscreen modes, draggable panoramas, mouse scroll-to-zoom toggles, and virtual compass guides.
- **Auto-Rotation Inactivity Delay**: Automatically pause and resume rotation when a user interacts with the viewer.
- **Premium Video Playback**: Picture-in-Picture mode, playback speed controls, and advanced video controls.
- **Title & Author Info**: Add customizable context overlays displaying title and author credits.
- **Rich Galleries**: Custom grid layouts, spacing, item limits, sorting, and "Load More" button customization.
- **Advanced Google Street View**: Premium interactive settings and customized auto-rotation controls.


### Who Should Use Panorama Viewer Plugin?

* Stores
* Schools
* Museums
* Car and other vehicle Showrooms
* Travel Agency
* Art Galleries
* Real Estate Agency
* Physical Products Stores


### Video tutorial
https://youtu.be/bs-U13KtYEA


== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository: 
[**Panorama on GitHub**](https://github.com/bPlugins/panorama-free)

== Third-Party Libraries ==

This plugin bundles the following third-party JavaScript/PHP libraries.

= Codestar Framework =

* **Source:** [http://codestarframework.com/](http://codestarframework.com/)
* **GitHub:** [https://github.com/Codestar/codestar-framework](https://github.com/Codestar/codestar-framework)
* **License:** GPLv2 or later – [https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md](https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md)
* **Purpose:** Provides the options framework for the plugin's settings and shortcode generator.

= Freemius SDK =

* **Source:** [https://freemius.com/](https://freemius.com/)
* **GitHub:** [https://github.com/Freemius/wordpress-sdk](https://github.com/Freemius/wordpress-sdk)
* **License:** GPLv3 – [https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt](https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt)
* **Purpose:** Provides opt-in usage tracking and analytics to help improve the plugin.

= bpl-tools =
* Source / 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


### User Feedback

#### ⭐⭐⭐⭐⭐ [Great even on iOS](https://wordpress.org/support/topic/great-even-on-ios/)

❛❛***Im Happy very happy with this Plug-in. The only one which works fine with iphone***❜❜

***-[holmh](https://wordpress.org/support/users/holmh/)***


#### - Did you like this plugin? Dislike it? Have a feature request? [Please share your feedback with us](mailto:support@bplugins.com 'Send feedback')
  


= How to use  =

Follow the steps below to embed a panoramic image. 

1. Go to -> Panorama Viewer from Dashboard menu -> Add New Panorama.
2. Configure the viewer from Panorama Settings with your preference. 
3. Click the Save button 
4. Copy Generated ShortCode (See below the Panorama title ) and paste it where you like to embed the Panorama Viewer.


= Where do I report security bugs found in this plugin? =

Please report security bugs found in the source code of the Panorama Viewer – 360 Degree Image + Video Viewer plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fb819-4b62-4820-a920-21dde4762ab6). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.



= ⭐ Checkout our other WordPress Plugins- = 

🔥 **[Html5 Audio Player](https://audioplayerwp.com/)** – Best audio player plugin for WordPress.

🔥 **[Html5 Video Player](https://wpvideoplayer.com/)** – Best video player plugin for WordPress.

🔥 **[PDF Poster](http://pdfposter.com/)** – A fully-featured PDF Viewer Plugin for WordPresss.

🔥 **[StreamCast](https://wordpress.org/plugins/streamcast)** – A fully-featured Radio Player Plugin for WordPresss.

🔥 **[3D Viewer](https://3d-viewer.bplugins.com/)** – Display interactive 3D models on the webs.


== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Upload `plugin-directory` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use shortcode in page, post or in widgets.
4. If you want to show panorama in your theme php, Place `<?php echo do_shortcode('YOUR_SHORTCODE'); ?>` in your templates


== Screenshots ==

1. Gutenberg block
2. Sidebar menu
3. Configuration & Shortcode Generator
4. Image 3D
5. Image 360°
6. Video
7. Video 360°
8. Gallery

== Changelog ==

= 1.7.1 - 04 Jun, 2026 =
* **Enhancement:** Kept the Panorama Type selection field visible globally across all tabs with tab state persistence.

= 1.7.0 - 23 May, 2026 =
* **Update:** Refactored architecture to decouple shared Pro code, establishing a clean standalone Free version.
* **Update:** Upgraded Gutenberg blocks to API version 3.
* **Fix:** Resolved dragging lock and cursor drift issues in Gutenberg block editors.
* **Improvement:** Streamlined settings panels by replacing lock screens with clean premium feature notices.
* **Improvement:** Modernized admin dashboard settings layout and WooCommerce metabox sections.
* **Update:** Enhanced sanitization, escaping, and prefix compliance for WordPress.org standards.
* **Cleanup:** Purged legacy unused scripts and added secure database cleanup on uninstall.

= 1.6.1 - 12 May, 2026 =
* **Fix:** Removed unintended premium-only license activation file from free version.

= 1.6.0 - 29 Mar, 2026 =
* **New:** Embed URL option added for 360 Virtual Tours and Product Spot.
* **Improved:** Modernized shortcode clipboard UI with integrated embed URL support.
* **New:** Initial View Toggle, Position, and Zoom Level (FOV) controls added for Gallery items with per-item customization (Gutenberg block + dashboard settings).

= 1.5.1 - 14 Mar, 2026 =
* Fixed fullscreen display issue in 360° gallery.

= 1.5.0 - 12 Mar, 2026 =
* Added embed URL feature to allow sharing and viewing on any website via direct URL.

= 1.4.5 - 24 Jan, 2026 =
* Fixed multiple panorama editing, preview, and Gutenberg block issues.
* Improved viewer behavior and controls across all panorama types.
* Documentation improvements.

= 1.4.4 - 10 Dec, 2025 =
* Title & Author/credit fully removed when disabled; no hidden HTML or outbound links.

= 1.4.3 - 03 Dec, 2025 =
* Added new plugin banner.

= 1.4.2 - 21 Nov, 2025 =
* Added preview image and load button text controls.

= 1.4.1 - 12 October, 2025 =
* Update pricing plan, added buy now button in feature compare section and fixed the Initial view parameters in X,Y,Z.

= 1.4.0 - 10 Sep, 2025 =
* Added new product spot block and update dashboard.

= 1.3.4 - 17 August, 2025 =
* Added new toggle control **“Show "by" Prefix”** to enable/disable the "by" text before the author name.

= 1.3.3 - 28 July, 2025 =
* Updated freemius sdk and pricing link.

= 1.3.2 - 10 July, 2025 =
* Updated Shortcode clipboard area.

= 1.3.1 - 24 Jun, 2025 =
* solved the isssue of Media Placeholder (virtual tour).

= 1.3.0 - 19 Jun, 2025 =
* Added new viewer (virtual tour).

= 1.2.3 - 02 May, 2025 =
* Updated metabox fields.

= 1.2.2 - 28 April, 2025 =
* Updated admin dashboard.

= 1.2.1 - 20 April, 2025 =
* Fixed text-domain issue.

= 1.2.0 - 13 April, 2025 =
* Added: 7 blocks have been registered for the WordPress Gutenberg block editor.

= 1.1.6 - 25 Nov, 2024 =
* Update: WordPress SDK
* Initial view for video

= 1.1.5 - 13 Aug, 2024 =
* Update: WordPress SDK

= 1.1.4 - 03/07/2024 =
* Update: WordPress SDK

= 1.1.3 =
* Codestar Update

= 1.1.2 =
* Freemius SDK updated
* fix data-settings issue

= 1.1.1 =
* Freemius SDK updated

= 1.0.6 =
* Tour Feature Added
* Performance improved
* Fixed Mirror issues

= 1.0.5 =
* Fixed Mirror issues

= 1.0.4 =
* Gallery Feature Added
* Google Panoramic Street View
* Performance improved
* Fixed issues

= 1.0.3 =
* New Feature included
* Performance improved
* Fixed issues

= 1.0.2 =
* scripts updated
* New Feature included
* Performance improved
* Fixed issues

= 1.0.1 =
* Fixed mirror issues

= 1.0.0 =
* Initial Release

