=== AI Virtual Try-On for WooCommerce ===
Contributors: replicatewp
Tags: woocommerce, ai, virtual-tryon, fashion, clothing
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered virtual try-on plugin for WooCommerce products using Replicate.com's IDM-VTON model.

== Description ==

Transform your WooCommerce store with AI-powered virtual try-on technology. Let customers visualize how clothing looks on different models before purchasing, increasing confidence and reducing returns.

This plugin integrates Replicate.com's advanced IDM-VTON AI model directly into your WooCommerce product workflow, allowing you to generate professional-quality virtual try-on images with just a few clicks.

= Key Features =

* 🤖 **AI-Powered** - Uses Replicate.com's advanced IDM-VTON model for realistic try-on visualization
* 👕 **Multiple Categories** - Full support for upper body, lower body, and dresses
* 🎨 **50 Default Models** - Diverse selection of male and female models included
* 🔍 **Category Filtering** - Filter models by garment category (upper body, lower body, dresses) for easy browsing
* 📸 **Custom Models** - Upload and use your own model images
* 🖼️ **Gallery Integration** - Add generated images directly to product galleries with one click
* ⚡ **Fast & Reliable** - Asynchronous processing with real-time status updates
* 🎯 **User-Friendly** - Intuitive admin interface built into product edit pages
* 📱 **Modern UI** - Clean, responsive design with inline notifications
* 📊 **Dashboard** - Centralized view of all generated images and generation history

= How It Works =

1. Select a garment image from your product images
2. Choose from 50 built-in diverse models or upload your own (filter by category for easy browsing)
3. Select the garment category (upper body, lower body, or dress)
4. Click generate and wait 1-5 minutes for AI processing
5. Preview the result and add it to your product gallery

= Use Cases =

* Generate lifestyle images for new products without photoshoots
* Show how clothing looks on different body types
* Create diverse marketing materials quickly and affordably
* Reduce product returns by helping customers visualize fit
* Scale your product imagery without expensive photo sessions

= Requirements =

* Active WooCommerce installation
* Replicate.com API key (sign up at replicate.com)
* Products with clear garment images

== Installation ==

= Automatic Installation =

1. Log in to your WordPress dashboard
2. Navigate to Plugins → Add New
3. Search for "AI Virtual Try-On for WooCommerce"
4. Click "Install Now" and then "Activate"
5. Go to Virtual Try-On → Settings and add your Replicate API key

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress dashboard
3. Navigate to Plugins → Add New → Upload Plugin
4. Choose the ZIP file and click "Install Now"
5. Click "Activate Plugin"
6. Go to Virtual Try-On → Settings and add your Replicate API key

= After Installation =

1. Navigate to **Virtual Try-On → Settings**
2. Enter your Replicate API key (get one at replicate.com)
3. Configure default generation parameters (optional)
4. Click "Test API Connection" to verify setup
5. Start generating virtual try-on images from any product edit page!

== Frequently Asked Questions ==

= Do I need a Replicate.com API key? =

Yes, this plugin requires a Replicate.com API key to function. You can sign up for a free account at replicate.com and get your API key from the dashboard. Replicate charges per API usage.

= How much does it cost to generate images? =

The plugin itself is free, but Replicate.com charges approximately $0.01-0.02 per image generation. Pricing may vary, so check replicate.com for current rates.

= What image formats are supported? =

The plugin supports standard image formats including JPG, PNG, and WebP for both garment and model images.

= Can I use my own model images? =

Yes! While the plugin includes 50 diverse default models, you can upload and use your own model images. Models should be clear, full-body or upper-body shots on clean backgrounds.

= How long does it take to generate an image? =

Generation typically takes 1-5 minutes depending on Replicate.com's server load and image complexity. The process runs asynchronously, so you can continue working while it generates.

= What garment categories are supported? =

Currently supports:
* Upper body (shirts, t-shirts, sweaters, jackets)
* Lower body (pants, shorts, skirts)
* Dresses (full-body garments)

= Can I add generated images to my product gallery? =

Yes! Once an image is generated, you can add it to your product's gallery with a single click directly from the generation interface or from the Dashboard.

= What happens if generation fails? =

If generation fails, you'll see an error message. Common issues include invalid API keys, unsupported image types, or Replicate.com service issues. Check the error message for details.

= Is there a limit to how many images I can generate? =

There's no limit imposed by the plugin. Your only limitation is your Replicate.com account usage and budget.

= Can I use this for products other than clothing? =

The AI model is specifically trained for garment try-on and works best with clothing items. Using it for other product types may produce unpredictable results.

== Screenshots ==

1. Example of AI-generated virtual try-on results - clothing image to model wearing clothing
2. Model selection popup with diverse models and category filtering
3. Model configuration options and generation parameters after selecting a model
4. Dashboard showing all generated images with filtering and management options
5. Settings page with API configuration and connection testing

== Changelog ==

= 1.0.2 =
* Improved API key sanitization to preserve special characters in tokens
* Added whitelist validation for category field
* Added range validation for steps parameter

= 1.0.1 =
* Fixed privacy policy description for clarity
* Fixed support forum URL placeholder
* Added Requires Plugins header for WooCommerce dependency
* Verified text domain consistency throughout plugin

= 1.0.0 =
* Initial release
* AI-powered virtual try-on using Replicate.com's IDM-VTON model
* 50 built-in diverse model images
* Category filtering for easy model browsing (upper body, lower body, dresses)
* Support for upper body, lower body, and dresses
* Full body models work for both upper and lower body garments
* Custom model upload capability
* Product gallery integration
* Centralized dashboard for generated images
* Real-time generation status updates
* API connection testing
* Asynchronous image generation

== Upgrade Notice ==

= 1.0.2 =
Security improvements in settings sanitization.

= 1.0.1 =
Bug fixes and documentation improvements.

= 1.0.0 =
Initial release of AI Virtual Try-On for WooCommerce.

== Support ==

For support, please contact: support@replicatewp.com

Or visit our support forum at: https://wordpress.org/support/plugin/ai-virtual-try-on-for-woocommerce/

== Credits ==

* Powered by Replicate.com
* IDM-VTON Model by cuuupid
* Developed by ReplicateWP
* Model images from Freepik.com

== Additional Information ==

= Privacy Policy =

This plugin integrates with Replicate.com's AI service to generate virtual try-on images. When you use this plugin to generate images, only the product images (garment images and model images) that you select are sent to Replicate.com for processing. No personal customer information, user data, or any other data is transmitted to external services. Please review Replicate.com's privacy policy and terms of service for information about how they handle the images you send.

= API Usage =

This plugin makes API calls to replicate.com. By using this plugin, you agree to Replicate.com's terms of service and pricing structure.

