=== Wingstech 3D Product Viewer Interactive ===
Contributors: wingstech
Tags: 3d viewer, interactive 3d, gltf, glb, ar model viewer
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 7.1
Stable tag: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display interactive 3D models and AR (Augmented Reality) experiences directly on your WordPress site.

== Description ==

**Wingstech 3D Product Viewer Interactive** allows you to upload, manage, and display interactive 3D models and Augmented Reality content with ease.  
Whether you're showcasing products, prototypes, artwork, or immersive visual experiences, this plugin provides an advanced yet simple-to-use interface.

Upload `.glb` or `.gltf` 3D models, customize viewer controls, and embed anywhere using a shortcode.

### Key Highlights

- Lightweight and highly optimized 3D viewer.
- AR Mode support (for compatible devices).
- Works with **GLB** and **GLTF** formats.
- Custom post type for 3D models.
- Real-time admin preview.
- Optional commercial add-on available for advanced features.

== Free Features ==

- Upload & manage `.glb` and `.gltf` models.
- Interactive 3D viewer with smooth navigation.
- Augmented Reality (AR) support.
- Auto-rotation toggle.
- “Place on Wall” view for AR mode.
- Background color customization.
- Zoom enable/disable.
- Fullscreen enable/disable.
- Drag interaction control.
- Loading optimization (lazy load, preload).
- Environment image & skybox support.
- Basic lighting controls:
  - Exposure
  - Shadow intensity
  - Shadow softness
- Camera controls:
  - Yaw (horizontal limit)
  - Pitch (vertical limit)
  - Min zoom
  - Field of view (FOV)

== Optional Commercial Add-on ==

The following features are provided by a separate commercial add-on plugin.  
The free version available on WordPress.org is fully functional and does not contain locked or disabled features.

### Advanced Animation Tools
- Autoplay animations
- Change animation speed
- Choose animation type
- Multi-animation support

### Professional Rendering Effects
- Outline effect (color, strength, smoothing)
- SSAO (Ambient Occlusion)
- Glitch effect
- SMAA anti-aliasing
- Bloom effect
- Pixelate effect
- Color grading

### Deep Visual Customization
- Outline color picker
- Detailed control sliders
- Combine multiple visual effects at once

### Plus:
- Priority support
- Premium updates & new features

== Installation ==

1. Upload the folder `wingstech-3d-product-viewer-interactive` to `/wp-content/plugins/`
2. Activate the plugin via **Plugins → Installed Plugins**
3. Go to **3D Models → Add New** and upload your 3D model
4. Use the shortcode below inside any post or page:

== Frequently Asked Questions ==

= How do I upload a 3D model? =  
1. Go to **3D Models** in WordPress  
2. Click **Add New**  
3. Upload your `.glb` or `.gltf` model  
4. Customize settings  
5. Use the shortcode to display it

= Which file formats are supported? =  
**GLB** and **GLTF**

= Does it support AR? =  
Yes! Enable AR Mode to allow users to view the model in augmented reality.

= What’s included in the Pro version? =  
Animations, post-processing effects, advanced rendering settings, and more.  
Available as a separate commercial add-on.

== Third Party Libraries ==

This plugin bundles the following open-source libraries:

1. three.js  
Source: https://github.com/mrdoob/three.js  
License: MIT  

2. model-viewer  
Source: https://github.com/google/model-viewer  
License: Apache 2.0  

3. QRCode.js  
Source: https://github.com/davidshimjs/qrcodejs  
License: MIT  

Some JavaScript and CSS files included in this plugin are minified for performance.  
The original, human-readable source code is publicly available at the links above.  
Build tools such as npm may be used to generate production-ready files.

== Screenshots ==

1. Add New 3D Model interface  
2. Real-time admin preview  
3. Pro feature settings (animations, effects)  
4. Frontend 3D model viewer

== Changelog ==

= 1.0.0 =
* Initial release of **Wingstech 3D Product Viewer Interactive**.

== Upgrade Notice ==

= 1.0.0 =
Initial public release.

== Acknowledgements ==
Developed with by [Wings Tech Solution](https://www.wingstechsolutions.com/).
