=== Touchtry FashionAR ===
Contributors: touchtry
Tags: ar, augmented reality, try on, woocommerce, fashion, virtual try on
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Touchtry FashionAR adds Touchtry-powered AR Try-On buttons to WooCommerce fashion products.

== Description ==

Touchtry FashionAR is a WooCommerce integration plugin for Touchtry FashionAR experiences.

It lets store owners connect WooCommerce products with Touchtry viewer links using either:
- a product-specific direct Touchtry viewer URL, or
- a Viewer Base URL + SKU / Item ID mapping

The plugin can display a Try-On button on:
- single product pages
- shop / archive / category product loops

Store owners can manage:
- global enable / disable behavior
- per-product enable / disable override
- external SKU / Item ID mapping
- direct viewer URL override
- admin panel URL
- viewer base URL
- query parameter mapping
- button label and design settings
- support and pricing links in admin

**Current Features**
- WooCommerce integration
- Single product page Try-On button
- Shop / category / loop Try-On button
- Global enable option
- Per-product enable / disable override
- Touchtry SKU / Item ID mapping
- Direct Touchtry viewer URL override
- Admin settings panel
- Admin panel open mode: iframe or new tab
- Trusted Touchtry URL validation for core settings
- Button styling controls

**How it works**
1. Configure your Touchtry Admin Panel URL and Viewer Base URL in plugin settings.
2. Open a WooCommerce product and enable Touchtry FashionAR for that product.
3. Add a Touchtry SKU / Item ID or an optional direct viewer URL.
4. Save the product.
5. The Try-On button will appear on supported WooCommerce pages.

**Important**
- This plugin is designed to work with Touchtry URLs.
- Viewer and admin panel links should be valid HTTPS Touchtry URLs.
- A usable AR path is required before the Try-On button can appear.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/touchtry-fashionAR/` directory, or install via the WordPress plugin uploader.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Make sure **WooCommerce** is installed and active.
4. Open **Touchtry FashionAR > Settings** in WordPress admin.
5. Add your **Admin Panel URL** and **Viewer Base URL**.
6. Edit a WooCommerce product and configure:
   - Enable Touchtry FashionAR
   - Touchtry SKU / Item ID, or
   - Direct Viewer URL
7. Save the product and test the Try-On button on the frontend.

== Frequently Asked Questions ==

= Does this require an app? =
No. It is intended for browser-based Touchtry viewer experiences.

= Does it work with WooCommerce? =
Yes. The plugin is built for WooCommerce products.

= Where does the Try-On button appear? =
It can appear on single product pages and also on shop / product loop views when the product is properly enabled and mapped.

= Can I use a direct viewer URL? =
Yes. A product-level direct Touchtry viewer URL can override the Viewer Base URL + SKU mapping.

= Can I enable Try-On for all products? =
Yes. A global enable setting is available, but the plugin still requires a usable AR path and supports per-product disable.

= Can I disable Try-On for a specific product? =
Yes. Each product has its own enable / disable control.

= What if I do not enter a Touchtry SKU / Item ID? =
If no external Touchtry SKU / Item ID is entered, the plugin can use the WooCommerce SKU when available.

= Does the plugin support iframe mode for the admin panel? =
Yes, but iframe mode depends on whether the remote admin panel allows framing. New tab mode is the recommended option.

== Screenshots ==

1. Touchtry FashionAR settings page
2. WooCommerce product-level FashionAR fields
3. Try-On button on single product page
4. Try-On button in WooCommerce product loop
5. Admin Panel page

== Changelog ==

= 1.2.1 =
* Improved plugin bootstrap structure.
* Added text domain loading.
* Centralized plugin version usage.
* Hardened Touchtry URL validation in settings.
* Hardened product direct viewer URL validation.
* Improved frontend button rendering logic.
* Improved safer global enable behavior.
* Added support for iframe / new tab admin panel handling.
* Updated documentation to match the current plugin feature set.

= 1.2.0 =
* Initial stable release.
* Added WooCommerce integration.
* Added AR Try-On button support.

== Upgrade Notice ==

= 1.2.1 =
Recommended update for improved settings validation, product mapping safety, and documentation alignment.

== Privacy ==

This plugin does not collect, store, or share personal user data on its own.

== External Services ==

This plugin may connect the store admin or shopper browser to external services configured by the store owner.

1. **Touchtry Viewer / Admin Panel**
- Used to open Touchtry viewer links and admin panel links configured in plugin settings or product fields.
- These requests are made directly by the browser when the admin or shopper opens a Touchtry link.
- Service provider: Touchtry
- Website: https://touchtry.com

2. **YouTube (optional)**
- A tutorial video embed URL may be used on the admin Home page.
- If enabled, the browser loads the video directly from YouTube.
- Terms: https://www.youtube.com/t/terms
- Privacy Policy: https://policies.google.com/privacy

== Credits ==

Developed by Touchtry
Support: mail@touchtry.com
Website: https://touchtry.com