=== TryLoom - Virtual Try On for WooCommerce === Contributors: ToolTeek, dinethchamuditha Tags: woocommerce, virtual try-on, product visualization, e-commerce, fashion, AI, styling Requires at least: 5.6 Tested up to: 6.9 Stable tag: 1.0.5 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. * **Professional Consistency:** We automatically replace messy user backgrounds with a clean, high-end studio cyclorama (soft grey/white). Every try-on looks like a pro photoshoot. * **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. --- ### ๐Ÿ”ฅ POWERFUL FEATURES * **๐Ÿ“ธ AI Virtual Studio:** Our AI automatically removes cluttered backgrounds and generates a professional studio environment with perfect lighting. This ensures your product colors always look accurate, regardless of the user's original lighting. * **Smart Outfit Logic:** Automatically detects if a user needs a full outfit change (e.g., generating matching jeans if a user tries on a hoodie while wearing a dress). * **Fast Cloud Processing:** All heavy lifting happens on our secure cloud servers, ensuring your website stays lightning fast. * **Mobile Optimized:** A sleek, responsive popup that works perfectly on iPhone and Android devices. * **Fully Customizable:** Match your brand! Change button colors, placement, and theme (Light/Dark) directly from the settings. * **Usage Analytics:** Track how many customers are using the try-on feature directly from your WordPress dashboard. --- ### ๐Ÿ›๏ธ 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.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.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://tryloom.toolteek.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 API** (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 (hosted on `us-central1-try-on-proxy-by-toolteek.cloudfunctions.net`) * **Used For:** Authenticating the API connection (`/cloudConnection`) and performing AI image generation (`/fashionTryOn`). * **Data Sent:** Site URL, API credentials, product ID, product image, and the user's uploaded photo. * **Privacy Policy:** https://tryloom.toolteek.com/privacy-policy/ * **Terms and Conditions:** https://tryloom.toolteek.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**.