=== Reality shop - Unlimited 3D for Elementor and WooCommerce ===
Contributors: kouroshweb
Donate link: https://kouroshweb.com
Plugin URI: https://github.com/kouroshweb
Tags: AR, 3D product, Try-On, 360 product, 360 viewer
Requires at least: 5.5
Tested up to: 7.1
Stable tag: 2.0.18
Requires PHP: 7.4
License: GPL-3.0+
License URI: https://www.gnu.org/licenses/gpl-3.0.html

== Description ==

= Display Interactive 3D Models & 360° Product Views in WordPress — No Code Required =
Bring your products to life with <strong>Reality Shop 3D</strong>, a lightweight, performance-focused WordPress plugin for displaying interactive <strong>3D models and 360° product views</strong> anywhere on your website.
Whether you run a WooCommerce store, a portfolio, a product showcase, or a technical website, Reality Shop 3D lets your visitors rotate, zoom, and explore products from every angle—without writing code.
Upload GLB or USDZ models and create interactive product experiences on product pages, landing pages, custom layouts, popups, and more.
With Premium, you can take the experience further with advanced AR and try-on features.
<strong>Why Use 3D Product Visualization?</strong>
Static images can only show so much. Interactive 3D gives visitors a more complete way to explore and understand your products before they buy.
With Reality Shop 3D, you can:
• Let customers view products from every angle.
• Make detailed or complex products easier to understand.
• Create a more engaging product browsing experience.
• Showcase products interactively on product pages and landing pages.
• Reuse the same 3D model across multiple locations on your website.
• Help customers better understand the product before making a purchase.
= Why Reality Shop 3D? =
<strong>Interactive 3D for WordPress, Without the Complexity</strong>
Reality Shop 3D is built to make interactive 3D accessible to everyone.
You don't need to be a developer, use Elementor, or work with complicated custom code. Use the workflow that already fits your website.
<strong>WooCommerce is optional.</strong> Use Reality Shop 3D for e-commerce products, portfolios, marketing pages, technical documentation, and custom WordPress layouts.
<strong>Add 3D Your Way</strong>
Choose the method that works best for your website:
<strong>Elementor Widget</strong>
Use the dedicated 3D GLB Viewer Widget to add interactive 3D models directly to Elementor layouts.
<strong>Gutenberg Block</strong>
Add 3D models directly to posts, pages, and custom layouts using the included WordPress Block Editor block.
<strong>Shortcode</strong>
Use the shortcode to place your 3D models anywhere shortcodes are supported, including custom layouts and theme templates.
<strong>Elementor, Gutenberg, or shortcode—you choose how to display your 3D content.</strong>
<strong>Elementor 3D GLB Viewer Widget</strong>
= Add Interactive 3D to Elementor in Seconds =
Reality Shop 3D includes a dedicated Elementor 3D GLB Viewer Widget, making it easy to add interactive 3D models directly to your page designs.
Simply add the widget, select your 3D item, configure the viewer options, and publish.
Use it to create:
• Interactive WooCommerce product sections
• 3D product showcases
• Landing page experiences
• Product feature sections
• Portfolio presentations
• Custom marketing layouts
Configure options such as zoom, auto-rotate, lazy loading, and fullscreen directly from the Elementor editor.
<strong>No custom JavaScript. No complicated setup. Just add, configure, and publish.</strong>
= 3D Models for WooCommerce Product Variations =
One of the most powerful features of Reality Shop 3D is the ability to assign <strong>different 3D models to different WooCommerce product variations.</strong>
Instead of showing the same model for every option, you can display the model that matches the customer's selected product configuration.
For example, customers can select a different color, style, size, material, or configuration and view the corresponding 3D model.
This is especially useful for:
• Furniture with different colors or materials
• Customizable products
• Products with multiple configurations
• Different product styles or editions
• Products where appearance changes between variations
Give customers a closer look at the exact product configuration they are considering.
= Built for WooCommerce =
Give your WooCommerce store a more immersive product experience.
Reality Shop 3D lets you connect 3D models to individual WooCommerce products and variations, helping customers explore products in a more interactive way before purchasing.
Perfect for:
• Furniture and interior products
• Fashion and accessories
• Electronics and appliances
• Automotive products
• Jewelry and premium products
• 3D-printed products
• Industrial and technical products
• Any product where seeing it from every angle matters
= Designed for Performance =
Interactive 3D should enhance your website—not get in the way of it.
Reality Shop 3D includes performance-focused options such as:
• Lazy loading for 3D models
• Optional auto-rotation
• Zoom controls
• Fullscreen viewing
• Lightweight viewer implementation
• Minified plugin assets
Choose the viewer behavior that fits your website and balance interactivity with performance.
= How It Works =
Getting started takes just a few simple steps:
<strong>1. Upload your 3D model</strong>
Upload your GLB or USDZ files from the WordPress admin.
<strong>2. Create and manage your 3D item</strong>
Create an item and connect your model to a WooCommerce product, product variation, or use it independently.
<strong>3. Display it anywhere</strong>
Add the model using Elementor, Gutenberg, shortcode, popup, or your preferred WordPress layout.
<strong>4. Let visitors explore</strong>
Visitors can rotate, zoom, and view your products in fullscreen. Premium users can also add advanced AR and try-on experiences.
= Key Features =
• Assign a different 3D model to each WooCommerce product variation.
• Upload and manage GLB files from the WordPress admin.
• Support GLB and USDZ models.
• Assign 3D models to WooCommerce products using items.
• Dedicated Elementor 3D GLB Viewer Widget.
• Gutenberg block for the WordPress Block Editor.
• Shortcode support for flexible placement.
• Product default item fallback for shortcode usage.
• Copy and manage items from the WordPress admin.
• Automatically clean up related product items when a model is deleted.
• Zoom, auto-rotate, lazy loading, and fullscreen controls.
• Display 3D items in popups.
• Reuse the same 3D item across your website.
• Minified assets for a more optimized frontend.
• Remove all plugin data when the plugin is deactivated.
= Go Beyond 3D with Premium =
Want to create an even more immersive product experience?
Reality Shop 3D Premium adds advanced experiences such as:
• Augmented Reality (AR)
• Interactive try-on experiences
• More immersive ways for customers to visualize products before purchasing
Turn your website from a traditional product catalog into a more interactive shopping experience.
= Perfect For =
Reality Shop 3D is ideal for:
• WooCommerce product galleries and product detail pages
• E-commerce stores
• Product showcases
• Portfolios
• Marketing and landing pages
• Technical documentation
• Interactive product presentations
• Designers and creators with no coding experience
= Explore. Interact. Visualize. =
Give your visitors more than a static image.
Let them <strong>rotate, zoom, inspect, and experience your products in 3D</strong>—right on your WordPress website.
Ready to Add 3D to Your WordPress Website?
Upload your first 3D model and create an interactive product experience in minutes.
<strong>No coding. No complicated setup. Just interactive 3D.</strong>
Install Reality Shop 3D and start turning static product pages into immersive experiences.


** Compatibility: **

WordPress 5.5+ (tested up to the latest releases)
PHP 7.4+
Fully compatible with Elementor, Gutenberg, and WooCommerce out of the box.
Most popular themes and Pluginsincluding performance/speed such as wp rocket, litespeed cache, wp-optimize, ....  .

== Installation ==

1. Download the plugin zip file.
2. Upload it to your WordPress site via **Plugins > Add New > Upload Plugin**.
3. Activate the plugin through the **Plugins** menu in WordPress.
4. Navigate to **Reality Shop 3D** in the WordPress admin menu to manage your GLB files.
5. Use items or Elementor widgets to display 3D models.

== Frequently Asked Questions ==

= How 36o View by PNGs work? =
Upload as many as PNG photos you can, and show a 360 Product View by Woocoommerce, Elementor by using RealityShop 3D plugin.

= How do I upload a GLB file? =
Go to **Reality Shop 3D** in your WordPress dashboard, click "Upload File," and select your GLB model.

= How do I add 3D models into WooCommerce product? =
In the product edit page, find the **Reality Shop 3D Shortcode** metabox and paste the generated item.

= How many woocommerce products can I insert 3D modules? =
You are able to diplay unlimited 3D modules in your woocommerce products
= What amount of modules can I display? =
There are no limit for your 3D modules to display in your website

= What happens when I delete a GLB file? =
If a GLB file is deleted from the plugin's admin panel, all associated product items will be removed.

= Is this plugin Elementor compatible? =
Yes! You can use the **3D GLB Viewer** widget in Elementor to display models.

= Can I render the selected product item with a shortcode? =
Yes. Use `[reality_shop_3d]` on a product page or product template to render the item selected in that product. Use `[reality_shop_3d item_id="rs3d_xxx"]` to render a specific saved item.

= what themes/plugins are compatible? =
Almost all theme and products are well compatible with our plugin otherwise please contact us for support
== Screenshots ==

1. Admin panel for managing GLB/PNG files.
2. Adding a GLB/PNG item to a WooCommerce product.
3. Displaying a 3D model in Elementor.
4. Copying a item from the admin panel.

== Changelog ==
= 2.0.18 =
- Bug fixes
- 3D viewer loader
- Popup custom text

= 2.0.12 =
- Color variant for items
- Custom shortcode
- Bug fixes

= 2.0.2 =
- PNG 360 view improvements
- Elementor widget Improvement
- General lazy loading added
- Elementor Live Preview
- Security Update

= 2.0.0 = 
- Technology for a 360° Product View Using PNGs
- Responsive Controls in the Elementor Widget
- UX Improvements
- Security Improvements

= 1.8.9 =
- Ability to enable zoom.
- Ability to enable auto-rotate.
- Add lazy loading.
- Add full screen mode.

= 1.8.0 =
- Add block gutenberg.
- remove background 3D model.

= 1.7.3 =
- Add check box remove data.

= 1.7.2 =
- Add custom_item.

= 1.7.0 =
- Add table.
- Add light setting for 3D display.
- Add premium versions.
- Add settings.

= 1.6.1 =
- Added poll before deactivating the plugin
- Improved security and code optimization
- Send user feedback to email and Telegram

= 1.6 =
- Added automatic item removal from WooCommerce products.
- Improved Elementor widget with automatic product item detection.
- Added support for copying items from the admin panel.

= 1.5 =
- Introduced 3D GLB Viewer widget for Elementor.
- Improved UI for managing GLB files.

= 1.4 =
- Added WooCommerce integration with product item support.
- Improved file management system.

= 1.3 =
- Implemented item-based GLB file display.
- Enhanced admin panel functionality.

= 1.2 =
- Improved file upload handling.
- Added better MIME type support.

= 1.1 =
- Initial release with basic GLB file management.

== Upgrade Notice ==

= 1.6 =
Ensure you update your Elementor pages and WooCommerce products to take advantage of the latest item management features.

== License ==
This plugin is licensed under GPL-3.0+. For more details, visit:
https://www.gnu.org/licenses/gpl-3.0.html
