ExploreXR brings the power of interactive 3D models to your WordPress website with zero coding required. Using Google's industry-leading Model Viewer technology, your visitors can interact with stunning 3D content directly in their browserβrotating, zooming, and even viewing products in their own space through AR.
Perfect for: E-commerce stores, product showcases, portfolios, museums, educational sites, real estate listings, architectural firms, and any website looking to engage users with immersive 3D experiences.
|
|
|
ExploreXR handles the technical complexities so you can focus on showcasing your 3D content:
- Drag-and-drop Uploads - No technical knowledge needed
- Instant Previews - See your models before publishing
- Multiple Display Options - Control size, position, and behavior
- Interactive Controls - Zoom, rotate, pan with intuitive controls
- Cross-browser Support - Consistent experience across all major browsers
- AR Mode on Mobile - USDZ for iOS, WebXR for Android (via free AR add-on)
# Option 1: WordPress Admin
1. Download the ZIP from GitHub
2. Go to WordPress Admin β Plugins β Add New β Upload Plugin
3. Upload the ZIP file and click "Install Now"
4. Click "Activate Plugin"
# Option 2: Manual Installation
1. Download and unzip the plugin
2. Upload the 'explorexr' folder to /wp-content/plugins/
3. Activate through the WordPress admin interface- Navigate to "ExploreXR β Create Model" in your WordPress admin
- Upload your GLB/GLTF file via drag-and-drop
- Configure basic settings (size, position, controls)
- Save your model and copy the generated shortcode
- Paste the shortcode into any post or page:
[explorexr_model id="123" width="100%" height="400px" auto-rotate="true"]
| Requirement | Minimum | Recommended |
|---|---|---|
| WordPress | 5.0+ | 6.0+ |
| PHP | 7.4+ | 8.0+ |
| Memory Limit | 64MB | 128MB+ |
| Browser | Modern browsers with WebGL support | Chrome, Firefox, Safari, Edge (latest versions) |
[explorexr_model id="123"]
<?php
// Display model in theme template
if (function_exists('explorexr_display_model')) {
explorexr_display_model(123, array(
'width' => '100%',
'height' => '500px',
'auto-rotate' => true
));
}
?>- Dimensions: Custom width/height or responsive sizing
- Controls: Orbit, zoom, pan, auto-rotate
- Loading: Custom loading text, progress indicators
- AR Mode: Enable/disable augmented reality viewing
- Camera: Default position, field of view, limits
Configure different display options for:
- οΏ½οΈ Desktop (1024px+)
- π± Tablet (768px - 1023px)
- π± Mobile (< 768px)
ExploreXR includes multiple features to ensure optimal performance:
- Progressive Loading - Models load in stages to minimize perceived wait time
- Lazy Loading - Models only load when they come into view
- Custom Poster Images - Display static images until model loads
- Device-Specific Settings - Automatically adjust quality based on device capabilities
- Compression Support - Compatible with Draco and other compressed formats
- Optimized Assets - Efficient loading of required scripts and styles
- Caching - Browser caching for improved repeat visits
ExploreXR is built with security as a top priority:
- File Validation - Strict checking of uploaded model files
- Sanitized Input - All user inputs are properly sanitized
- Capability Checks - WordPress permission system integration
- NONCE Protection - Protection against CSRF attacks
- XSS Prevention - Proper output escaping throughout
- GDPR Compliance - No personal data collection
- Clean Code - Following WordPress security best practices
ExploreXR Free includes one premium add-on of your choice. You can activate one of the following add-ons from the ExploreXR β Free Add-ons admin page:
- AR Addon β Enable augmented reality on mobile, including USDZ support for iOS and WebXR support for Android
- Animation Addon β Play, pause, loop, and control GLTF animations directly inside the 3D viewer
- Loading Options Addon β Customize the loading experience with poster images, loading behavior, and smoother model presentation
Unlock all 12 add-ons plus priority support. Details at expoxr.com/explorexr/premium.
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Fixed: GLB/GLTF/USDZ uploads failing with "Invalid file type" due to PHP finfo MIME detection mismatch
- Added:
upload_mimesfilter registering correct MIME types for all 3D model formats - Added:
wp_check_filetype_and_extfilter handling finfo returningapplication/octet-stream - Improved: Conflict notice distinguishes Premium-vs-Free from Free-vs-Free duplicate scenarios
- Added:
function_exists()guards on all file-scope functions
- Fixed: GLB/GLTF/USDZ upload MIME type validation now accepts all three formats reliably
- New: Free add-on system β activate one premium add-on (AR, Animation, or Loading Options) at no cost
- New: Free Add-ons admin page with one-click install and activation
- New: Conflict prevention blocks simultaneous activation with ExploreXR Premium
- Stability and compatibility improvements
- PHPCS escaping compliance updates
- New: Canonical display size presets (Small/Medium/Large/Full) applied across create/edit/shortcode
- New: Tablet and mobile size meta now populated for presets (no silent fallbacks)
- New: %/% dimension guard in admin + backend + shortcode to prevent invisible viewers
- 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
- Database query compliance and cache-manager brace fix
- Shared admin components CSS, grid-based layouts, and PHPCS cleanup
- Cache management now uses WP cache APIs; improved styling and focus states
- Responsive device sizes honored on frontend; admin title fixes and nonce/sanitization improvements
- Poster previews and upload tab UX refinements
- Initial public release: core 3D viewer, shortcode, admin UI, progressive loading, security framework
This project is licensed under the GPL v2 or later - see the LICENSE file for details.
- π Official Website: expoxr.com
- π Documentation: expoxr.com/explorexr/documentation
- π Issue Tracker: GitHub Issues
- π¬ Support Forum: WordPress.org Support
Made with β€οΈ by Ayal Othman
Transform your WordPress website with immersive 3D experiences. Start with ExploreXR today!