=== Photo Sphere Viewer – 360° Panorama, Virtual Tour, 360 Video & AR 3D Model Viewer ===
Contributors: wpxero
Tags: 360 panorama, virtual tour, 360 video, 3d model viewer, real estate
Version: 2.2.3
Stable tag: 2.2.3
Requires PHP: 7.0
Requires at least: 5.0
Tested up to: 7.0
License: GPL-3.0
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Donate link: https://wpxero.com/plugins/photo-sphere-viewer/pricing/
Elementor requires at least: 3.0
Elementor tested up to: 4.0.9

360° panorama, virtual tour, 360 video & AR 3D model viewer for WordPress. Works with Elementor, Gutenberg & shortcodes. DJI & Ricoh Theta ready.

== Description ==

### The All-in-One 360° Panorama, Virtual Tour, 360 Video & AR 3D Plugin for WordPress

**Photo Sphere Viewer** is the most complete **360° panorama plugin for WordPress** — embed **interactive 360 panoramic images**, build **multi-scene virtual tours**, play **immersive 360° videos**, and showcase **AR-ready 3D models** (.glb / .gltf) on any page. Works natively with **Elementor**, the **Gutenberg block editor**, and a visual **Shortcode Builder** — no coding required.

Built for **real estate virtual tours**, **hotel room previews**, **360 photographer portfolios**, **travel & tourism websites**, **museum & campus tours**, **WooCommerce 360 product views**, and **AR product configurators** — Photo Sphere Viewer turns any WordPress site into an immersive experience.

 [**Upgrade to Pro**](https://wpxero.com/plugins/photo-sphere-viewer/pricing/)
---

### Built for DJI, Ricoh Theta, Insta360 & Pro 360° Cameras

Photo Sphere Viewer is purpose-built for **professional equirectangular workflows**:

- **DJI Matrice & drone panoramas** — Loads true **un-scaled original uploads** via the built-in `ImageResolver`, bypassing the WordPress 5.3+ `-scaled.jpg` quality loss so aerial detail stays sharp on huge panoramas.
- **Ricoh Theta, Insta360, GoPro MAX, Qoocam, Kandao** — Any stitched equirectangular JPEG/PNG works out of the box.
- **Google Street View & Photo Sphere XMP** — Drop in any Street View image or Android Photo Sphere capture.
- **Stereoscopic & VR-ready** — Pro **gyroscope mode** unlocks VR-style head-orientation viewing on mobile (HTTPS).

---

### 4 Immersive Viewers — All in One Plugin

#### 1. 360° Panorama Viewer
Upload any **equirectangular panorama** (JPEG/PNG) and let visitors drag, pinch, and zoom on desktop and mobile.

- Drag-to-explore with mouse and touch gestures
- Pinch-to-zoom and mouse-wheel zoom
- Configurable **field of view**, zoom limits, and movement speed
- **Auto-rotation** with adjustable delay and speed
- Custom starting position (**yaw / pitch**)
- **Fullscreen** mode + caption navbar
- **Free zoom & download** buttons in the panorama navbar

#### 2. Virtual Tour Builder
Create **unlimited multi-scene virtual tours** linked by 3D navigation arrows — ideal for **real estate walkthroughs**, hotel tours, museums, and campus maps.

- Unlimited scenes per tour
- **3D arrow hotspots** between scenes
- Per-scene starting position (yaw / pitch)
- Per-scene captions and start scene selection
- **Pro:** scene gallery thumbnail bar, compass overlay, premium navbar (move, fullscreen, autorotate, description, zoom, download)

#### 3. 360° Video Player
Embed **interactive 360-degree videos** — viewers can look around while the equirectangular MP4 plays.

- MP4 and common web video formats
- Play/pause, seek, and volume controls in the navbar
- **Pro:** muted **autoplay**, **loop**, and zoom/fullscreen/download navbar

#### 4. AR 3D Model Viewer
Embed interactive **.glb / .gltf** 3D models with optional **AR mode** on supported iOS / Android devices (powered by Google `<model-viewer>`). Perfect for **product configurators**, e-commerce, portfolios, and education.

- Model from URL or WordPress Media Library + optional poster
- Auto-rotate, shadow intensity, alignment, canvas sizing
- **Pro:** HDR environment lighting, skybox background, custom camera orbit, disable zoom, disable tap-to-rotate

---

### Three Ways to Add 360° Content

- **Elementor widgets** — Four dedicated widgets: *Photo Sphere Viewer*, *PSV Virtual Tour*, *PSV 360° Video*, *AR 3D Viewer*. Individually toggle each widget from the admin panel.
- **Gutenberg block** — Native block editor support with live preview. (coming soon)
- **Shortcode Builder** — Visual admin UI under the Photo Sphere Viewer menu generates `[psv]`, `[psv_tour]`, `[psv_video]`, and `[psv_ar]` shortcodes — paste anywhere, including **WooCommerce product descriptions**, page builders, and theme widgets.

---

### All Features at a Glance

- **Fully Responsive** — Desktop, tablet, and mobile with touch-optimized drag and pinch-to-zoom
- **Customizable Navbar** — Toggle zoom, caption, fullscreen, autorotate, and download buttons
- **Style Controls** — Navbar background, caption color, typography, and alignment
- **Flexible Sizing** — Width / height in `px`, `%`, `vh`, or `vw`
- **Starting Position** — Default yaw (-180° to 180°) and pitch (-90° to 90°)
- **Canvas Background** — Custom color behind the panorama
- **Mouse & Touch Options** — Toggle mouse wheel zoom, drag movement, two-finger touch, Ctrl+scroll, cursor capture, fisheye
- **Original-Resolution Loader** — Built-in `ImageResolver` defaults shortcodes to `use_original=yes` for DJI / large panoramas
- **Lightweight & Fast** — Vite-built bundle, optimized for Core Web Vitals
- **Translation Ready** — Loads translations from `/languages/` (Text Domain: `photo-sphere-viewer`)
- **Developer Friendly** — Clean shortcode API with full attribute control + Elementor widget hooks


### Perfect For

- **Real Estate Agents & Agencies** — Virtual property tours, open house walkthroughs, listing pages
- **Hotels, Resorts & Vacation Rentals** — Room previews, lobby tours, amenity showcases
- **360° Photographers** — Panoramic portfolios with gallery navigation
- **Travel & Tourism** — Destination previews, city tours, landmark experiences
- **Education & Museums** — Campus tours, exhibit walkthroughs, virtual classrooms
- **WooCommerce & E-Commerce** — 360° product views and AR-ready 3D models on product pages
- **Architects & Interior Designers** — Project showcases, before/after spaces
- **Event Venues & Weddings** — Venue tours, conference halls, wedding location showcases
- **Drone & Aerial Pilots (DJI Matrice)** — High-resolution aerial 360° panoramas at full quality

---

### Compatible With

Elementor, Elementor Pro, Gutenberg block editor, WooCommerce, Yoast SEO, Rank Math, WPML, Polylang, popular caching plugins (WP Rocket, LiteSpeed Cache, W3 Total Cache), and any WordPress theme that supports shortcodes. Works alongside common page builders.

Tested with cameras: **DJI Matrice / Mavic**, **Ricoh Theta**, **Insta360**, **GoPro MAX**, **Qoocam**, **Kandao**, **Google Street View**, and any standard equirectangular output.

---

== Installation ==

1. Upload the `photo-sphere-viewer` folder to `/wp-content/plugins/`, or install directly from the WordPress plugin directory.
2. Activate the plugin through the **Plugins** menu.
3. Use the **Elementor widget**, **Gutenberg block**, or **shortcode builder** (under the Photo Sphere Viewer admin menu) to add 360° content to your site.

== How It Works ==

### Using Elementor
1. Open the Elementor editor.
2. Search for **Photo Sphere Viewer**, **PSV Virtual Tour**, **PSV 360° Video**, or **AR 3D Viewer** in the widget panel.
3. Drag the widget into your layout.
4. Upload your panorama image or video and configure display settings, navbar controls, and styling.

### Using Gutenberg
Insert the **Photo Sphere Viewer** block, upload your panorama, and configure options from the sidebar panel.

### Using Shortcodes
Use the built-in **Shortcode Builder** from the admin menu to visually create shortcodes, or write them manually:

---

== Frequently Asked Questions ==

= What image formats does the 360° panorama viewer support? =
Photo Sphere Viewer supports **equirectangular panorama images** in JPEG and PNG. For 360° video, MP4 and common web video formats are supported. AR 3D Viewer supports **.glb** and **.gltf** models.

= Do I need Elementor to use this plugin? =
No. The plugin works equally well with **Elementor**, **Gutenberg**, and **shortcodes**. You can embed 360° panoramas anywhere shortcodes are supported — posts, pages, widget areas, theme builders, and WooCommerce product descriptions.

= Is this the best 360 panorama plugin for real estate virtual tours? =
Yes. Photo Sphere Viewer is purpose-built for **real estate virtual tours** — unlimited scenes, 3D navigation arrows, per-scene starting angles, mobile-first touch controls, and (Pro) scene gallery, compass, and gyroscope. No external embed accounts or recurring third-party fees.

= Does it work with DJI Matrice and large drone panoramas? =
Yes. Many WordPress sites lose detail on huge equirectangular uploads because WordPress 5.3+ generates a `-scaled.jpg` and serves that instead of the original. Our built-in **`ImageResolver`** detects this and loads the **un-scaled original** so DJI Matrice and other high-resolution aerial panoramas stay sharp. Shortcodes default to `use_original=yes`; Pro adds a one-click toggle in the Elementor widget.

= Does it support Ricoh Theta, Insta360, GoPro MAX, and Google Street View? =
Yes. Any **standard equirectangular image** works out of the box — including Ricoh Theta, Insta360, GoPro MAX, Qoocam, Kandao, Google Street View, and Android Photo Sphere XMP captures.

= Is the 360° viewer mobile-friendly and touch-optimized? =
Yes. Fully responsive with **drag-to-explore**, **pinch-to-zoom**, and two-finger gestures on all modern smartphones and tablets. Pro adds **gyroscope** mode for VR-style head-orientation viewing on HTTPS sites.

= Can I create a virtual tour with multiple scenes? =
Yes. Add unlimited scenes, link them with **3D navigation arrows**, set per-scene captions and starting positions, and choose the start scene. Available in both the Elementor **PSV Virtual Tour** widget and the `[psv_tour]` shortcode.

= Can I embed 360° videos? =
Yes. Use the **PSV 360° Video** widget or the `[psv_video]` shortcode to embed interactive equirectangular MP4 videos with play/pause, seek, and volume controls. Pro unlocks **autoplay** and **loop**.

= Can I show 3D / AR models on my WordPress site? =
Yes. The **AR 3D Viewer** widget and `[psv_ar]` shortcode embed `.glb` / `.gltf` models with an optional **AR button** on supported iOS / Android devices (powered by Google `<model-viewer>`). Pro adds HDR environment lighting, skybox, custom camera orbit, and interaction locks — perfect for product configurators and e-commerce.

= How do I set the starting viewing angle? =
Each panorama and tour scene supports a **starting yaw** (-180° to 180°) and **starting pitch** (-90° to 90°). Configure in the Elementor widget controls or via shortcode attributes `default_yaw` and `default_pitch`.

= Does it work with WooCommerce? =
Yes. Add **360° product panoramas**, **virtual showrooms**, or **AR-ready 3D models** to WooCommerce product pages using shortcodes or Elementor templates — a great alternative to expensive third-party 360 product viewers.

= Will it slow down my site? =
No. The plugin is built with **Vite** for an optimized, lightweight bundle. Assets are only enqueued on pages that use a viewer. Compatible with **WP Rocket**, **LiteSpeed Cache**, and **W3 Total Cache**.

= Is the plugin translation / multilingual ready? =
Yes. The text domain is `photo-sphere-viewer` and translations load from `/languages/`. Compatible with **WPML** and **Polylang**.

= What's the difference between Free and Pro? =
**Free** includes all four viewers — 360° panorama, virtual tour, 360° video, and AR 3D — plus Elementor, Gutenberg, the Shortcode Builder, and the original-resolution shortcode loader. **Pro** unlocks the gallery bar, compass overlay, gyroscope, visible range restriction, premium navbar on tour & video (move, fullscreen, autorotate, description, zoom, download), 360° video autoplay/loop, advanced AR options (HDR, skybox, camera orbit, interaction locks), the Elementor original-resolution toggle, and **priority email support**. See the comparison table above or [view pricing](https://wpxero.com/plugins/photo-sphere-viewer/pricing/).

= Is there a money-back guarantee on Pro? =
Yes. Pro comes with a **30-day money-back guarantee**, so you can try it risk-free.

= Where can I get support? =
Free users can use the [WordPress.org support forum](https://wordpress.org/support/plugin/photo-sphere-viewer/). Pro license holders receive **priority email support** directly from the WPXERO team.

---

== Screenshots ==
1. 360° panorama embedded using the Elementor widget
2. Elementor widget settings panel with full customization options
3. Virtual tour with 3D navigation arrows between scenes
4. 360° video player with playback controls
5. Shortcode builder admin interface
6. Responsive mobile preview with touch controls
7. AR 3D Viewer widget and admin integration

---

== Upgrade Notice ==

= 2.2.3 =
- Fixed: Shortcode panoramas failing on pages without jQuery
- Improved: Asset loading, Pro detection, and Elementor widget icons

== Changelog ==

#### 2.2.3 [June 06, 2026]
- Fixed: Shortcode panoramas failing on pages without jQuery
- Improved: Asset loading and Vite dev-server detection
- Improved: Centralized Pro add-on detection
- Improved: Updated Elementor widget icons
- Improved: Code cleanup across widgets and shortcode manager

#### 2.2.2 [May 22, 2026]
- Improved: improve plugin performance and stability
- Fixed: various minor bug fixes and stability improvements

#### 2.2.1 [May 20, 2026]
- Fixed: High-resolution panorama detail loss by loading original images instead of scaled versions
- Improved: stability and performance

#### 2.2.0 [May 05, 2026]
- Added: AR 3D Viewer — Elementor widget and `[psv_ar]` shortcode for .glb/.gltf models (model-viewer; optional AR on supported devices)
- Improved: Admin dashboard UI — styling, navigation, and Upgrade page comparison table (including AR 3D Viewer Free vs Pro)
- Improved: Tested compatibility through WordPress 7.0.0

#### 2.1.1 [April 13, 2026]
- Fixed: Compatibility with WordPress 7.0 and Elementor 4.0.1

#### 2.1.0 [March 07, 2026]
- Added: Virtual tour support for both widget and shortcode implementations
- Added: 360° video playback support for widget and shortcode
- Added: Gallery view support for widget and shortcode
- Added: Starting position (yaw/pitch) controls for panorama and tour scenes
- Improved: Compatibility with WordPress 6.9 and Elementor 3.35.5
- Improved: Performance optimizations for faster panorama rendering
- Fixed: Image display issue in Elementor 3.35.5 when placing widget inside columns
- Fixed: Multiple Photo Sphere Viewer widgets rendering incorrectly within the same section in editor mode
- Fixed: Duplicate frontend initialization on Elementor pages
- Fixed: Various minor bug fixes and stability improvements

#### 2.0.3 [February 13, 2026]
- Fixed: Assets enqueue issue

#### 2.0.2 [February 09, 2026]
- Improved: Compatibility updates for WordPress 6.9 and Elementor 3.35.3
- Improved: Performance improvements and bug fixes

#### 2.0.1 [December 03, 2025]
- Fixed: Upgrade notice issue
- Added: Pro version pricing link
- Improved: Compatibility with latest WordPress & Elementor versions

#### 2.0.0 [November 29, 2025]
- Added: Shortcode builder
- Improved: Refactored codebase for improved performance
- Added: Pro version

#### 1.3.3 [October 01, 2025]
- Improved: Compatibility updates
- Improved: Documentation improvements

#### 1.3.2 [May 01, 2025]
- Improved: Compatibility updates

#### 1.3.1 [December 21, 2024]
- Improved: System improvements
- Improved: Compatibility updates

#### 1.3.0 [October 09, 2024]
- Improved: Compatibility updates

#### 1.2.0 [October 09, 2023]
- Improved: Compatibility updates

#### 1.1.0 [March 15, 2023]
- Improved: Elementor compatibility update

#### 1.0.1 [May 15, 2022]
- Added: Shortcode feature

#### 1.0.0 [February 06, 2022]
- Initial release