=== Modelora - 3D Product & Model Viewer ===
Contributors: rishav001
Tags: 3d, model viewer, woocommerce, product viewer, shortcode
Requires at least: 6.4
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Beginner-friendly, high-performance 3D model viewer for WordPress and WooCommerce.

== Description ==

Modelora lets you manage and display interactive 3D models in WordPress.

You can:
- Add and manage 3D model entries from the WordPress admin.
- Display models with shortcode and block support.
- Attach models to WooCommerce products.
- Use a performance-focused frontend viewer experience.

== Installation ==

1. Upload the plugin folder to the /wp-content/plugins/ directory, or install the plugin ZIP via Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins screen in WordPress.
3. Open the Modelora admin menu to add your first model.
4. Embed your model using shortcode, block, or WooCommerce integration.

== Frequently Asked Questions ==

= Which model formats are supported? =
Use modern web-friendly 3D formats supported by the integrated viewer, such as GLB/GLTF.

= Can I use it with WooCommerce products? =
Yes. The plugin includes WooCommerce integration so models can be attached to product pages.

= Do I need coding knowledge to use it? =
No. The plugin is designed to be beginner-friendly.

== External Services ==

The 'Load Demo Model' feature securely downloads a sample 3D file from modelviewer.dev to quickly demonstrate plugin functionality.
- What the service is: modelviewer.dev is a developer resource for the <model-viewer> web component.
- What data is sent: No personal data is sent. An HTTP request is made to download the demo model (Astronaut.glb) when the user clicks 'Load Demo'.
- Terms of Service: https://modelviewer.dev/
- Privacy Policy: https://policies.google.com/privacy (ModelViewer is maintained by Google)

All other 3D rendering dependencies (including Draco WebAssembly decoders `*.wasm` and KTX2 transcoders `*.wasm`) are bundled locally within the plugin. These WASM binary files are strictly necessary for decoding compressed 3D geometries and textures without connecting to an external CDN, ensuring full privacy and compliance with WordPress.org tracking guidelines.

Model conversion: Users can convert 3D models (FBX, OBJ, STL, DAE) to GLB format using external tools like Babylon.js Sandbox, Blender, or similar software, then upload the GLB files to WordPress.

### Included Demo Assets

The plugin includes a sample 3D model used strictly as a demonstration asset. All rights to the model remain with the original creator.

CAR Model by Ignition Labs [CC-BY] (https://creativecommons.org/licenses/by/3.0/) via Poly Pizza (https://poly.pizza/m/5zUWP5UsLg-)

== Changelog ==

= 1.0.0 =
* Initial release.
* Added shortcode and block-based model embedding.
* Added WooCommerce and Elementor integration support.
* Added REST API routes.

== Upgrade Notice ==

= 1.0.0 =
Initial public release.
