=== TryOn Live - Virtual Try-On ===
Contributors: tryonlive
Tags: virtual try-on, woocommerce, fashion, ai, clothing
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds an AI "virtual try-on" button to WooCommerce product pages so customers can see a garment on their own photo.

== Description ==

TryOn Live adds a "Virtual Try-On" button to your WooCommerce product pages. A customer uploads a photo (or takes one with the camera), and within seconds sees the product garment on themselves.

افزونه TryOn Live دکمه «پرو مجازی» را به صفحه محصولات ووکامرس اضافه می‌کند. مشتری عکس خود را آپلود می‌کند یا با دوربین می‌گیرد و چند ثانیه بعد لباس را روی خودش می‌بیند.

Features:

* Per-product setup: enable try-on, garment type (upper body, lower body, full body), a short note for the AI and up to 5 garment photos (main reference + details).
* Bulk enable/disable from the products list.
* Upload from gallery or take a photo with the device camera; photos are resized in the browser and EXIF data (location, device) is stripped before upload.
* Option to allow everyone or only logged-in customers.
* Daily limit per customer/visitor to protect your credit.
* Reports in WordPress admin: requests, success rate, most tried products and add-to-cart after try-on. No photos are stored.
* Button text, color and position settings, plus a `[tryonlive_button]` shortcode for page builders.

= Privacy =

* The customer photo is never saved on your WordPress site or in the media library.
* On the TryOn Live server the customer photo is deleted immediately after processing, and the result image is deleted as soon as it has been shown to the customer (and in any case within 24 hours).
* The shop owner never sees customer photos or results.

= External service =

This plugin relies on the TryOn Live service (https://www.tryonlive.ir) to generate try-on images. When a customer requests a try-on, the customer photo, the product garment photos, the garment type/note and the product ID/name are sent to `https://www.tryonlive.ir/api/v1`. An account and API token from TryOn Live are required.

* Service: https://www.tryonlive.ir
* Terms of use and privacy policy: https://www.tryonlive.ir/privacy

== Installation ==

1. Upload the plugin through Plugins → Add New → Upload Plugin, or extract it into `/wp-content/plugins/tryonlive`.
2. Activate the plugin. WooCommerce must be active.
3. Create a shop of type "WordPress plugin" in your TryOn Live panel and copy the API token and webhook secret.
4. Go to TryOn Live → Settings in WordPress admin, paste the token and secret and click "Test connection".
5. Edit a product, enable "Virtual try-on" in the TryOn Live box, choose the garment type and save.

== Frequently Asked Questions ==

= The button does not appear on the product page =

Make sure the plugin is enabled, the API token is set, try-on is enabled for the product and the product has a featured image. When logged in as a shop manager, a small diagnostic box on the product page explains what is missing.

= Is credit used when a try-on fails? =

No. Credit is returned automatically for failed requests.

= My site uses a page cache =

Exclude product pages from the page cache, or make sure cached pages are refreshed at least every 12 hours, so the security nonce used by the try-on button stays valid.

== Changelog ==

= 1.0.7 =
* Text domain now matches the plugin slug (tryon-live-virtual-try-on).
* All database queries use $wpdb->prepare() with identifier placeholders; requires WordPress 6.2+.

= 1.0.6 =
* Fully translatable: English source strings with a bundled Persian (fa_IR) translation.
* Modal layout follows the site text direction (RTL or LTR).

= 1.0.5 =
* Escaped all admin and front-end output and sanitized all request input (WordPress coding standards).
* Declared the WooCommerce dependency in the plugin header.

= 1.0.4 =
* Garment photos are sent as files, so try-on works on hosts that block outgoing/incoming foreign traffic.
* API address defaults to https://www.tryonlive.ir/api/v1.

= 1.0.2 =
* First public release.
