{"id":241111,"date":"2025-09-14T15:51:55","date_gmt":"2025-09-14T15:51:55","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/try-on\/"},"modified":"2026-05-15T13:53:52","modified_gmt":"2026-05-15T13:53:52","slug":"tryonx","status":"publish","type":"plugin","link":"https:\/\/mk.wordpress.org\/plugins\/tryonx\/","author":21159831,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"6.8.5","requires":"5.6","requires_php":"7.2","requires_plugins":null,"header_name":"TryonX - AI Virtual Try-On for WooCommerce","header_author":"WPXERO","header_description":"Adds virtual try-on functionality to WooCommerce product pages using Gemini AI.","assets_banners_color":"8370b5","last_updated":"2026-05-15 13:53:52","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wpxero.com","header_plugin_uri":"https:\/\/wpxero.com\/plugins\/tryonx","header_author_uri":"https:\/\/wpxero.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":735,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"wpxero","date":"2025-09-14 15:51:32"},"1.0.1":{"tag":"1.0.1","author":"wpxero","date":"2025-10-02 06:54:58"},"1.1.0":{"tag":"1.1.0","author":"wpxero","date":"2026-03-10 15:19:08"},"1.1.1":{"tag":"1.1.1","author":"wpxero","date":"2026-04-15 13:28:56"},"1.2.0":{"tag":"1.2.0","author":"wpxero","date":"2026-05-15 13:53:52"}},"upgrade_notice":{"1.2.0":"<p>Major release: per-product settings, shortcode, privacy controls, variable products, add to cart, and critical fixes for theme compatibility and result image URLs. Generate a new try-on after updating.<\/p>","1.1.1":"<p>Compatibility with latest WordPress and WooCommerce versions.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3533070,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3533070,"resolution":"256x256","location":"assets","locale":"","width":250,"height":250}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3533070,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3533070,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.1.0","1.1.1","1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Try On button on WooCommerce single product page \u2014 ready for shoppers","2":"AI virtual try-on modal \u2014 upload photo and generate with Gemini","3":"Photorealistic try-on result with download, share, and add to cart","4":"Before and after comparison slider \u2014 interactive fit preview","5":"Try more products grid \u2014 bulk virtual try-on in one session","6":"Try-on analytics dashboard \u2014 track engagement and top products","7":"Admin settings \u2014 API key, categories, privacy, and display options"}},"plugin_section":[262246],"plugin_tags":[263073,263074,256250,148223,286],"plugin_category":[45],"plugin_contributors":[223308],"plugin_business_model":[],"class_list":["post-241111","plugin","type-plugin","status-publish","hentry","plugin_section-dashboard-widgets","plugin_tags-ai-fashion","plugin_tags-clothing-store","plugin_tags-try-before-you-buy","plugin_tags-virtual-try-on","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-wpxero","plugin_committers-wpxero"],"banners":{"banner":"https:\/\/ps.w.org\/tryonx\/assets\/banner-772x250.jpg?rev=3533070","banner_2x":"https:\/\/ps.w.org\/tryonx\/assets\/banner-1544x500.jpg?rev=3533070","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tryonx\/assets\/icon-128x128.jpg?rev=3533070","icon_2x":"https:\/\/ps.w.org\/tryonx\/assets\/icon-256x256.jpg?rev=3533070","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>Turn your WooCommerce store into an AI fitting room.<\/strong><\/p>\n\n<p>TryonX adds a <strong>\u201cTry On\u201d<\/strong> button to product pages so customers upload a photo and instantly see how your apparel looks on them \u2014 powered by <strong>Google Gemini 2.5 Flash Image AI<\/strong>. No app. No custom theme rebuild. Install, connect your API key, and start offering <strong>virtual try-on for WooCommerce<\/strong> in minutes.<\/p>\n\n<p>Shoppers buy with confidence. You sell more. Returns drop. That is the promise of <strong>AI try-on for online fashion<\/strong> \u2014 and TryonX brings it to WordPress stores of every size.<\/p>\n\n<h4>Why WooCommerce stores install TryonX<\/h4>\n\n<ul>\n<li><strong>Higher conversion<\/strong> \u2014 Customers who visualize a fit are more likely to add to cart.<\/li>\n<li><strong>Fewer \u201cwill it fit?\u201d doubts<\/strong> \u2014 Answer the #1 question in fashion e-commerce before checkout.<\/li>\n<li><strong>Lower return rates<\/strong> \u2014 Better expectations mean fewer size and style surprises.<\/li>\n<li><strong>Shareable moments<\/strong> \u2014 Results can be shared on social media; your products get organic reach.<\/li>\n<li><strong>Works on mobile<\/strong> \u2014 Most fashion traffic is mobile; TryonX is built mobile-first.<\/li>\n<li><strong>Analytics built in<\/strong> \u2014 See which products get the most try-ons and measure engagement.<\/li>\n<\/ul>\n\n<h4>Who is this plugin for?<\/h4>\n\n<ul>\n<li><strong>Fashion &amp; apparel<\/strong> WooCommerce stores (tees, hoodies, dresses, jackets, activewear)<\/li>\n<li><strong>Boutiques &amp; DTC brands<\/strong> that want a premium, interactive product experience<\/li>\n<li><strong>Agencies<\/strong> building modern WooCommerce sites with Elementor, Divi, or block themes<\/li>\n<li><strong>Merchants<\/strong> ready to differentiate with <strong>AI-powered virtual fitting<\/strong> without enterprise pricing<\/li>\n<\/ul>\n\n<h4>Key features<\/h4>\n\n<ul>\n<li><strong>AI virtual try-on<\/strong> \u2014 Photorealistic garment visualization with Google Gemini 2.5 Flash Image<\/li>\n<li><strong>One photo, many products<\/strong> \u2014 Session memory: upload once, try your whole catalog category<\/li>\n<li><strong>Bulk try-on<\/strong> \u2014 \u201cTry more products\u201d grid suggests similar items customers can test instantly<\/li>\n<li><strong>Before \/ after compare<\/strong> \u2014 Slider and side-by-side views to wow shoppers<\/li>\n<li><strong>Add to cart from results<\/strong> \u2014 Close the loop from try-on to purchase in one click<\/li>\n<li><strong>Variable products<\/strong> \u2014 Supports variations (size, color) with the correct garment image<\/li>\n<li><strong>Per-product controls<\/strong> \u2014 Enable\/disable try-on per product + custom flat-lay garment image<\/li>\n<li><strong>Shortcode<\/strong> \u2014 <code>[tryonx]<\/code> or <code>[tryonx product_id=\"123\"]<\/code> for landing pages and builders<\/li>\n<li><strong>Privacy-ready<\/strong> \u2014 Consent checkbox, rate limits, optional login-only, IP anonymization<\/li>\n<li><strong>Analytics dashboard<\/strong> \u2014 Try-on counts, success rate, top products, daily chart, WP dashboard widget<\/li>\n<li><strong>Theme-friendly<\/strong> \u2014 Compatible with Hello Elementor, Divi, and stores where <code>global $product<\/code> varies<\/li>\n<li><strong>Developer hooks<\/strong> \u2014 Filters and actions for custom integrations<\/li>\n<\/ul>\n\n<h4>How virtual try-on works (3 steps)<\/h4>\n\n<ol>\n<li><strong>Shopper uploads a photo<\/strong> on your WooCommerce product page (JPEG, PNG, or WebP).<\/li>\n<li><strong>TryonX sends the photo + product image to Gemini AI<\/strong> and generates a realistic try-on result.<\/li>\n<li><strong>Customer compares, downloads, shares, or adds to cart<\/strong> \u2014 then tries more products without re-uploading.<\/li>\n<\/ol>\n\n<h4>Setup in under 5 minutes<\/h4>\n\n<ol>\n<li>Install TryonX and activate WooCommerce.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Virtual Try-On<\/strong>.<\/li>\n<li>Paste your <a href=\"https:\/\/aistudio.google.com\/app\/api-keys\">Google AI Studio<\/a> API key.<\/li>\n<li>Select clothing categories (or enable per product).<\/li>\n<li>Publish \u2014 the <strong>Try On<\/strong> button appears on eligible products.<\/li>\n<\/ol>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WordPress 5.6+ and <strong>WooCommerce<\/strong> (required)<\/li>\n<li>PHP 7.2+<\/li>\n<li>Google Gemini API key with access to <strong>gemini-2.5-flash-image<\/strong> (paid plan required for image generation \u2014 see <a href=\"https:\/\/ai.google.dev\/pricing\">Google AI Pricing<\/a>)<\/li>\n<li>Outbound HTTPS from your server to Google\u2019s API<\/li>\n<li>Product featured image (or custom garment image per product)<\/li>\n<\/ul>\n\n<p><strong>Best for:<\/strong> Clothing and apparel. Other product types may be supported in future updates.<\/p>\n\n<h4>Use TryonX anywhere<\/h4>\n\n<ul>\n<li>Single product pages (automatic button)<\/li>\n<li>Custom pages via shortcode: <code>[tryonx product_id=\"42\"]<\/code><\/li>\n<li>Category-driven enablement for entire collections<\/li>\n<li>Optional custom garment photo per SKU for flat-lay or model shots<\/li>\n<\/ul>\n\n<p><strong>Note:<\/strong> Image generation uses Google\u2019s Gemini API. You control your API key and usage costs. Photos are processed only when a customer clicks Generate.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to <strong>Google\u2019s Gemini AI API<\/strong> to generate virtual try-on images when a shopper uses the feature.<\/p>\n\n<p><strong>What data is sent:<\/strong><\/p>\n\n<ul>\n<li>The customer\u2019s uploaded photo and the WooCommerce product (garment) image<\/li>\n<li>Data is sent only when the customer clicks <strong>Generate<\/strong><\/li>\n<li>Images are transmitted over HTTPS (Base64 in the API request)<\/li>\n<\/ul>\n\n<p><strong>API endpoint:<\/strong> <code>https:\/\/generativelanguage.googleapis.com\/v1beta\/models\/gemini-2.5-flash-image:generateContent<\/code><\/p>\n\n<p><strong>Data handling:<\/strong><\/p>\n\n<ul>\n<li>Temporary processing files are deleted after use<\/li>\n<li>Generated try-on images are saved in your WordPress <code>uploads<\/code> folder<\/li>\n<li>Session photos expire after 24 hours<\/li>\n<li>Google\u2019s retention policies apply to API requests \u2014 see their terms below<\/li>\n<\/ul>\n\n<p><strong>Service provider:<\/strong> Google LLC<\/p>\n\n<ul>\n<li><a href=\"https:\/\/ai.google.dev\/terms\">Google AI Terms of Service<\/a><\/li>\n<li><a href=\"https:\/\/policies.google.com\/privacy\">Google Privacy Policy<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin or install from <strong>Plugins \u2192 Add New<\/strong>.<\/li>\n<li>Activate <strong>TryonX<\/strong> and ensure <strong>WooCommerce<\/strong> is active.<\/li>\n<li>Open <strong>WooCommerce \u2192 Virtual Try-On<\/strong>.<\/li>\n<li>Enter your Gemini API key from <a href=\"https:\/\/aistudio.google.com\/app\/api-keys\">Google AI Studio<\/a>.<\/li>\n<li>Check the product categories that should show <strong>Try On<\/strong> (e.g. Clothing, T-Shirts).<\/li>\n<li>Visit a product page, upload a test photo, and click <strong>Generate<\/strong>.<\/li>\n<\/ol>\n\n<p><strong>Pro tip:<\/strong> Edit any product \u2192 <strong>Product data \u2192 Virtual Try-On<\/strong> to force-enable try-on or upload a dedicated garment image for better AI results.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20is%20the%20best%20virtual%20try-on%20plugin%20for%20woocommerce%3F\"><h3>What is the best virtual try-on plugin for WooCommerce?<\/h3><\/dt>\n<dd><p>TryonX is built specifically for WooCommerce fashion stores. It combines Gemini AI image generation, session-based multi-product try-on, comparison tools, analytics, add-to-cart on results, and per-product controls \u2014 without requiring a separate SaaS subscription beyond your Google API usage.<\/p><\/dd>\n<dt id=\"how%20do%20i%20add%20virtual%20try-on%20to%20my%20woocommerce%20store%3F\"><h3>How do I add virtual try-on to my WooCommerce store?<\/h3><\/dt>\n<dd><p>Install TryonX, add your Gemini API key under <strong>WooCommerce \u2192 Virtual Try-On<\/strong>, enable your apparel categories, and the <strong>Try On<\/strong> button appears on product pages. Use <code>[tryonx]<\/code> on any page for custom placement.<\/p><\/dd>\n<dt id=\"does%20tryonx%20work%20with%20elementor%2C%20divi%2C%20and%20block%20themes%3F\"><h3>Does TryonX work with Elementor, Divi, and block themes?<\/h3><\/dt>\n<dd><p>Yes. TryonX hooks into standard WooCommerce product templates and includes theme compatibility helpers for stores where the global product object may be a slug or ID (Hello Elementor, Divi, etc.).<\/p><\/dd>\n<dt id=\"is%20tryonx%20free%3F\"><h3>Is TryonX free?<\/h3><\/dt>\n<dd><p>The plugin is free to install. Virtual try-on image generation requires a <strong>paid Google Gemini API plan<\/strong> for the <code>gemini-2.5-flash-image<\/code> model. Review <a href=\"https:\/\/ai.google.dev\/pricing\">Google AI Pricing<\/a> for current rates.<\/p><\/dd>\n<dt id=\"what%20products%20work%20with%20ai%20try-on%3F\"><h3>What products work with AI try-on?<\/h3><\/dt>\n<dd><p>Clothing and apparel work best: t-shirts, hoodies, dresses, jackets, and similar items with a clear garment image. Enable by category or per product. Upload a custom <strong>garment image<\/strong> in the product editor for flat-lay or model photos.<\/p><\/dd>\n<dt id=\"will%20this%20help%20reduce%20woocommerce%20returns%3F\"><h3>Will this help reduce WooCommerce returns?<\/h3><\/dt>\n<dd><p>Virtual try-on helps customers set realistic expectations before purchase, which can reduce fit-related returns. Results vary by store, catalog, and customer base \u2014 use built-in analytics to track try-on volume and top products.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20mobile%20phones%3F\"><h3>Does it work on mobile phones?<\/h3><\/dt>\n<dd><p>Yes. The try-on modal is fully responsive for mobile, tablet, and desktop \u2014 where most fashion shoppers browse.<\/p><\/dd>\n<dt id=\"can%20customers%20try%20multiple%20products%20with%20one%20photo%3F\"><h3>Can customers try multiple products with one photo?<\/h3><\/dt>\n<dd><p>Yes. After the first successful try-on, their photo is saved for 24 hours so they can try other products in the same session or from the <strong>Try More Products<\/strong> grid without uploading again.<\/p><\/dd>\n<dt id=\"is%20tryonx%20gdpr-friendly%3F\"><h3>Is TryonX GDPR-friendly?<\/h3><\/dt>\n<dd><p>TryonX includes optional photo consent text, session expiry (24 hours), automatic cleanup of old session files, rate limiting, and optional IP anonymization in analytics. You remain responsible for your store\u2019s privacy policy and lawful basis for processing customer photos.<\/p><\/dd>\n<dt id=\"the%20try%20on%20button%20does%20not%20show%20on%20my%20product%20page\"><h3>The Try On button does not show on my product page<\/h3><\/dt>\n<dd><p>Check that: (1) WooCommerce is active, (2) the product\u2019s category is enabled in plugin settings or the product is set to <strong>Enabled<\/strong> under Virtual Try-On, (3) the product has a featured or garment image, and (4) you are viewing a single product page.<\/p><\/dd>\n<dt id=\"try-on%20generation%20failed%20or%20timed%20out\"><h3>Try-on generation failed or timed out<\/h3><\/dt>\n<dd><p>Confirm your Gemini API key is valid, your plan includes image generation, images are under 5MB (JPEG\/PNG\/WebP), and your host allows outbound HTTPS. Large images or slow servers may need a longer timeout \u2014 contact your host if timeouts persist.<\/p><\/dd>\n<dt id=\"can%20i%20embed%20try-on%20on%20a%20landing%20page%3F\"><h3>Can I embed try-on on a landing page?<\/h3><\/dt>\n<dd><p>Yes. Use the shortcode <code>[tryonx product_id=\"123\"]<\/code> replacing <code>123<\/code> with your product ID, or <code>[tryonx]<\/code> on a product page to use the current product.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.0 [May 15, 2026]<\/h4>\n\n<ul>\n<li>Added: Per-product try-on settings and custom garment image (WooCommerce product tab)<\/li>\n<li>Added: <code>[tryonx]<\/code> shortcode for landing pages and custom layouts<\/li>\n<li>Added: Privacy controls \u2014 consent checkbox, rate limiting, login-only mode, IP anonymization<\/li>\n<li>Added: Add to cart button on try-on results<\/li>\n<li>Added: Variable product variation selector in the modal<\/li>\n<li>Added: <code>TRYONX_Helpers::resolve_product()<\/code> and <code>get_single_product()<\/code> for reliable product detection across themes<\/li>\n<li>Added: <code>TRYONX_Helpers::upload_file_url()<\/code> for correct public file URLs<\/li>\n<li>Fixed: Fatal error on product pages when themes set <code>global $product<\/code> to a slug string (Elementor, Hello Elementor, Divi, and similar)<\/li>\n<li>Fixed: Generated try-on result images showing as broken \u2014 upload URLs were missing a slash between folder and filename<\/li>\n<li>Fixed: Session photo thumbnails not loading in the try-on modal<\/li>\n<li>Fixed: Session-only try-on no longer requires re-uploading user image<\/li>\n<li>Fixed: Upload directory paths unified (<code>tryonx-results<\/code>, <code>tryonx-temp<\/code>, <code>tryonx-sessions<\/code>)<\/li>\n<li>Fixed: <code>$_FILES<\/code> sanitization bug that broke image uploads<\/li>\n<li>Improved: Assets load only on eligible product pages (better performance)<\/li>\n<li>Improved: Compare view uses customer photo instead of product image<\/li>\n<li>Improved: Upload path helpers always use trailing slashes; <code>.htaccess<\/code> rules refresh on existing installs<\/li>\n<li>Improved: WooCommerce missing admin notice<\/li>\n<\/ul>\n\n<h4>1.1.1 [April 15, 2026]<\/h4>\n\n<ul>\n<li>Improved: Compatibility with latest WordPress and WooCommerce versions<\/li>\n<\/ul>\n\n<h4>1.1.0 [March 10, 2025]<\/h4>\n\n<ul>\n<li>Added: Session management \u2014 upload once, try multiple products<\/li>\n<li>Added: Before\/after comparison (slider and side-by-side)<\/li>\n<li>Added: Analytics dashboard and WooCommerce widget<\/li>\n<li>Added: Bulk try-on for same-category products<\/li>\n<li>Added: Social sharing and image download<\/li>\n<li>Updated: Gemini 2.5 Flash Image model<\/li>\n<li>Improved: Security, validation, and error handling<\/li>\n<li>Improved: Mobile-first responsive design<\/li>\n<li>Note: gemini-2.5-flash-image now requires a paid Google API plan<\/li>\n<\/ul>\n\n<h4>1.0.1 [December 15, 2024]<\/h4>\n\n<ul>\n<li>Fixed: Bug fixes and stability improvements<\/li>\n<\/ul>\n\n<h4>1.0.0 [November 20, 2024]<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"AI virtual try-on for WooCommerce \u2014 shoppers see outfits on themselves before checkout. Boost sales, reduce returns, powered by Gemini.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/241111","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=241111"}],"author":[{"embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wpxero"}],"wp:attachment":[{"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=241111"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=241111"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=241111"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=241111"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=241111"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=241111"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}