ExploreXR Version 1.3.2

Release Date: July 14, 2026
Type: Bug Fix Release

What's Changed

This is a maintenance release with admin UI improvements and bug fixes.

Bug Fixes

Free-tier addon whitelist corrected to AR, Animation, and Loading Options (was incorrectly allowing Camera Controls and Annotations, which are Premium-only, while blocking Loading Options).
Closed a race condition where two addons could briefly end up simultaneously active during install.
Deactivation-notice script and admin bar link no longer silently fail due to a plugin-path case mismatch.
A plugin-wide button style was forcing its own color onto the Loading Options color pickers, so picked colors never displayed correctly.

Improvements

Proper WordPress color pickers for the Load Model button colors, with automatic text contrast.
Removed: Dead code, duplicate admin screens, and unused legacy files.

What's Changed

• Performance, legacy cleanup, and addon-system hardening by @ExpoXR in #11

Full Changelog: v1.3.1...v1.3.2

ExploreXR Version 1.3.1

Release Date: May 19, 2026
Type: Bug Fix Release

What's Changed

This is a maintenance release with admin UI improvements and bug fixes.

Bug Fixes

• Fixed admin page styling and layout inconsistencies
• Fixed free addon selection UI refinements
• Fixed dashboard statistics display accuracy

Improvements

• Improved admin navigation consistency across all pages
• Improved error messages and user feedback clarity

Installation

Download from WordPress.org or update via your WordPress admin dashboard.

Full Changelog

v1.3.1: v1.3.0...v1.3.1

---

Previous Release: v1.3.0 - Initial WordPress.org free release

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):

1. AR Addon — iOS Quick Look, Android Scene Viewer, WebXR augmented reality
2. Animation Addon — Play, pause, loop, ping-pong glTF animation clips with crossfade
3. 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 finfo MIME detection returning application/octet-stream
• Solution: Added wp_check_filetype_and_ext filter 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)

View Premium Pricing

---

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 finfo MIME 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

1. Install ExploreXR from WordPress.org
2. Go to ExploreXR → Create Model and upload your first GLB/GLTF file
3. Visit ExploreXR → Addons and choose your included Premium Addon
4. Embed the shortcode on any page
5. Enjoy interactive 3D models on your WordPress site!

Questions? Join the support forum or check the documentation.

---

Thank you for using ExploreXR! 🚀

ExploreXR Version 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

What's Changed

• Refactor: Remove legacy code, fix bugs, and clean up plugin by @ExpoXR in #4
• Upgrade Model Viewer library to version 4.1.0 by @ExpoXR in #5
• Add page builder integrations for Elementor, Divi, and Avada by @ExpoXR in #7

Full Changelog: v1.0.9...v1.1.0

ExploreXR Version 1.0.9

Added

• Canonical display size presets (Small/Medium/Large/Full) applied across create/edit/shortcode
• Tablet and mobile size meta now populated for presets (no silent fallbacks)
• %/% dimension guard in admin + backend + shortcode to prevent invisible viewers

Fixes

• Fixed: Loading attribute filter alignment so data-* reach the JS loader
• Fixed: Admin CPT slug/meta casing, premium URL wrapper, and existing file constant
• UI: Added early-adopter 50% banner on Dashboard and Go Premium pages

Full Changelog: v1.0.8...v1.0.9

ExploreXR Version 1.0.8

Release v1.0.8 — Cache & Compliance Upgrade

This release focuses on WordPress.org compliance, safer caching, and a cleaner admin UI foundation.

Fixes

• Replaced direct $wpdb queries with WordPress Transients + Cache APIs for full database query compliance-
• Fixed an unclosed brace syntax error in cache-manager.php

Improvements

• Refactored CSS into a shared components.css, reducing duplicate CSS by 336 lines (~25%)-
• Updated admin form layouts to use CSS Grid with a 2-column responsive design-
• Improved input styling with focus states and smooth transitions

Enhancements

• Cache management now uses proper WordPress caching mechanisms (wp_cache_*, transients)-
• Resolved all PHPCS warnings — now fully compliant with WordPress Coding Standards

Full Changelog: v1.0.7...v1.0.8

ExploreXR Version 1.0.6

WORDPRESS.ORG COMPLIANCE CLEANUP

This Release removes all debugging code to meet WordPress.org plugin
review standards for production release.

PHP Changes:

• Removed 16 calls to explorexr_is_debug_enabled() from model-helper.php
• Removed 4 calls to explorexr_create_debug_log() from meta-handlers.php
• Removed 4 calls to explorexr_debug_add() from model-validator.php
• Removed 5 console.log statements from PHP inline scripts
• Removed Debug Mode UI row from settings page system info
• Removed conditional console.log from class-post-types.php

JavaScript Changes:

• Removed 90+ console.log statements from custom JS files:
  • model-handler.js (45 instances)
  • model-uploader.js (8 instances)
  • model-viewer-preload.js (11 instances)
  • model-viewer-wrapper.js (4 instances)
  • model-viewer-guard.js (3 instances)
  • model-viewer-loader-manager.js (2 instances)
  • model-loader.js (2 instances)
  • edit-mode-fix.js (1 instance)
  • error-handler.js (1 instance)
  • unified-error-handler.js (1 instance)
  • template-parts/model-viewer-script.php (3 instances)
  • metaboxes/model-file.php (1 instance)

Compliance Verification:

✓ No var_dump, print_r, or var_export statements
✓ wp_die() only used for security checks (acceptable)
✓ No hardcoded passwords, API keys, or secrets
✓ Text domain 'explorexr' properly used throughout
✓ Proper sanitization and escaping maintained
✓ Legacy version option kept for backward compatibility

Vendor Files Preserved:

• model-viewer.min.js (Google library - not modified)
• model-viewer-umd.js (Google library - not modified)
• vendor/* files (third-party libraries - not modified)

Impact:

• Plugin is now production-ready for WordPress.org submission
• All undefined debug function calls removed (prevents PHP errors)
• No debugging output in production environment
• Cleaner, more professional codebase

Version: 1.0.6 (unchanged - keeping stable release number)
Status: Ready for WordPress.org review"

ExploreXR Version 1.0.4

v1.0.4

Update support URL in readme.txt for v1.0.3

ExploreXR Version 1.0.3

CRITICAL FIXES:

• FIXED: Fatal function redeclaration errors preventing plugin activation
• FIXED: Parse errors and syntax issues in uninstall.php
• FIXED: WordPress admin notice positioning conflicts
• FIXED: ABSPATH usage - replaced with proper WordPress functions
• FIXED: Nonce validation - added to all $_POST access points

MODAL VIEWER ENHANCEMENTS:

• ENHANCED: Modal viewer functionality with proper event delegation
• ENHANCED: Dynamic content handling for better user experience
• ENHANCED: Improved JavaScript timing and error handling
• ENHANCED: Cross-page modal consistency

WORDPRESS.ORG COMPLIANCE:

• COMPLIANCE: Eliminated ALL remote file calls (unpkg.com, CDN) - 100% local files
• COMPLIANCE: Converted ALL inline scripts/styles to wp_add_inline_script/wp_add_inline_style
• COMPLIANCE: Documented WASM files as essential for 3D compression
• COMPLIANCE: Added complete source code documentation
• COMPLIANCE: Removed error_reporting() and ini_set() modifications
• COMPLIANCE: Fixed plugin folder data storage - uses WordPress uploads directory
• COMPLIANCE: All variables properly escaped with esc_js(), esc_attr(), esc_html()
• COMPLIANCE: Proper WordPress admin page structure
• COMPLIANCE: Complete nonce validation and user permission checks

SECURITY ENHANCEMENTS:

• SECURITY: WordPress standard debugging implementation
• SECURITY: Enhanced function existence checks preventing conflicts
• SECURITY: Removed all WordPress core DOM manipulation
• SECURITY: Complete input validation and sanitization

100% READY FOR WORDPRESS.ORG PLUGIN DIRECTORY SUBMISSION

ExploreXR Version 1.0.1

Features:

• 3D Model Viewer with Google Model Viewer
• WordPress Admin Interface for Model Management
• Shortcode Support for Frontend Display
• Secure Model File Handling