0%

ExploreXR Plugin Documentation

Docu­mentation

This guide explains how to install, configure, and use ExploreXR to display interactive 3D models on your WordPress website in a clean, performant, and future-proof way.

1. What is ExploreXR (Free)?

ExploreXR Free is a lightweight WordPress plugin that allows you to:

  • Display interactive 3D models directly inside WordPress
  • Manage 3D models from a dedicated admin interface
  • Embed models using a simple shortcode
  • Configure all viewer settings from the WordPress backend
  • Keep performance optimized for standard hosting environments


The Free version is ideal for testing, demos, portfolios, and simple product or project presentations.

2. Requirements

Before installing, make sure your environment meets the following requirements:

WordPress 6.0 or higher

  • PHP 8.0 or higher (8.1 and 8.2 supported)
  • HTTPS enabled (recommended for WebGL and browser security)
  • A modern browser with WebGL support

Supported 3D formats:

  • .glb (recommended)
  • .gltf
  • .usdz

3. Installation

Option A: Install via WordPress Plugin Directory

  1. Go to WordPress Admin → Plugins → Add New
  2. Search for “ExploreXR”
  3. Click Install, then Activate

Option B: Manual Upload

  1. Download the ExploreXR plugin ZIP file
  2. Go to Plugins → Add New → Upload Plugin
  3. Upload the ZIP file
  4. Activate the plugin

4. Creating a New 3D Model

ExploreXR does not embed models directly from the Media Library.
Instead, each model is created and managed inside ExploreXR.

To create a new model, go to:

WordPress Admin → ExploreXR → Create New Model

On the “Create New Model” page, you can:

  • Set a Model Name (internal reference)
  • Upload a 3D model (.glb or .gltf)
  • Choose the viewer size
  • Upload a poster image (displayed before the model loads)

Once saved, the model is registered in ExploreXR and ready to be embedded.

5. Embedding a 3D Model (Shortcode)

ExploreXR uses a single, clean shortcode format:

Invalid model ID.

Important notes:

  • The shortcode only accepts an ID
  • The ID is always a numeric value
  • No additional parameters are used in the shortcode

This design keeps your content clean and future-proof.

6. Editing Model Settings

All viewer settings are configured directly in the WordPress admin.

To edit a model’s behavior, go to:

 

ExploreXR → Browse Models → Edit

 

On the Edit 3D Model page, you can configure the following options:

1. Model Information:

  • Model Title
  • Display Name
  • Alt Text
  • Description

These fields help with organization, accessibility, and SEO.

2. Display Size:

  • Choose between Predefined Sizes
  • Or define Custom Sizes for precise layout control

3. 3D Model File:

  • Replace the existing 3D model file
  • This allows you to fix or update a model without changing the shortcode
  • The model ID remains the same.

4. Poster Image:

  • Change or update the poster image
  • The poster is shown before the model loads or when load-on-click is enabled

5. Viewer Controls

  • Enable or disable user interactions
  • Auto-rotate model, including: Auto-rotate delay, Auto-rotate speed

Any changes made here are automatically applied everywhere the shortcode is used — no need to edit pages or posts.

7. Loading Options

The Loading Options allow you to control how 3D models are loaded and displayed on your website.
These settings help optimize performance, loading time, and user experience, especially on pages with large or multiple models.

All loading options are configured in the WordPress admin on the Edit 3D Model page.

Core Loading Settings

These settings control how the loading state of a 3D model is displayed to the user.

Display Type

Choose how loading feedback is shown while the model is loading:

  • Loading Bar Only
    Displays a visual progress bar during loading.

  • Percentage Counter Only
    Displays a numeric loading percentage.

  • Loading Bar and Percentage
    Displays both a progress bar and a percentage counter.

For advanced styling, animations, and visual effects, consider upgrading to ExploreXR Premium.

Lazy Loading Options

Lazy loading improves initial page load times by loading content only when it is needed.

Lazy Load Poster Images

  • Enable lazy loading for poster images

When enabled, poster images are loaded only when they are about to enter the viewport, reducing initial page load time and improving performance on long pages.

Large Model Handling

Large 3D models can significantly affect loading performance.
These settings allow you to define special behavior for larger files.

Size Threshold (MB)

  • Default value: 16 MB

Models larger than this value are treated as large models and will use the behavior selected below.

Large Model Behavior

Choose how ExploreXR handles models that exceed the size threshold:

  • Load directly (Default)
    The model loads automatically, regardless of file size.

  • Show poster with load button
    Displays the poster image with a button.
    The model loads only after the user clicks the button.

  • Lazy load when visible
    The model loads automatically only when it is about to enter the viewport.

These options help balance performance, bandwidth usage, and user control, especially on mobile devices or slower connections.

10. Support & Community

For best performance and user experience:

  • Keep 3D models under 10–15 MB
  • Optimize textures (2K recommended)
  • Use load-on-click for long pages
  • Avoid embedding multiple heavy models on the same page

8. ExploreXR Premium (01.01.2026)

ExploreXR Premium is currently in development and will introduce modular add-ons and advanced features.

More add-ons and improvements will be released over time.

Available Add-ons:

Draggable Add-On

Movable 3D Viewers

Let users reposition 3D viewers directly on the page.

– Drag & reposition models on frontend
– Optional position memory
– Boundary constraints for layouts

Post-Processing Add-On

Cinematic Visual Effects

Upgrade visual quality with advanced rendering effects.

Bloom
Depth of Field (DOF)
Screen Space Ambient Occlusion (SSAO)
Tone mapping & color grading

Environment & Lighting Add-On

Scene & Atmosphere Control

Enhance realism with environment and lighting presets.

– Background presets
– Reflection and ambience controls
– Environment lighting adjustments
– Visual consistency across models

Morphing Add-On

State-to-State Model Transitions

Create smooth morph transitions between model states.

– Morph between different model versions or states
– Trigger via buttons or scroll
– Adjustable timing & easing curves
– Seamless visual transitions

Mouse3D Control Add-On

Subtle Desktop Interaction

Add smooth mouse-driven camera movement for desktop users.

– Mouse-based camera rotation
– Optional zoom behavior
– Subtle parallax-style interaction
– Lightweight & performance-friendly

Debug Toolkit Add-On

Diagnostics & Support Visibility

Improve troubleshooting and support workflows.

– System & environment diagnostics
– Version and compatibility checks
– Active add-on status overview
– Debug information for support requests

11. What’s Next?

If you enjoy ExploreXR Free:

  • Test it in real projects
  • Share feedback
  • Prepare for ExploreXR Premium

Thank you for using ExploreXR.