=== ExploreXR – Interactive 3D Model Viewer for WordPress ===
Contributors: expoxr
Tags: 3d model viewer, glb viewer, gltf, augmented reality, elementor 3d
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The easiest way to add interactive 3D models to WordPress. Embed GLB, GLTF, and USDZ files with a shortcode — no coding required. Upgrade to Premium for AR, animations, and the full add-on suite.

== Description ==

**Add Beautiful, Interactive 3D Models to WordPress — No Coding Required.**

ExploreXR is a fast, easy-to-use 3D viewer plugin for WordPress. Upload a GLB, GLTF, or USDZ file, copy a shortcode, and your visitors get a fully interactive, hardware-accelerated 3D model right inside the browser. No 3D experience needed. No developer required.

Need AR, animations, material switching, or WooCommerce integration? Upgrade to **ExploreXR Premium** — a structured add-on platform built for teams that want full control over 3D on the web.

[View Pricing](https://expoxr.com/explorexr/preise/) | [Live Demo](https://expoxr.com/explorexr/demo/) | [Documentation](https://expoxr.com/explorexr/documentation/) | [Free 14-Day Trial](https://expoxr.com/explorexr/trial-request/)

---

**Watch: How to Create an Interactive 3D Design in WordPress**

Step-by-step walkthrough on building interactive 3D experiences on your WordPress site:
[https://youtu.be/RTTJ6lX6uXw?si=KeMRrSABHfcf1vmr](https://youtu.be/RTTJ6lX6uXw?si=KeMRrSABHfcf1vmr)

---

**Free Version — The 3D Viewer**

The free version gives you a clean, capable 3D viewer you can embed anywhere on your WordPress site:

* Display interactive GLB, GLTF, and USDZ 3D models in any post, page, or widget
* Embed with shortcode: `[explorexr_model id="123"]`
* Fully responsive — scales correctly on desktop, tablet, and mobile
* Camera controls: rotation, zoom, and pan
* Auto-rotation with configurable speed and delay
* Poster image support — show a preview before the model loads
* Customizable viewer size: Small, Medium, Large, or Full Width
* Per-breakpoint sizing: different dimensions for desktop, tablet, and mobile
* Progressive loading with smooth fallback
* Loading bar with configurable color, size, and position
* Drag-and-drop model upload through the WordPress admin
* Bundled Draco geometry and Basis Universal texture decoders — no CDN needed
* Nonce-protected admin actions and strict file upload validation
* Full WordPress Coding Standards compliance, tested on WordPress 5.0 through 7.x

The free version does not include the add-on system. It is a single, focused tool — upload a model, embed it, done.

---

**Who Uses ExploreXR**

* **E-commerce stores** — let shoppers rotate and inspect products before buying (AR available via Premium)
* **Product designers and manufacturers** — present technical models with precision and clarity
* **Architecture and real estate teams** — browser-based model presentations without external tools
* **Agencies** — a repeatable system for delivering 3D capability across multiple client sites
* **Education and training teams** — interactive 3D models embedded directly into course content

---

**ExploreXR Premium — The Add-On Platform**

Premium is not just "more features" — it is a different architecture. Where the free version is a single viewer, Premium is a structured add-on system: a lean core with optional capability modules you activate individually. Your site only loads the code you actually use.

= Performance-Aware Architecture =
Conditional asset loading, multiple loading strategies (direct, lazy, or poster-driven), and built-in Draco and Basis Universal compression decoders ensure heavy 3D assets do not slow your site down. Heavy models, clean Core Web Vitals.

= Modular Add-On System =
A lean core with optional premium add-ons — AR, material variants, animation controls, WooCommerce integration, and more. Activate only the exact capabilities you need. Nothing else loads. No bloat.

= Broad Ecosystem Compatibility =
Complies strictly with WordPress coding standards and works natively with the Block Editor, Classic Editor, and major page builders — Elementor, Divi, and Avada. Tested against every WordPress release including WordPress 7.

**Available Add-Ons:**

* **AR (Augmented Reality)** — iOS Quick Look, Android Scene Viewer, and WebXR in one add-on
* **Animation Control** — multi-clip playback with configurable crossfade transitions
* **Annotations** — interactive hotspots, labels, dimension lines, and camera-targeted explanations
* **Material Variants** — real-time color, finish, and model state switching without page reload
* **Camera & Lighting** — expert camera constraints and HDRI environment lighting
* **Post-Processing** — cinematic visual effects and filters applied directly to the viewer
* **WooCommerce Integration** — attach 3D models directly to product pages
* **Elementor Widget** — native drag-and-drop 3D viewer block inside the Elementor editor
* **Divi Module** — native integration within the Divi visual builder
* **Avada Integration** — Fusion Element for Avada-based sites
* **Draggable Viewer** — user-repositionable viewer for advanced editorial layouts
* **Mouse3D Cursor** — 3D-aware pointer for interactive presentation experiences

All 12 add-ons are included in [ExploreXR Premium plans](https://expoxr.com/explorexr/preise/).

**Try Premium Free For 14 Days — No Credit Card Required.**
[Request your free trial](https://expoxr.com/explorexr/trial-request/)

---

**Supported Page Builders**

ExploreXR works with:

* WordPress Block Editor (Gutenberg)
* Classic Editor
* Elementor (free version: shortcode; Premium: native widget)
* Divi (free version: shortcode; Premium: native module)
* Avada / Fusion Builder (free version: shortcode; Premium: native element)
* Any shortcode-compatible builder

---

**Resources**

* [Plugin Documentation](https://expoxr.com/explorexr/documentation/)
* [Tutorial: Build an Interactive 3D Design](https://youtu.be/RTTJ6lX6uXw?si=KeMRrSABHfcf1vmr)
* [Live Demo](https://expoxr.com/explorexr/demo/)
* [View All Add-Ons](https://expoxr.com/explorexr/addons/)
* [Pricing and Plans](https://expoxr.com/explorexr/preise/)
* [Free Trial Request](https://expoxr.com/explorexr/trial-request/)
* [Support Forum](https://wordpress.org/support/plugin/explorexr/)
* [Premium Support](https://expoxr.com/support/)

== Installation ==

= Automatic Installation (Recommended) =
1. Go to **Plugins → Add New** in your WordPress dashboard
2. Search for **ExploreXR**
3. Click **Install Now** then **Activate**

= Manual Installation =
1. Download the plugin ZIP from [WordPress.org](https://wordpress.org/plugins/explorexr/)
2. Go to **Plugins → Add New → Upload Plugin**
3. Select the ZIP file and click **Install Now**
4. Activate the plugin via the Plugins menu

= Quick Start: Embed Your First 3D Model =
1. Go to **ExploreXR → Create Model** in the WordPress admin
2. Upload a GLB or GLTF file (GLB recommended for best performance)
3. Set viewer size, background, controls, and optional poster image
4. Copy the generated shortcode (e.g. `[explorexr_model id="123"]`)
5. Paste the shortcode into any post, page, widget, or page builder block

Full documentation: [https://expoxr.com/explorexr/documentation/](https://expoxr.com/explorexr/documentation/)

== Third-Party Libraries ==

= Google Model Viewer =
* License: Apache 2.0
* Source: [https://github.com/google/model-viewer](https://github.com/google/model-viewer)
* Purpose: Core 3D rendering engine used to display GLB, GLTF, and USDZ files in the browser

= Draco Geometry Compression =
* License: Apache 2.0
* Source: [https://github.com/google/draco](https://github.com/google/draco)
* Purpose: Decoding support for Draco-compressed 3D geometry — reduces model file size significantly

= Basis Universal Texture Compression =
* License: Apache 2.0
* Source: [https://github.com/BinomialLLC/basis_universal](https://github.com/BinomialLLC/basis_universal)
* Purpose: Decoding support for Basis Universal compressed textures — improves texture loading performance

All libraries are GPL-compatible and bundled locally. No CDN dependency or external request is required to render 3D models.

== Frequently Asked Questions ==

= What is the difference between the free version and Premium? =
The free version is a 3D viewer — upload a model, embed it with a shortcode, done. ExploreXR Premium is a full add-on platform built on a modular architecture, giving you AR, animations, material variants, WooCommerce integration, native page builder widgets, and more — activated individually so your site stays lean.

= Which 3D file formats does ExploreXR support? =
GLB, GLTF, and USDZ. GLB (binary GLTF) is the recommended format — it is self-contained, loads faster, and has the broadest device support. USDZ is optimized for iOS AR workflows.

= How do I embed a 3D model on a WordPress page? =
Create a model under **ExploreXR → Create Model**, then paste the shortcode `[explorexr_model id="123"]` into any post, page, widget, or page builder block. That is all.

= Does ExploreXR require coding knowledge? =
No. The entire workflow — uploading models, configuring the viewer, embedding on pages — is handled through the WordPress admin interface. No PHP, JavaScript, or CSS knowledge is required.

= Does it work on all devices and browsers? =
Yes. ExploreXR works on all modern browsers and devices that support WebGL, including desktop (Chrome, Firefox, Safari, Edge), tablet, and mobile.

= Will 3D models slow down my WordPress site? =
Not when configured correctly. ExploreXR uses conditional asset loading (scripts only load on pages with a 3D model), multiple loading strategies (direct, lazy, and poster-driven for large files), and locally bundled decoders — so models are compressed and loading is deferred until needed.

= Does ExploreXR work with Elementor, Divi, and Avada? =
Yes. The free version works with all three via shortcode. ExploreXR Premium adds native drag-and-drop widgets and modules for Elementor, Divi, and Avada.

= Is AR (Augmented Reality) included in the free version? =
AR is available in [ExploreXR Premium](https://expoxr.com/explorexr/preise/) via the AR add-on. It supports iOS Quick Look, Android Scene Viewer, and WebXR.

= Is ExploreXR compatible with WooCommerce? =
WooCommerce product page integration is available in [ExploreXR Premium](https://expoxr.com/explorexr/preise/).

= Is there a free trial for Premium? =
Yes. You can try all 12 premium add-ons free for 14 days — no credit card required. [Request your trial here](https://expoxr.com/explorexr/trial-request/).

= Is ExploreXR compatible with WordPress 7? =
Yes. ExploreXR is tested against WordPress 7.x and follows WordPress Coding Standards to ensure long-term compatibility across every major WordPress release.

= What happens to my models if I deactivate the plugin? =
Your model files and all settings are preserved. Deactivating the plugin does not delete any data. Reactivate and everything will be exactly as you left it.

= Where can I get support? =
Free support is available on the [WordPress.org support forum](https://wordpress.org/support/plugin/explorexr/). Premium users have access to priority support via [expoxr.com/support/](https://expoxr.com/support/).

== Screenshots ==

1. Plugin dashboard — overview of models, files, storage, and system status
2. Create New Model — upload GLB/GLTF files and configure viewer settings
3. Plugin Settings — configure viewer defaults, loading strategy, and CDN options
4. 3D Models Overview — browse, search, and manage all published 3D models
5. Edit 3D Model — fine-tune display options, per-breakpoint sizes, poster image, and shortcode

== Changelog ==

= 1.2.0 =
* Fixed: GLB/GLTF/USDZ uploads failing with "Invalid file type" due to PHP finfo MIME detection mismatch
* Fixed: Added wp_check_filetype_and_ext filter so WordPress correctly validates 3D model file types when finfo returns application/octet-stream

= 1.1.0 =
* New: 14-day free trial — try ExploreXR Premium with 4 add-ons of your choice, no credit card required
* New: Elementor widget integration for drag-and-drop 3D viewer placement
* New: Divi module integration for native Divi builder support
* New: Avada Fusion Element integration
* New: Completely redesigned Go Premium page showcasing all 12 premium add-ons with full descriptions
* New: Trial notice directing users to ExpoXR website for the 14-day premium trial
* Updated: Dashboard Upgrade to Premium section now shows all 12 add-ons and trial CTA
* Updated: Premium features metabox on model edit pages lists all available add-ons
* Updated: Feature comparison table expanded with all premium capabilities
* Updated: Recommended add-on combinations section for common use cases
* Fixed: Version constant mismatch resolved
* Improved: Premium feature list expanded from 2 to 13 entries
* Improved: License stub now returns trial status when trial is active

= 1.0.9 =
* New: Unified size presets (Small/Medium/Large/Full) applied to desktop/tablet/mobile meta
* New: Server and admin validation prevents width/height both using % (invisible viewer guard)
* Fixed: Loading option attributes now pass through the correct filter to JS loaders
* Fixed: Admin slug/meta casing and premium URL wrapper

= 1.0.8 =
* Fixed: Database query compliance — replaced direct wpdb queries with WordPress Transients and Cache APIs
* Fixed: Unclosed brace syntax error in cache-manager.php
* Improved: CSS architecture — created shared components.css reducing duplicate code by 336 lines
* Improved: Admin form layouts use CSS Grid with 2-column responsive design
* Enhanced: Cache management uses proper WordPress caching mechanisms
* Enhanced: All PHPCS warnings resolved — full WordPress Coding Standards compliance

= 1.0.7 =
* Fixed: Custom tablet and mobile sizes now properly apply on frontend
* Fixed: Removed unwanted character from admin page titles
* Fixed: WordPress.org security compliance — replaced wp_redirect() with wp_safe_redirect()
* Fixed: All WordPress Coding Standards violations resolved — passes Plugin Check with zero errors
* Improved: Poster image preview in both Upload and Media Library tabs
* Security: Enhanced nonce verification and input sanitization across all admin forms

= 1.0.6 =
* Initial public release on WordPress.org
* Core 3D viewer, shortcode, admin interface, and model upload system

== Upgrade Notice ==

= 1.2.0 =
Fixes GLB/GLTF file upload failures caused by PHP MIME type detection. Update recommended if you experience "Invalid file type" errors when uploading 3D models.

= 1.1.0 =
Adds native Elementor, Divi, and Avada integrations plus a 14-day free trial for Premium. Update recommended.

= 1.0.6 =
Initial release. Install to start displaying interactive 3D models in WordPress.

== Privacy Policy ==

ExploreXR does not collect, store, or transmit any personal data. All 3D rendering occurs entirely within the visitor's browser using locally bundled libraries. No external tracking, analytics, or user data collection is performed by this plugin.

For premium license validation, only a license key is transmitted to ExpoXR servers. No personal user data is included. See the [ExpoXR Privacy Policy](https://expoxr.com/privacy-policy/) for full details.

== Support ==

Free support via the WordPress.org support forum:
[https://wordpress.org/support/plugin/explorexr/](https://wordpress.org/support/plugin/explorexr/)

Premium support and documentation:
[https://expoxr.com/support/](https://expoxr.com/support/)

== Credits ==

Powered by [Google Model Viewer](https://modelviewer.dev/) and open-source contributors.
Built by [Ayal Othman](https://expoxr.com) — ExpoXR.
