=== Ultimate 3D Model Viewer ===
Contributors: robindort
Tags: 3D, Model Viewer, Widget, Ultimate
Requires at least: 6.8
Tested up to: 6.9
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Ultimate 3D Model Viewer lets you easily embed interactive 3D models in WooCommerce, Elementor, and Gutenberg – fully responsive and customizable.

== Description ==

Bring your website to life with Ultimate 3D Model Viewer – an intuitive WordPress plugin designed for seamless embedding of interactive 3D models on WooCommerce product pages, Elementor layouts, and Gutenberg blocks.

Ultimate 3D Model Viewer empowers you to showcase interactive 3D content directly on your WordPress site — whether on pages, posts, WooCommerce product pages, or via Elementor and Gutenberg blocks.

The plugin supports a wide range of 3D formats, including GLB, GLTF, and USDZ, and delivers powerful customization options such as skybox environments, real-world dimension overlays, custom loading screens, and advanced visual tuning with tone mapping, exposure control, and shadow enhancements.

Through seamless integration with Elementor and Gutenberg, users can easily place and configure 3D models using an intuitive visual interface. For WooCommerce users, product models can be embedded directly into product detail pages, offering an immersive 360° viewing experience that boosts customer engagement.

Ultimate 3D Model Viewer is built for performance, offering smart loading strategies, auto-rotation, and responsive rendering across all devices — including AR (Augmented Reality) compatibility on supported mobile devices. With full multilingual support and a developer-friendly structure, it's the perfect tool to bring your 3D content to life.


## Free Features
- **Embed 3D Models:** Place your 3D models anywhere on your website.
- **Supported 3D formats:** Upload your 3D model as .GLB, .GLTF or .USDZ
- **Customizable skybox:** Select custom skybox backgrounds for your 3D models
- **Show real life dimensions:** Display exact product sizes on your 3D models for better customer clarity
- **WooCommerce Integration:** Display your WooCommerce products as 3D models on your product pages
- **Elementor support:** Bring your 3D models to life effortlessly using Elementors UI
- **Gutenberg support:** You prefer using the classic block editor? Seamlessly add 3D models with full Gutenberg block support
- **Fully responsive:** Adapt your 3D models seamlessly to all screen sizes
- **Multilingual Support:** Fully integrated English and German interface, content, and documentation


## Premium Features
- **Embed 3D Models:** Place your 3D models anywhere on your website.
- **Supported 3D formats:** Upload your 3D model as .GLB, .GLTF or .USDZ
- **Customizable skybox:** Select custom skybox backgrounds for your 3D models
- **Show real life dimensions:** Display exact product sizes on your 3D models for better customer clarity
- **WooCommerce Integration:** Display your WooCommerce products as 3D models on your product pages
- **Elementor support:** Bring your 3D models to life effortlessly using Elementors UI
- **Gutenberg support:** You prefer using the classic block editor? Seamlessly add 3D models with full Gutenberg block support
- **Fully responsive:** Adapt your 3D models seamlessly to all screen sizes
- **Multilingual Support:** Fully integrated English and German interface, content, and documentation
- **Customizable loading screen:** Set up a loading screen that attracts the attention of your customers
- **Environment support:** Ignite realism with stunning reflections using full HD radiance lighting
- **Advanced tone mapping support for vibrant visuals:** Unleash stunning visuals with powerful tone mapping that brings your models to life
- **Exposure Control:** Exposure Adjustment for Stunning Visual Impact
- **Shadow adjustments:** Add realistic depth to and dimension to your models with customizable shadows
- **Precise Camera Controls:** Fine-tune a bunch of camera objects like a custom camera angle and more for perfect presentation
- **Smart Loading Strategy:** Optimize load times with adaptive and efficient 3D model loading
- **Dynamic Auto-Rotation:** Enable and disable 360-degree auto rotation
- **AR Viewer Compatibility:** Seamless mobile AR with custom USDZ models for immersive experiences


##Support 
If you have any Problems, questions or recommendations about Ultimate 3D Model Viewer, please do not hesitate to [contact us](https://www.pslzme.com/en/login).



== Installation ==

- Install using the WordPress built-in Plugin installer, or Extract the zip file you received after contacting us on [pslzme.com](https://www.pslzme.com/en/login) and drop the contents in the wp-content/plugins/ directory of your WordPress installation.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Choose your preferred editor (Gutenberg or Elementor).
- Navigate to the page you want to include a 3D model on or create a new one.
- Press the Edit page (Gutenberg) / Edit with Elementor (Elementor) button.
- Use the search option to include a new widget/block and search for Ultimate 3D Model Viewer.
- Place the provided widget/block into the content area.
- Customize different options according to your needs.

For the full documentation that includes the install process as well as all available configurations, please visit [pslzme.com](https://www.pslzme.com/en/plugins/ultimate-3d-model-viewer/wordpress).


== Frequently Asked Questions ==

= **What is the Ultimate 3D Model Viewer plugin?**=
Ultimate 3D Model Viewer is a powerful WordPress plugin that allows you to easily embed interactive 3D models into your website.


= **Which 3D model formats are supported?** =
The plugin currently supports the following formats:

    - .glb (binary glTF)

    - .gltf (GL Transmission Format)

    - .usdz (for iOS AR compatibility)


= **Can I use the plugin with Elementor or Gutenberg?** =
Yes! The plugin includes native support for both:

    - A dedicated widget for Elementor

    - A custom block for the Gutenberg editor

This makes it easy to add and customize 3D models without writing any code.


= **Is the plugin compatible with WooCommerce?** =
Absolutely. You can display 3D product models directly on WooCommerce product pages, giving your customers a highly interactive and immersive shopping experience.


= **Does it work on mobile devices?** =
Yes, the plugin is fully responsive and works seamlessly across all modern devices and screen sizes.


= **How can I upload a 3D model?** =
You can upload 3D files directly through the WordPress Media Library or via the block/widget interface. Make sure your file is in a supported format (.glb, .gltf, or .usdz) and within your server's upload limit.


= **How can I increase the maximum upload size for 3D files?** =
If you're having issues uploading large 3D files, you may need to:

    - Increase upload_max_filesize and post_max_size in your php.ini

    - Contact your hosting provider for assistance


= **Does the plugin support Augmented Reality (AR)?** =
Yes — with .usdz models, you can enable mobile AR views on compatible iOS devices.


= **What’s the difference between the Free and Premium versions?** =
The Free version includes all core features for basic embedding and viewing. The Premium version unlocks:

    - Custom loading screens

    - Exposure & tone mapping controls

    - Skybox customization

    - Shadow intensity and softness

    - Precise camera controls

    - Advanced lighting

    - Smart loading strategies

    - Full AR compatibility

    - ... and more


= **How do I upgrade to Premium?** =
You can upgrade directly through the plugin settings or by visiting our official site. Once activated, premium features are automatically unlocked in Gutenberg, Elementor and WooCommerce interfaces.


= **Are there translation or multilingual features?** =
Yes. The plugin is fully localized in English and German, including interface text and documentation.


= **Can I use this plugin on multiple sites?** =
The Free version can be used on unlimited sites. The Premium license is subject to the terms selected during purchase (single-site, multi-site, or developer license).


= **Where can I find documentation and support?** =
Full documentation is available here:
[https://www.pslzme.com/plugins/ultimate-3d-model-viewer/wordpress](https://www.pslzme.com/plugins/ultimate-3d-model-viewer/wordpress)

For technical support, use our [contact form](https://www.pslzme.com/en/login).


== Screenshots ==

1. Model viewer integration with included dimensions.
2. Seamless integration into WooCommerce.
3. Model without environment.
4. Model with environment.


== Changelog ==


= 1.0.0 =
* Initial release of the Ultimate 3D Model Viewer plugin
* Embed interactive 3D models in WordPress pages and products
* Full support for GLB, GLTF, and USDZ formats
* WooCommerce integration for 3D product previews
* Gutenberg and Elementor support
* Customizable settings
* Responsive design and multilingual support (EN/DE)
* Basic AR viewing on supported devices


= 1.0.1 =
* Bug fix that sometimes caused the plugin to crash on install 


= 1.0.2 =
* Bug fix that prevented multiple model viewers to render on a single page
* Changed the look of the loading bar for each model viewer