ExploreXR Version 1.3.0
Release Date: May 19, 2026
Type: Initial WordPress.org Release
Branch: alpha, beta, master
Tag: v1.3.0
Overview
ExploreXR Free v1.3.0 marks the initial public release of the free version on WordPress.org. This is a ground-up rebuild based on ExploreXR Premium 1.3.1, optimized specifically for the free plugin architecture with a single-addon system.
What makes this special: Every installation includes one Premium Addon of your choice — AR (Augmented Reality), Animation Control, or Loading Options — giving users professional-grade 3D capability out of the box.
Key Features
Core 3D Viewer
- Interactive GLB, GLTF, and USDZ model embedding via shortcode
[explorexr_model id="123"] - Fully responsive with per-breakpoint sizing (desktop, tablet, mobile)
- Camera controls: orbit, zoom, pan, touch gestures
- Auto-rotation with configurable speed, delay, and direction
- Conditional asset loading — scripts only enqueue on pages with models
- Drag-and-drop upload in WordPress admin
Compression & Performance
- Draco geometry compression — bundled decoder for smaller model files
- KTX2/Basis Universal texture compression — efficient GPU-compressed textures
- Meshopt compression — optimized mesh and attribute compression
- All decoders bundled locally, no CDN dependency
Loading Strategies
- Direct loading — immediate model render
- Poster + button — click-to-load with custom button
- Lazy loading — IntersectionObserver-based loading when model enters viewport
- Per-model override capability
- Customizable "Load Model" button (text, colors, border radius)
One Premium Addon Included
Choose from three premium addons (installed as separate plugins from WordPress.org):
- AR Addon — iOS Quick Look, Android Scene Viewer, WebXR augmented reality
- Animation Addon — Play, pause, loop, ping-pong glTF animation clips with crossfade
- Loading Options Addon — Custom loading bars, percentage counters, overlays
Only one addon can be active at a time. Multiple addons require ExploreXR Premium (Pro/Plus/Ultra).
Page Builder Compatibility
- WordPress Block Editor (Gutenberg)
- Classic Editor
- Elementor (via shortcode)
- Divi (via shortcode)
- Avada / Fusion Builder (via shortcode)
- Any shortcode-compatible builder
Native widgets/modules for Elementor, Divi, and Avada are available in ExploreXR Premium.
Technical Improvements
Architecture
- Built on the same rendering core as ExploreXR Premium 1.3.1
- Single-addon enforcement system with curated whitelist
- Compatibility bridge for premium addon filter names
- Stub addon manager for plugin interoperability
Security & Validation
- Nonce-protected admin actions
- Strict file upload validation (MIME type + extension checks)
- Capability checks on all AJAX handlers
- Output escaping at point of display (PHPCS compliant)
- wp_safe_redirect() for all redirects
Code Quality
- Full WordPress Coding Standards compliance
- Zero PHPCS warnings/errors
- Tested on WordPress 5.0 through 6.9
- PHP 7.4+ support (8.0+ recommended)
Bug Fixes
Upload System
- Fixed: GLB/GLTF/USDZ upload failures caused by PHP
finfoMIME detection returningapplication/octet-stream - Solution: Added
wp_check_filetype_and_extfilter to correctly validate 3D model file types
Duplicate Activation
- Fixed: PHP fatal error "Cannot redeclare function" when attempting to activate both Free and Premium simultaneously
- Solution: Conflict detection at file load time — Free self-deactivates if Premium is active, and vice versa
Model Size Detection
- Fixed: Large model size detection for automatic loading strategy selection
- Improved: Better fallback handling for models without explicit size metadata
What's Included
Core Files
- Main plugin:
explorexr/explorexr.php(v1.3.0) - 9 admin pages: Dashboard, Browse Models, Create Model, Edit Model, Files, Settings, Loading Options, Free Addons, Premium Upgrade
- 4 loading templates: Standard, Large, Lazy Load, Model Viewer Script
- Security, validation, and file handling systems
Assets
- Google Model Viewer (UMD build)
- Draco decoder (WASM + JS wrapper)
- Basis Universal decoder (WASM + JS wrapper)
- Meshopt decoder (WASM + JS wrapper)
- Admin CSS (13 files) and JS (10 files)
- Frontend CSS and JS (conditional loading)
Integrations
- Shortcode system (3 aliases:
[explorexr_model],[explorexr],[EXPLOREXR_model]) - Page builder compatibility layer
- Free addon loader system
- Premium upgrade system
Upgrade Path
From No Previous Version
This is the initial free release. Install directly from WordPress.org.
From ExploreXR Premium
If you have Premium installed, do not activate Free. The plugins are mutually exclusive. Premium includes all Free features plus unlimited addons and commercial add-ons.
To Premium
Upgrade to ExploreXR Premium for:
- 3 / 5 / unlimited addon slots (Pro / Plus / Ultra)
- Material Variants, Camera & Lighting, Post-Processing, Annotations
- WooCommerce integration
- Native Elementor/Divi/Avada widgets
- Priority support
- Multi-site licensing (1 / 5 / 25 sites)
Changelog Summary
Added
- Initial WordPress.org free plugin release
- Single-addon system with curated whitelist (AR, Animation, Loading Options)
- Bundled compression decoders (Draco, KTX2/Basis, Meshopt)
- Per-model loading strategy override (direct/poster/lazy)
- Customizable "Load Model" button (text, colors, radius)
- Global and per-model lazy loading via IntersectionObserver
- Free addon installation page with one-click install
- Premium upgrade page with feature comparison
- Conflict detection system (Free ↔ Premium)
Fixed
- GLB/GLTF/USDZ upload failures from PHP
finfoMIME detection - PHP fatal error on duplicate Free+Premium activation
- Large model size detection and automatic strategy selection
- Draco/Meshopt/Basis decoder path resolution
Improved
- Admin UI with consistent styling across all 9 pages
- Loading bar customization system
- Performance with conditional script loading
- Documentation with comprehensive FAQ (15 questions)
Resources
- Plugin Page: wordpress.org/plugins/explorexr/
- Documentation: expoxr.com/explorexr/documentation/
- Live Demo: expoxr.com/explorexr/demo/
- Video Tutorial: youtube.com/watch?v=RTTJ6lX6uXw
- Support Forum: wordpress.org/support/plugin/explorexr/
- Premium Info: expoxr.com/explorexr/pricing/
License
ExploreXR Free is licensed under GPLv2 or later.
Third-party libraries:
- Google Model Viewer (Apache 2.0)
- Draco (Apache 2.0)
- Basis Universal (Apache 2.0)
- Meshoptimizer (MIT)
Credits
Built by Ayal Othman — ExpoXR
Powered by Google Model Viewer and open-source contributors.
Next Steps
- Install ExploreXR from WordPress.org
- Go to ExploreXR → Create Model and upload your first GLB/GLTF file
- Visit ExploreXR → Addons and choose your included Premium Addon
- Embed the shortcode on any page
- Enjoy interactive 3D models on your WordPress site!
Questions? Join the support forum or check the documentation.
Thank you for using ExploreXR! 🚀