=== AR Model Viewer for WooCommerce ===
Contributors: racmanuel
Donate link: https://racmanuel.dev 
Tags: Augmented Reality, AR, Model Viewer, 3D, WooCommerce
Requires at least: 5.9
Tested up to: 6.6
Stable tag: 2.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The AR Model Viewer for WooCommerce plugin shows 3D models on your website and in augmented reality. Supports .glb and .gltf files.

== Description ==

The AR Model Viewer for WooCommerce is a versatile plugin designed to enhance your online store by displaying 3D models of your products. Customers can view these models in augmented reality (AR), providing an interactive and immersive shopping experience. The plugin supports 3D model files in .glb and .gltf formats and is incredibly easy to use.

Whether your website is an eCommerce platform or a WooCommerce-based store, the AR Model Viewer plugin seamlessly integrates to allow customers to explore your products in 3D and AR.

Now, with the power of meshy.ai, you can take your store to the next level! Generate 3D models simply by describing an object in text, creating stunning visuals effortlessly. In the PRO version, unlock the ability to convert an image into a 3D model, giving you unparalleled flexibility and creativity for showcasing your products.

Note: The API usage costs for meshy.ai are separate, but it includes a free plan with 200 credits per month, perfect for starting and experimenting with this powerful tool.

Start offering an extraordinary shopping experience today! 🚀

The **AR Model Viewer for WooCommerce** is the ultimate plugin for showcasing your products in 3D and AR. This plugin allows your customers to interact with your products in an immersive way, improving their shopping experience and increasing engagement.  

### Key Features ✨  

- **Display 3D Models Anywhere**: Showcase 3D models of your products on any part of your website using a simple shortcode.  
- **Augmented Reality Viewing**: Allow customers to view your 3D models in augmented reality for an immersive shopping experience.  
- **Broad File Format Support**: Compatible with **.glb** and **.gltf** file formats for seamless 3D model integration.  
- **Effortless WooCommerce Integration**: Easily integrates with WooCommerce to enhance your eCommerce platform.  
- **AI-Powered 3D Model Generation**: Create 3D models from images or text using the cutting-edge **meshy.ai API**, offering unparalleled convenience and creativity.  
- **Upload External 3D Files**: Use **.glb** files from external services like Sketchfab or any other source to quickly add 3D models to your store.  

### Why You Should Install This Plugin ✅  

- **Improve Customer Engagement**: Provide your customers with an interactive shopping experience that increases time spent on your store.  
- **Boost Conversion Rates**: Help customers make informed purchasing decisions by allowing them to visualize products in 3D and AR.  
- **Stay Ahead of the Competition**: Stand out in the eCommerce market by integrating innovative AR technology into your store.  
- **Easy to Use**: No advanced technical skills required; integrate and manage 3D models effortlessly.  
- **Flexible and Scalable**: Works perfectly for both small and large eCommerce businesses with WooCommerce.  
- **Free Credits for AI Features**: Start with 200 free credits per month to explore the potential of AI-powered 3D model generation.  
- **Seamless Integration**: Compatible with most WordPress themes and plugins, ensuring a smooth setup.  

### Pro Version 🚀  

Unlock the full potential of the AR Model Viewer for WooCommerce with the **Pro Version**, which includes additional premium features and support:  

- **Elementor Widget**: Display 3D models using a dedicated widget in Elementor.  
- **Bulk Import and Export**: Easily manage your 3D models by using the native WooCommerce importer/exporter.  
- **Generate 3D Models from Text Using AI**: Describe an object in text and let the AI create a 3D model for you.  
- **Generate 3D Models from Images Using AI**: Upload an image and convert it into a 3D model effortlessly.  
- **Exclusive Future Updates and Improvements**: Stay ahead with continuous updates and feature enhancements exclusive to Pro users.

### Pricing Plans 💰  

Choose the plan that best fits your needs:  

#### Single Site  
- **Monthly Price:** $9.99  
- **Annual Price:** $99.99 (Save 20%)  
- **Lifetime Price:** $299.99 (Equivalent to 3 years of annual pricing)  

#### Bulk Pricing  

**3 Sites**  
- **Monthly Price:** $17.99  
- **Annual Price:** $149.99  
- **Lifetime Price:** $499.99  

**Unlimited Sites**  
- **Monthly Price:** $59.99  
- **Annual Price:** $599.99  
- **Lifetime Price:** $1,729.99  

### Open Source and Community Contribution 🌟  

This plugin is an open-source project, and the code is available on GitHub:  
[https://github.com/racmanuel/ar-model-viewer-for-woocommerce](https://github.com/racmanuel/ar-model-viewer-for-woocommerce)  

We invite you to contribute to the project by suggesting improvements, fixing issues, or enhancing features for the free version. Together, we can make this plugin even better for the WordPress community!  

**Note:** The API usage costs for **meshy.ai** are separate, but it includes a free plan with **200 credits per month**, perfect for starting and experimenting with this powerful tool.  

## Try the plugin 👨🏻‍💻🎉

[Try with WordPress Playground](https://playground.wordpress.net/#ew0KICAgICIkc2NoZW1hIjogImh0dHBzOi8vcGxheWdyb3VuZC53b3JkcHJlc3MubmV0L2JsdWVwcmludC1zY2hlbWEuanNvbiIsDQogICAgInNpdGVPcHRpb25zIjogew0KICAgICAgICAiYmxvZ25hbWUiOiAiQVIgTW9kZWwgVmlld2VyIGZvciBXb29Db21tZXJjZSINCiAgICB9LA0KICAgICJzdGVwcyI6IFt7DQogICAgICAgICAgICAic3RlcCI6ICJpbnN0YWxsVGhlbWUiLA0KICAgICAgICAgICAgInRoZW1lWmlwRmlsZSI6IHsNCiAgICAgICAgICAgICAgICAicmVzb3VyY2UiOiAid29yZHByZXNzLm9yZy90aGVtZXMiLA0KICAgICAgICAgICAgICAgICJzbHVnIjogInN0b3JlZnJvbnQiDQogICAgICAgICAgICB9DQogICAgICAgIH0sDQogICAgICAgIHsNCiAgICAgICAgICAgICJzdGVwIjogImluc3RhbGxQbHVnaW4iLA0KICAgICAgICAgICAgInBsdWdpblppcEZpbGUiOiB7DQogICAgICAgICAgICAgICAgInJlc291cmNlIjogIndvcmRwcmVzcy5vcmcvcGx1Z2lucyIsDQogICAgICAgICAgICAgICAgInNsdWciOiAid29vY29tbWVyY2UiDQogICAgICAgICAgICB9DQogICAgICAgIH0sDQogICAgICAgIHsNCiAgICAgICAgICAgICJzdGVwIjogImluc3RhbGxQbHVnaW4iLA0KICAgICAgICAgICAgInBsdWdpblppcEZpbGUiOiB7DQogICAgICAgICAgICAgICAgInJlc291cmNlIjogIndvcmRwcmVzcy5vcmcvcGx1Z2lucyIsDQogICAgICAgICAgICAgICAgInNsdWciOiAiYXItbW9kZWwtdmlld2VyLWZvci13b29jb21tZXJjZSINCiAgICAgICAgICAgIH0NCiAgICAgICAgfSwNCiAgICAgICAgew0KCQkJInN0ZXAiOiAibG9naW4iLA0KCQkJInVzZXJuYW1lIjogImFkbWluIiwNCgkJCSJwYXNzd29yZCI6ICJwYXNzd29yZCINCgkJfQ0KICAgIF0sDQogICAgImxhbmRpbmdQYWdlIjogIi93cC1hZG1pbi9hZG1pbi5waHA/cGFnZT1hcl9tb2RlbF92aWV3ZXJfZm9yX3dvb2NvbW1lcmNlX3NldHRpbmdzIiwNCiAgICAicHJlZmVycmVkVmVyc2lvbnMiOiB7DQogICAgICAgICJwaHAiOiAiNy40IiwNCiAgICAgICAgIndwIjogIjYuNSINCiAgICB9LA0KICAgICJwaHBFeHRlbnNpb25CdW5kbGVzIjogWw0KICAgICAgICAia2l0Y2hlbi1zaW5rIg0KICAgIF0sDQogICAgImZlYXR1cmVzIjogew0KICAgICAgICAibmV0d29ya2luZyI6IHRydWUNCiAgICB9DQp9)

## Customization 🛠️

If you need any customization for the plugin, feel free to send me a message or visit my website: [https://racmanuel.dev](https://racmanuel.dev).

## Privacy Policy 🔒

AR Model Viewer for WooCommerce uses the Freemius SDK to collect telemetry data, but only with the user's explicit consent. This data collection helps us troubleshoot issues and improve our product.

- **No data is gathered by default.**
- Data collection only begins **after user consent via the admin notice**.
- Collected data ensures a great user experience.

Integrating the Freemius SDK **does not immediately start data collection without user confirmation**.

== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Upload the plugin files to the `/wp-content/plugins/plugin-name` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the Settings -> AR Model Viewer for WooCommerce screen to configure the plugin.
4. Start adding 3D models to your WooCommerce products using the custom metabox provided in the product edit screen.

== Frequently Asked Questions ==  

= Which file types are required for the 3D models/scenes? =  
GLTF (*.glb) files are required for the 3D preview in the browser and the AR scenes on Android devices. Apple devices, such as iPhone, iPad, or Apple Vision Pro, require **USDZ** (*.usdz) files to display AR content. AR Model Viewer for WooCommerce also adds support for **Reality** (*.reality) files for Apple devices.  

= Do I have to add models for Android and iOS? =  
To ensure that all visitors to your website can see the AR scenes, each scene must have a dedicated model in both formats (.glb, .usdz) for Android and iOS/Apple devices. However, only a GLTF file is required for the 3D preview in the browser.  

= What is meshy.ai, and how does it integrate with the plugin? =  
**meshy.ai** is an advanced AI platform that allows you to generate 3D models from text descriptions or images. The AR Model Viewer for WooCommerce integrates with **meshy.ai API**, enabling you to create stunning 3D models directly from your WooCommerce admin panel.  

= How do I use meshy.ai to generate 3D models? =  
After connecting your **meshy.ai** API key in the plugin settings, you can describe the object or upload an image, and the plugin will automatically generate the corresponding 3D model. You can then use the model in your WooCommerce store.  

= Are there additional costs for using meshy.ai? =  
Yes, meshy.ai operates on a credit-based system. However, you can start with a free plan that includes **200 credits per month**. If you exceed the free credits, you will need to purchase additional credits from **meshy.ai**.  

= Can I use the generated 3D models for both Android and iOS? =  
Yes! Once a model is generated using **meshy.ai**, you can convert it to GLTF (*.glb) for Android and USDZ (*.usdz) for iOS/Apple devices. The plugin also supports **Reality** (*.reality) files for Apple devices.  

= How secure is my data with meshy.ai? =  
meshy.ai follows strict security protocols to protect your data. Generated models and API requests are processed securely, and no sensitive information is shared or stored without your consent.  

= Where can I find the plugin documentation? =  
You can find comprehensive documentation and support resources here:  
- [WordPress Plugin Directory](https://wordpress.org/plugins/ar-model-viewer-for-woocommerce/)  
- [GitHub Repository](https://github.com/racmanuel/ar-model-viewer-for-woocommerce)  
- [Official Plugin Page](https://racmanuel.dev/ar-model-viewer-for-woocommerce/)  

= What happens if I run out of credits on meshy.ai? =  
If you exhaust your free credits, you can purchase additional credits directly from meshy.ai. The plugin will notify you when your credit balance is low.  

= Do I need technical knowledge to use meshy.ai? =  
Not at all! The integration is designed to be user-friendly. Simply describe your object or upload an image, and the AI takes care of the rest.  

= Can I use this plugin without meshy.ai? =  
Yes, the plugin fully supports manual upload of 3D models in GLTF, USDZ, and Reality formats. However, using meshy.ai adds powerful AI-driven features for generating 3D models from text or images.  

= Does the plugin support bulk uploads of models? =  
Yes, the **Pro Version** of the plugin includes a bulk import/export feature for managing multiple 3D models efficiently.  

= Is there support for Elementor? =  
Absolutely! The **Pro Version** includes a dedicated Elementor widget to display 3D models seamlessly on your website.  

= How can I contribute to the plugin? =  
This plugin is open source! You can contribute by suggesting improvements, fixing bugs, or adding new features via the GitHub repository:  
- [GitHub Repository](https://github.com/racmanuel/ar-model-viewer-for-woocommerce)  
We welcome all contributions from the community!  


== Mini-Tutorial: Getting Started ==

1. **Install and Activate**: Download and install the AR Model Viewer for WooCommerce plugin from the WordPress plugin repository.
2. **Configure Settings**: After activation, navigate to the Settings -> AR Model Viewer for WooCommerce screen to configure the basic settings for the plugin.
3. **Add 3D Models**: Go to the WooCommerce product edit page and locate the "AR Model Viewer" metabox to upload your .glb 3D models.
4. **Preview in AR**: Once uploaded, your 3D models will automatically be available for customers to view in augmented reality (AR) on compatible devices.

== Screenshots ==

== Changelog ==  

1.0.5 - Update the tested up to 6.5 and added Appsero  
1.0.6 - Update the tested up to 6.5 and added Appsero  
1.0.7 - Removed the Appsero SDK and added Freemius SDK, tested up to 6.6 version of WordPress, removed uninstall.php, and on plugin deactivation, delete_option('ar_model_viewer_for_woocommerce_settings').  
1.0.8 - Fix: Optional parameter $content declared before required parameter $tag is implicitly treated as a required parameter in ar-model-viewer-for-woocommerce/public/class-ar-model-viewer-for-woocommerce-public.php on line 107.  
1.0.9 - Add assets/blueprints/blueprint.json for execution in WordPress Playground, added one-click "Try Plugin" in README.  
2.0.0 - Major Update:  
  - Simplified 3D model upload process: No longer required to upload both .glb and .usdz files. A single **.glb** file is now sufficient for both Android and iOS/Apple devices.  
  - Code optimization for better performance and faster load times.  
  - Implemented **AJAX** for dynamic 3D model loading, enhancing user experience.  
  - Added new **modal windows** to preview 3D models directly within the admin panel.  
  - Improved user interface for easier model management and configuration.  
  - Compatibility updates to ensure seamless operation with the latest WordPress versions.  
  - Various bug fixes and minor improvements.  

== Upgrade Notice ==  

= 1.0.8 =  
Fixes an issue with optional parameters in function signatures for compatibility with PHP 8. This update is required to ensure compatibility with the latest version of WordPress.  

= 1.0.9 =  
Adds `assets/blueprints/blueprint.json` for execution in WordPress Playground and introduces a one-click "Try Plugin" feature in the README for easier testing.  

= 2.0.0 =  
Major update with significant improvements:  
- No longer required to upload both .glb and .usdz files. A single .glb file now supports Android and iOS/Apple devices.  
- Optimized code for better performance.  
- Introduced AJAX for dynamic 3D model loading.  
- Added new modal windows for previewing 3D models.  
- Enhanced compatibility with the latest WordPress versions.  

This version is highly recommended to simplify your workflow and improve user experience.