=== TryLoom - Virtual Try On for WooCommerce === Contributors: ToolTeek, dinethchamuditha Tags: woocommerce, virtual try-on, product visualization, e-commerce, fashion Requires at least: 5.6 Tested up to: 6.9 Stable tag: 1.2.2 Requires PHP: 7.2 WC requires at least: 5.0 WC tested up to: 10.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html The #1 AI-Powered Virtual Dressing Room for WooCommerce. Turn customer selfies into professional fashion model shots instantly. == Description == **GIVE YOUR CUSTOMERS THE "MODEL" EXPERIENCE.** **TryLoom** is not just a try-on tool; it is an **AI Fashion Studio** built directly into your WooCommerce store. Most customers take photos in bad lighting with messy backgrounds (bedrooms, bathrooms, etc.). **TryLoom fixes this.** Our advanced Generative AI takes your customer’s photo, dresses them in your product, and **transports them into a professional virtual studio**. The result? A high-end, consistent, and beautiful fashion photo that gives them the confidence to buy. ### 🚀 WHY STORE OWNERS CHOOSE TRYLOOM? * **Zero 3D Models:** Works with your standard flat-lay product images. No expensive 3D assets needed. * **Best of Both Worlds:** The only plugin that offers both Generative AI (for style & viral social content) and Strict Try-On (for accurate fit & realism). * **One-Click Setup:** Install, connect, and go. No complex configuration or developer knowledge required. * **Boost Confidence:** Help customers visualize the "vibe" and style of the product on themselves instantly. * **Unlimited Products:** TryLoom works on your entire catalog instantly, even on the free plan. --- ### 🔥 POWERFUL FEATURES * **Smart Auto-Routing** Our proprietary "AI Brain" analyzes every uploaded user photo. If it’s a selfie, it routes to **Studio Mode** to reconstruct the body. If it’s a full-body shot, it routes to **Try-On Mode** for maximum accuracy. * **Dual-Core AI Engine** * **Studio Mode:** Automatically fixes bad lighting, reconstructs missing body parts, and places the user in a pro photo studio. * **Try-On Mode:** Preserves the user’s original background and pose with 100% face consistency for a realistic "Fitting Room" experience. * **Generative Body Reconstruction** Customer uploaded a tight headshot? No problem. Our AI "paints in" the missing body parts so they can still see how the t-shirt or dress looks on them. * **Fast Cloud Processing** All heavy GPU tasks happen on our secure cloud servers, ensuring your website speed stays lightning fast (100% optimized for Core Web Vitals). * **Mobile Optimized Widget** A sleek, responsive popup designed for the "TikTok Generation." Works perfectly on iPhone and Android devices. * **Fully Customizable** Match your brand identity perfectly. Change button colors, text, and position (Before/After Add to Cart) directly from your dashboard settings. * **Usage Analytics** Track which products are getting "tried on" the most directly from your WordPress dashboard to understand customer intent and stock demand. --- ### 🛍️ PERFECT FOR EVERY FASHION STORE * **Apparel Brands:** T-shirts, Hoodies, Jackets, Coats. * **Boutiques:** Dresses, Skirts, Blouses, Tops. * **Streetwear:** Oversized fits, Graphic Tees. * **Accessories:** Hats, Caps, Shoes. --- ### 💡 SAAS CONNECTION This plugin acts as a connector to the **TryLoom Cloud Platform**. Because AI image generation requires immense computing power, it cannot run directly on your WordPress hosting. Instead, we process images on our specialized cloud GPUs. * A valid API connection (free or paid) is required for the plugin to function. * **Start for Free:** The plugin includes a free tier so you can test the magic immediately. No credit card required for the free trial. == Installation == 1. Upload the `tryloom` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the **Plugins** menu in WordPress. 3. Go to **Admin Menu → TryLoom** to configure the plugin. 4. Ensure WooCommerce is installed and active. 5. Click **"Start for Free"** to automatically connect to our cloud service (or enter your Pro key). = Manual Installation = 1. Download the plugin ZIP file. 2. In your WordPress dashboard, go to **Plugins → Add New → Upload Plugin**. 3. Upload the ZIP file and activate. == Frequently Asked Questions == = Do I need 3D models of my clothes? = **No!** That is the magic of TryLoom. We use Generative AI to interpret your standard 2D product photos (flat lay or mannequin). You do not need expensive 3D assets. = Why does the background change? = To ensure the best possible lighting and color accuracy for your products, TryLoom automatically places the user in a "Virtual Studio" setting. This removes distracting elements (like messy rooms) and ensures the focus remains 100% on your clothing. = Is it compatible with my theme? = Yes, TryLoom is designed to work with any standard WooCommerce theme. The "Try On" button automatically hooks into the product page. If you have a custom layout, you can use the `[tryloom]` shortcode to place it anywhere. = Does it work on mobile? = Absolutely. The popup interface is fully responsive and designed for a "thumb-friendly" mobile shopping experience. = Is it free? = The plugin is free to download and includes a Free Tier for the API service so you can test it out. For higher volume stores, we offer affordable subscription plans. = Where are user images stored? = Images are stored securely in a protected directory on your server (`wp-content/uploads/tryloom/`). They are not publicly accessible without authentication. You can disable the 'Enable Try On History' option at any time in the dashboard. == Screenshots == 1. **Product Page with Try-On Button** – “Try On” button on a WooCommerce product page. 2. **Try-On Popup** – User uploads photo and selects variation. 3. **Generated Result** – Virtual try-on image with download and retry options. 4. **Account Tab** – User manages saved photos and history. 5. **Admin Settings** – Configuration options in the WordPress dashboard. 6. **Dashboard Widget** – Usage statistics overview. == Changelog == = 1.2.2 = * Fix: Optimized asset loading logic to prevent script execution on non-product pages. * Update: Refactored wp_footer hooks with strict conditional checks for enhanced theme compatibility. * Fix: Resolved a JavaScript execution conflict that affected navigation menus on certain premium themes. * Improvement: Added defensive null-checks to the core initialization script to prevent global execution errors. = 1.2.1 = * Update: Migrated to new backend infrastructure for service continuity. * Fix: Updated all API endpoints to match new configuration. = 1.2.0 = * New: Implemented cloud status check endpoint for reliable usage tracking. * Update: Enhanced SSL verification for all API calls. * Fix: Added strict directory traversal protection for file handling. * Update: Optimized database queries for the dashboard and settings page. * Update: Improved image serving with binary streaming to reduce server memory usage. * Update: Switched to local hosting for Font Awesome icons (GDPR compliance). * Update: Refreshed "My Virtual Closet" pagination and layout. = 1.1.0 = * NEW: Added "Generation Mode" selector (Try-On, Studio, Auto). * NEW: "Studio Mode" now regenerates the background and lighting for professional results. * NEW: "Auto Mode" intelligently detects if the uploaded photo needs full studio processing. * UPDATE: Migrated API endpoint to US-Central1 for 3x faster generation speeds. * FIX: Critical update for backend connectivity. = 1.0.5 = * Fix: Updated external service documentation to match specific API domain. * Fix: Implemented late escaping for inline styles. * Fix: Replaced echo with readfile for binary image output. = 1.0.4 = * Security: Added nonce verification for GET requests (pagination and image protection). * Security: Fixed file path resolution to use wp_upload_dir() for all server setups. * Security: Added validation for local file paths before using WP_Filesystem. * Security: Sanitized custom CSS before adding inline styles. * Fix: Improved binary image data output with proper documentation. = 1.0.3 = * Security: Added nonce verification to all AJAX handlers and REST API endpoints. * Security: Implemented WP_Filesystem for safe file operations and remote requests. * Fix: Updated filter prefixes to avoid namespace conflicts. * Fix: Refactored file path resolution logic using WordPress standards. * Improved: Added detailed documentation for external API services. = 1.0.2 = * Fixed image loading issues in popup after generation. * Improved error handling and image fallback mechanisms. * Removed guest user option from allowed user roles. = 1.0.1 = * Fixed minor bug in try-on popup. * Improved image handling. = 1.0.0 = * Initial release: Core virtual try-on functionality, admin settings, user account integration, and API support. == Upgrade Notice == = 1.2.2 = Maintenance Update: Fixes a theme compatibility conflict involving navigation menus and optimizes site-wide performance by strictly isolating plugin assets to WooCommerce pages. Highly recommended for users of Minimog and other Elementor-based themes. = 1.2.1 = Critical Maintenance: Updates API endpoints for the new backend provider. Required for continued service operation. = 1.2.0 = Major update: Includes critical security hardening, GDPR compliance fixes, and significant performance improvements. Recommended for all users. = 1.1.0 = Major Update: Introduces new Generation Modes (Studio/Auto), 3x faster speeds, and critical backend fixes. = 1.0.5 = Bug fixes: Updated documentation, improved security with late escaping, and better binary image handling. = 1.0.4 = Security enhancements: Nonce verification for GET requests, improved file path handling, and CSS sanitization. = 1.0.3 = Security improvements, filesystem updates, and code compliance fixes. = 1.0.2 = Fixed image loading issues in popup. Improved error handling. = 1.0.1 = Minor bug fixes. No action required. = 1.0.0 = Initial release. == Support == For support, visit [ToolTeek Support](https://gettryloom.com/support) or open an issue on the WordPress plugin forum. == Privacy == This plugin handles user-uploaded images with care. Images are processed via a secure API and stored only as configured. Ensure your site’s privacy policy covers image uploads and processing. The plugin does **not share data with third parties** beyond the API used for generation. == External Services (API) == This plugin relies on the **TryLoom Cloud Platform** (maintained by ToolTeek) to function. Because AI image generation requires significant computational resources, it cannot run directly on your WordPress hosting environment. Instead, user images and product data are sent to our secure cloud infrastructure for processing and the result is returned to your site. * **Service:** TryLoom Cloud API & Status Check * **Hosts:** * `us-central1-tryloombytoolteek.cloudfunctions.net` (Image Generation) * `status-pdpuoxmr2a-uc.a.run.app` (Service Status & Usage) * **Used For:** Authenticating the API connection, checking plan usage/status, and performing AI image generation. * **Data Sent:** Site URL, API credentials, product ID, product image, and the user's uploaded photo. * **Privacy Policy:** https://gettryloom.com/privacy-policy/ * **Terms and Conditions:** https://gettryloom.com/terms-and-conditions/ == Credits == Developed by **ToolTeek**. Icons from **Font Awesome** (MIT/SIL OFL/CC BY 4.0 Licensed). Powered by the **TryLoom API**.