=== TryonX - AI Virtual Try-On for WooCommerce === Contributors: wpxero Donate link: https://wpxero.com Tags: woocommerce, virtual try-on, ai, fashion, clothing Requires at least: 5.6 Tested up to: 7.0 Requires PHP: 7.2 Stable tag: 1.1.1 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Let customers see how clothes look on them before buying. Powered by Google Gemini AI. == Description == TryonX lets your WooCommerce customers virtually try on clothing before purchasing. Powered by Google Gemini AI, it creates photorealistic visualizations that help reduce returns and increase purchase confidence. **Note:** Currently optimized for clothing and apparel products. Support for additional product types is coming in a future update. **Note:** Image generation requires a Google Gemini API key with access to the image generation model. As of the current Gemini API pricing, the image generation feature (`gemini-2.5-flash-image`) requires a paid API plan. Please review [Google AI Pricing](https://ai.google.dev/pricing) before use. = Features = * **AI Virtual Try-On** — Photorealistic clothing visualization using Google Gemini 2.5 Flash Image AI * **Session Management** — Upload once, try multiple products without re-uploading * **Comparison Tools** — Interactive before/after slider and side-by-side view * **Bulk Try-On** — Try multiple products from the same category instantly * **Social Sharing** — Share results on Facebook, Twitter, Pinterest, or download * **Analytics Dashboard** — Track try-on usage, top products, and daily trends via a WooCommerce dashboard widget * **Mobile-Friendly** — Fully responsive on all devices * **Developer-Friendly** — Hooks, filters, translation-ready, AJAX-powered = How It Works = 1. Customer uploads a photo on the product page 2. Google Gemini AI generates a realistic try-on visualization 3. Customer compares, shares, or tries more products — all without re-uploading == External services == This plugin connects to Google's Gemini AI API to generate virtual try-on images. **What data is sent:** * User-uploaded photos and product images are sent to Google's Gemini API when a customer clicks "Generate" * Images are converted to Base64 and transmitted via HTTPS * Data is only sent when the try-on feature is actively used **API endpoint:** `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image:generateContent` **Data handling:** * Temporary files are deleted after processing * Generated images are stored in your WordPress uploads directory * No data is permanently stored on Google's servers beyond their standard API retention policies Service provided by Google LLC: * [Google AI Terms of Service](https://ai.google.dev/terms) * [Google Privacy Policy](https://policies.google.com/privacy) == Installation == 1. Install and activate the plugin via **Plugins > Add New** 2. Go to **WooCommerce > Virtual Try-On** 3. Enter your Gemini API key from [Google AI Studio](https://aistudio.google.com/app/api-keys) (paid plan required for image generation) 4. Select which product categories should have the try-on feature 5. Save — customers can now use the "Try On" button on product pages == Frequently Asked Questions == = Is the plugin free? = The plugin itself is free. However, image generation requires a Google Gemini API key with a **paid plan** — the `gemini-2.5-flash-image` model used for virtual try-on is not available on the free tier. Please review [Google AI Pricing](https://ai.google.dev/pricing) for current rates. = What product types are supported? = Currently, TryonX is optimized for clothing and apparel products (shirts, jackets, dresses, etc.). Support for additional product types is planned for a future release. = The Try-On button doesn't appear = Ensure you've selected product categories in **WooCommerce > Virtual Try-On**, the product has a featured image, and WooCommerce is active. = Image generation fails = Verify your API key, ensure images are JPEG/PNG/WebP under 5MB, and check that your server can make outbound HTTPS requests. = Does this work on mobile? = Yes, fully responsive on mobile, tablet, and desktop. = Is this GDPR compliant? = Yes. Photos are processed only when the feature is used, session data expires after 24 hours, and temporary files are auto-deleted. == Screenshots == 1. Try-On button on product page 2. Photo upload modal 3. AI-generated try-on result 4. Before/after comparison slider 5. Bulk try-on product grid 6. Analytics dashboard 7. Admin settings == Changelog == #### 1.1.1 [April 15, 2026] - Improved: Compatibility with latest WordPress and WooCommerce versions #### 1.1.0 [March 10, 2025] - Added: Session management — upload once, try multiple products - Added: Before/after comparison (slider and side-by-side) - Added: Analytics dashboard and WooCommerce widget - Added: Bulk try-on for same-category products - Added: Social sharing and image download - Updated: Gemini 2.5 Flash Image model - Improved: Security, validation, and error handling - Improved: Mobile-first responsive design - Note: gemini-2.5-flash-image now requires a paid Google API plan #### 1.0.1 [December 15, 2024] - Fixed: Bug fixes and stability improvements #### 1.0.0 [November 20, 2024] - Initial release == Upgrade Notice == = 1.1.1 = Compatibility with latest WordPress and WooCommerce versions.