WordPress.org
Get WordPress

Plugin Directory

Changeset 3730980


Ignore:
Timestamp:
10/06/2026 02:11:28 PM (3 weeks ago)
Author:
mirrarofficial
Message:

Release 1.0.1

Location:
mirrar-virtual-try-on
Files:
13 added
2 deleted
8 edited
1 copied

Legend:

Unmodified
Added
Removed

  • mirrar-virtual-try-on/tags/1.0.1/LICENSE.txt

    r3728071 r3730980  
     1MirrAR Virtual Try On - WordPress plugin for WooCommerce
     2
     3Copyright (C) 2023-2026 MirrAR Innovation Technologies Private Limited
     4https://mirrar.ai
     5
     6This program is free software; you can redistribute it and/or modify
     7it under the terms of the GNU General Public License as published by
     8the Free Software Foundation; either version 2 of the License, or
     9(at your option) any later version.
     10
     11This program is distributed in the hope that it will be useful,
     12but WITHOUT ANY WARRANTY; without even the implied warranty of
     13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     14GNU General Public License for more details.
     15
     16You should have received a copy of the GNU General Public License
     17along with this program; if not, write to the Free Software
     18Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
     19
     20-------------------------------------------------------------------------
     21Notice (informational; does not add to or restrict the GPL terms below)
     22-------------------------------------------------------------------------
     23
     24Scope. This license covers the files distributed in this plugin package
     25only. The MirrAR service it connects to (app.mirrar.ai), including the
     26virtual try-on engine, try-on assets and the remotely served Try On
     27button script, is not part of this plugin and is provided under the
     28MirrAR Terms of Service: https://mirrar.ai/terms/
     29
     30Trademarks. "MirrAR" and the MirrAR logo are trademarks of MirrAR
     31Innovation Technologies Private Limited. The GPL covers the code, not
     32these marks. You may modify and redistribute this plugin under the GPL,
     33but please do not use the MirrAR name or logo in a way that suggests a
     34modified version is official MirrAR software.
     35
     36Third-party components. This package includes:
     37
     38  * Font Awesome 4.7.0 by Dave Gandy - https://fontawesome.io
     39    Font files: SIL Open Font License 1.1
     40    CSS: MIT License
     41    License: https://fontawesome.io/license
     42
     43=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
     44
    145                    GNU GENERAL PUBLIC LICENSE
    246                       Version 2, June 1991

  • mirrar-virtual-try-on/tags/1.0.1/includes/mirrar.php

    r3728071 r3730980  
    7575                        $this->version = MIRRAR_VERSION;
    7676                } else {
    77                         $this->version = '1.0.0';
     77                        $this->version = '1.0.1';
    7878                }
    7979                $this->plugin_name = 'mirrar-virtual-try-on';

  • mirrar-virtual-try-on/tags/1.0.1/mirrar-virtual-try-on.php

    r3728071 r3730980  
    2020 * Plugin Name:       MirrAR Virtual Try On
    2121 * Description:       Add MirrAR virtual try-on to your WooCommerce product pages. Customers try jewellery, eyewear and watches on themselves before they buy.
    22  * Version:           1.0.0
     22 * Version:           1.0.1
    2323 * Author:            MirrAR
    2424 * Author URI:        https://mirrar.ai/
    2525 * Text Domain:       mirrar-virtual-try-on
    26  * Copyright: © 2023 MirrAR.
    27  * License: GNU General Public License v3.0
    28  * License URI: http://www.gnu.org/licenses/gpl-3.0.html
    29  * Requires at least: 6.2
    30  * Requires PHP:      7.0
     26 * Copyright: © 2023-2026 MirrAR Innovation Technologies Private Limited
     27 * License:           GPLv2 or later
     28 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
     29 * Requires at least: 6.5
     30 * Requires PHP:      7.4
    3131 * Requires Plugins:  woocommerce
    3232 * WC requires at least: 3.0.0
    … …  
    4848 * Rename this for your plugin and update it as you release new versions.
    4949 */
    50 define( 'MIRRAR_VERSION', '1.0.0' );
     50define( 'MIRRAR_VERSION', '1.0.1' );
    5151
    5252/**

  • mirrar-virtual-try-on/tags/1.0.1/readme.txt

    r3728071 r3730980  
    11=== MirrAR Virtual Try On ===
    22Contributors: mirrarofficial
    3 Donate link: https://mirrar.ai
    4 Tags: virtual try-on, augmented reality, woocommerce, jewellery, eyewear
    5 Requires at least: 6.2
     3Tags: virtual try on, jewelry, eyewear, augmented reality, woocommerce
     4Requires at least: 6.5
    65Tested up to: 7.1
    7 Stable tag: 1.0.0
    8 Requires PHP: 7.0
    9 License: GNU General Public License v3.0
    10 License URI: http://www.gnu.org/licenses/gpl-3.0.html
    11 
    12 Add MirrAR virtual try-on to your WooCommerce product pages. Customers try jewellery, eyewear and watches on themselves before they buy.
     6Requires PHP: 7.4
     7Requires Plugins: woocommerce
     8Stable tag: 1.0.1
     9License: GPLv2 or later
     10License URI: https://www.gnu.org/licenses/gpl-2.0.html
     11
     12Live AR virtual try-on for WooCommerce. Shoppers try jewellery, watches, eyewear and makeup on camera before they buy. No code, no app.
    1313
    1414== Description ==
    1515
    16 MirrAR Virtual Try On adds a **Try On** button to your WooCommerce products. Customers press it and see the product on themselves, live, through their camera — necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear and more.
    17 
    18 The plugin is the part that lives on your shop. Your try-ons are prepared in your MirrAR account, and the plugin shows the Try On button on exactly the products that have one.
    19 
    20 **What it does**
    21 
    22 * **Connects itself.** Approve your shop once from the WooCommerce connector in MirrAR. The plugin then collects its own credentials — there is no key or secret to copy and paste.
    23 * **Follows try-on prep.** When you publish a product's try-on in MirrAR, its Try On button appears on your shop within seconds, and disappears again if you unpublish it. You can still switch any product on or off by hand, and your choice always wins.
    24 * **Matches products by SKU, automatically** — the product's own SKU, or for a variable product with no SKU of its own, its variations' SKUs. The same rule MirrAR uses when it imports your products, so there is nothing to set up.
    25 * **Button styling.** Colours, text, icon, borders, padding and shadow, with a live preview.
    26 * **Stays in step with your MirrAR account.** If you disconnect the shop in MirrAR, move it to another MirrAR account, or revoke MirrAR's key in WooCommerce, the plugin notices and switches try-on off (or over) by itself.
    27 
    28 Requires WooCommerce and a MirrAR account.
     16**MirrAR Virtual Try On is a WooCommerce plugin that adds a live augmented reality (AR) Try On button to your product pages.** Shoppers press it and see the product on themselves through their camera, in real time: necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear, coloured eye lenses and cosmetics. The try-on opens in an overlay on the product page and runs in the browser on desktop and mobile, so shoppers never leave your shop and never install an app.
     17
     18It is built for jewellery (jewelry) stores, watch stores, eyewear and optical stores, and beauty stores that sell on WordPress with WooCommerce. The plugin is free; the try-on runs on a paid MirrAR plan with a 14-day free trial. See [MirrAR pricing](https://mirrar.ai/pricing/).
     19
     20= Why stores add virtual try-on =
     21
     22The question that stops an online jewellery or eyewear sale is "how will this look on me?" A product photo cannot answer it. A live try-on can. The shopper sees the necklace on their own neck, the frames on their own face and the watch on their own wrist, and decides with more confidence.
     23
     24= How it works =
     25
     261. **Install the plugin.** In Plugins → Add New, search for "MirrAR Virtual Try On", install and activate. WooCommerce must be active.
     272. **Approve your shop once.** In your MirrAR account, open the WooCommerce VTO Connector, enter your shop address and press Approve. The plugin connects itself. There is no API key or secret to copy and paste.
     283. **Publish try-ons.** Choose products in MirrAR try-on prep and publish them. A Try On button appears on those products in your shop within seconds.
     29
     30= A live mirror on every product page =
     31
     32The shopper presses Try On, allows the camera, and the product appears on their face, neck, ears, hand or wrist. It moves with them as they turn, like a mirror. It runs in the browser on desktop and mobile.
     33
     34= What shoppers can try on =
     35
     36* **Jewellery:** necklaces, earrings, rings, bracelets and bangles
     37* **Watches:** wrist watches, shown on the wrist at true scale
     38* **Eyewear:** glasses and sunglasses, as full 3D frames that turn with the head or as 2D front and side views
     39* **Eye lenses:** coloured contact lens shades
     40* **Makeup:** lipstick, eyeshadow and eyeliner shades
     41
     422D try-on goes live as soon as your product images are uploaded to MirrAR. You can also use your own 3D models for jewellery, watches and eyewear.
     43
     44= What shoppers can do in the try-on =
     45
     46* **Wear a full look.** Several pieces at once: a necklace with earrings, or rings, bracelets and a watch together.
     47* **Compare two pieces.** Split-screen compare on the same face, on desktop and mobile.
     48* **Capture and share.** Take a photo, download it, or share it to WhatsApp and Facebook.
     49* **Use any camera.** Front and rear camera, with zoom.
     50
     51= Plugin features =
     52
     53* **Connects itself.** Approve your shop once from the WooCommerce connector in MirrAR. The plugin collects its own credentials during approval. Nothing to copy and paste.
     54* **Automatic Try On buttons.** When you publish a product's try-on in MirrAR, its Try On button appears on your shop within seconds, and disappears again if you unpublish it.
     55* **You stay in control.** Switch try-on on or off for any single product by hand. Your choice always wins over the automatic setting.
     56* **Automatic SKU matching.** Products are matched by their own SKU. A variable product with no SKU of its own is matched by its variations' SKUs. Nothing to map or set up.
     57* **Works with variable products.** One Try On button per product.
     58* **Product pages and product lists.** Show the Try On button on single product pages, on shop and category lists, or both.
     59* **Button styling with live preview.** Set colours, text, icon, borders, padding and shadow so the button matches your theme.
     60* **Loads only where needed.** The try-on script loads only on pages that show a Try On button.
     61* **No permalink or .htaccess changes.** The try-on opens in an overlay and needs no rewrite rules.
     62* **Stays in step with your MirrAR account.** If you disconnect the shop, move it to another MirrAR account or revoke the key in WooCommerce, the plugin notices and switches try-on off (or over) by itself.
     63* **Clean uninstall.** Deleting the plugin removes all the data it stored.
     64
     65= Included with your MirrAR plan =
     66
     67These are set up in your MirrAR account, not in the plugin:
     68
     69* **Your brand on the try-on.** Your logo and three brand colours across the try-on screen.
     70* **Try-on analytics and leads.** See which pieces are tried on most, and receive enquiries with the product attached.
     71
     72= Pricing =
     73
     74The plugin is free. The try-on runs on a MirrAR plan, priced by the number of products you put on try-on. Every plan includes every feature, unlimited try-ons and a 14-day free trial.
     75
     76Plans and current prices: [mirrar.ai/pricing](https://mirrar.ai/pricing/)
     77
     78= Privacy =
     79
     80The plugin itself sends no customer data and no order data to MirrAR. To connect, you approve a read-only WooCommerce REST API key for MirrAR, which MirrAR uses to read your products and SKUs. The Try On button script is loaded from MirrAR on pages that show the button, and the visitor's camera is used only after the visitor presses Try On. Full details are in the External services section below. We recommend mentioning MirrAR in your shop's privacy policy.
     81
     82= Requirements =
     83
     84* WordPress 6.5 or later
     85* PHP 7.4 or later
     86* WooCommerce, installed and active
     87* A MirrAR account with the WooCommerce VTO Connector
     88* SKUs on the products you want try-on for
     89
     90= About MirrAR =
     91
     92MirrAR (mirrar.ai) is an augmented reality and AI commerce company based in Chennai, India, operated by MirrAR Innovation Technologies Private Limited. MirrAR builds virtual try-on for jewellery and eyewear, and Smart Mirror kiosks for retail stores. This plugin brings MirrAR virtual try-on to WooCommerce shops. The official MirrAR website is [mirrar.ai](https://mirrar.ai). MirrAR is not affiliated with any other try-on app, plugin or website that uses a similar name.
     93
     94== External services ==
     95
     96This plugin relies on the MirrAR service to show virtual try-on. It connects to it in the following ways.
     97
     98**MirrAR API — app.mirrar.ai**
     99
     100Used to connect the shop to your MirrAR account and to keep the Try On buttons up to date. Requests are made from your server, only while the shop is being connected or is connected:
     101
     102* When the shop is connected: your site address, the last seven characters of the "MirrAR Virtual Try-On" WooCommerce key and a signature made with that key's secret (the secret itself is never sent), plus the plugin, WooCommerce and WordPress version numbers.
     103* To sign in: the store's Client ID and Client Secret, which the plugin receives automatically when you approve the shop, exchanged for an access token.
     104* Every five minutes, and when MirrAR signals a change: your site address, to check that the shop is still connected and to read which product SKUs have a try-on ready.
     105* When the plugin is activated, deactivated or deleted, or MirrAR's key is revoked: your site address and which of these happened.
     106
     107The plugin sends no customer or order data.
     108
     109MirrAR can also send your shop a notice at `/wp-json/mirrar/v1/tryon-sync` when a try-on changes. It carries no data; the plugin answers it by reading the list above with its own credentials.
     110
     111**WooCommerce REST API access for MirrAR**
     112
     113When you approve your shop in the WooCommerce VTO Connector, WooCommerce asks you to grant read access to "MirrAR Virtual Try-On". This creates a read-only REST API key that MirrAR uses from its servers to read your products, variations and SKUs so it can prepare try-ons. Note that WooCommerce's read permission is not limited to products. You can see or revoke the key at any time in **WooCommerce → Settings → Advanced → REST API**.
     114
     115**MirrAR Try On button — app.mirrar.ai and your MirrAR store address**
     116
     117On pages that show a Try On button, the script `https://app.mirrar.ai/XR/vto/mirrar-tryon-button.min.js` is loaded in the visitor's browser. Loading it sends MirrAR the visitor's IP address and standard browser information, as with any web request. When a visitor presses Try On, the try-on opens from your MirrAR store address with the product's SKU and, once the visitor allows it, uses the visitor's camera for the live try-on. If the visitor chooses to share a photo to WhatsApp or Facebook, it is shared through that service and its own terms apply.
     118
     119MirrAR [Terms of Service](https://mirrar.ai/terms/) and [Privacy Policy](https://mirrar.ai/privacy/).
    29120
    30121== Installation ==
    … …  
    38129
    39130== Frequently Asked Questions ==
     131
     132= What is MirrAR Virtual Try On? =
     133
     134MirrAR Virtual Try On is a WooCommerce plugin that adds a Try On button to product pages. When a shopper presses it, the product appears on them live through their camera. It supports necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear, coloured eye lenses and cosmetics.
     135
     136= How do I add virtual try-on to a WooCommerce store? =
     137
     138Install and activate MirrAR Virtual Try On, approve your shop once in the WooCommerce VTO Connector in your MirrAR account, then publish try-ons for the products you choose. The Try On button appears on those products automatically. No code is needed.
     139
     140= Is this a virtual try-on plugin for jewelry stores? =
     141
     142Yes. Shoppers can try on necklaces, earrings, rings, bracelets and bangles, and wear several pieces together as a full look. Watches, eyewear, eye lenses and cosmetics are supported too.
     143
     144= Can shoppers try on glasses and sunglasses? =
     145
     146Yes. Eyewear is supported, so optical and sunglasses stores can offer a live try-on from the product page.
     147
     148= Can shoppers try on makeup? =
     149
     150Yes. Lipstick, eyeshadow and eyeliner shades can be tried on the shopper's face through the camera, along with coloured eye lenses.
     151
     152= Do shoppers need to install an app? =
     153
     154No. The try-on opens in an overlay on your product page and uses the shopper's camera live. It runs in the browser on desktop and mobile, with no app to download.
     155
     156= How does the try-on work for shoppers? =
     157
     158The shopper presses the Try On button on a product page and allows camera access. The product then appears on them live and moves as they move. They can wear several pieces together, compare two pieces side by side, and capture a photo to download or share.
     159
     160= Do I need to know how to code? =
     161
     162No. The plugin connects itself after you approve your shop, matches products by SKU and adds the Try On buttons. Button colours and text are set from a settings screen with a live preview.
     163
     164= How much does it cost? =
     165
     166The plugin is free. The try-on runs on a MirrAR plan, priced by the number of products you put on try-on. Every plan includes every feature, unlimited try-ons and a 14-day free trial. See current plans and prices at [mirrar.ai/pricing](https://mirrar.ai/pricing/).
     167
     168= What counts as a product? =
     169
     170One product that you put on try-on. Its metal, size and shade variants count once, so a ring sold in three metals and five sizes is one product. You can switch which products are on try-on at any time.
     171
     172= Is there a free trial? =
     173
     174Yes. Every MirrAR plan starts with a 14-day free trial.
     175
     176= Is there a limit on the number of try-ons? =
     177
     178No. Try-ons are unlimited on every plan and there is no charge per try-on. Only the number of products on try-on is limited by your plan.
     179
     180= Will it slow down my shop? =
     181
     182The try-on script loads only on pages that show a Try On button, and the camera try-on starts only when a shopper presses it.
     183
     184= What data does the plugin send to MirrAR? =
     185
     186Your site address, version numbers and the credentials needed to keep the shop connected. The plugin sends no customer data and no order data. MirrAR also reads your products and SKUs through the read-only WooCommerce key you approve. See External services for the full list.
    40187
    41188= What do I need before I start? =
    … …  
    86233= What happens when I deactivate or delete the plugin? =
    87234
    88 Deactivating keeps all your settings, and MirrAR is told the plugin is inactive; activate it again and it carries on. Deleting the plugin removes everything it stored — its settings and the Try On switches on your products — but keeps the "MirrAR Virtual Try-On" key in WooCommerce, which belongs to your MirrAR connection rather than to the plugin. Reinstall it and it connects itself again.
     235Deactivating keeps all your settings, and MirrAR is told the plugin is inactive; activate it again and it carries on. Deleting the plugin removes everything it stored — its settings and the Try On switches on your products — but keeps the "MirrAR Virtual Try-On" key in WooCommerce, which belongs to your MirrAR connection rather than to the plugin. Reinstall it and it connects itself again. If you are stopping MirrAR for good, also revoke that key in **WooCommerce → Settings → Advanced → REST API**.
    89236
    90237= Does my shop need a particular permalink setting or .htaccess change? =
    … …  
    96243SVG files can carry scripts, so the plugin does not enable SVG uploads — WordPress blocks them by default for the same reason. Use PNG, JPG, GIF or WebP.
    97244
    98 == External services ==
    99 
    100 This plugin relies on the MirrAR service to show virtual try-on. It connects to it in the following ways.
    101 
    102 **MirrAR API — app.mirrar.ai**
    103 
    104 Used to connect the shop to your MirrAR account and to keep the Try On buttons up to date. Requests are made from your server, only while the shop is being connected or is connected:
    105 
    106 * When the shop is connected: your site address, the last seven characters of the "MirrAR Virtual Try-On" WooCommerce key and a signature made with that key's secret (the secret itself is never sent), plus the plugin, WooCommerce and WordPress version numbers.
    107 * To sign in: the store's Client ID and Client Secret, exchanged for an access token.
    108 * Every five minutes, and when MirrAR signals a change: your site address, to check that the shop is still connected and to read which product SKUs have a try-on ready.
    109 * When the plugin is activated, deactivated or deleted, or MirrAR's key is revoked: your site address and which of these happened.
    110 
    111 No customer or order data is sent.
    112 
    113 MirrAR can also send your shop a notice at `/wp-json/mirrar/v1/tryon-sync` when a try-on changes. It carries no data; the plugin answers it by reading the list above with its own credentials.
    114 
    115 **MirrAR Try On button — app.mirrar.ai and your MirrAR store address**
    116 
    117 On product pages that show the button, the script `https://app.mirrar.ai/XR/vto/mirrar-tryon-button.min.js` is loaded in the visitor's browser. When a visitor presses Try On, the try-on opens from your MirrAR store address with the product's SKU, and uses the visitor's camera for the live try-on.
    118 
    119 MirrAR [Terms of Service](https://mirrar.ai/terms/) and [Privacy Policy](https://mirrar.ai/privacy/).
     245== Screenshots ==
     246
     2471. Try On buttons on a WooCommerce shop product list.
     2482. Live virtual try-on of a necklace and earrings, opened in an overlay on the product page.
     2493. Live virtual try-on of a bangle opened in an overlay on the product page.
     2504. Live virtual try-on of a bracelet opened in an overlay on the product page.
     2515. Live virtual try-on of a ring opened in an overlay on the product page.
     2526. Live virtual try-on of eyewear opened in an overlay on the product page.
     2537. Live virtual try-on of a wrist watch opened in an overlay on the product page.
     2548. Live virtual try-on of makeup opened in an overlay on the product page.
     2559. General settings with the "Connected to MirrAR" status line.
     25610. Custom Button Style with live preview.
     25711. The MirrAR Virtual Try On tab in Product data, showing the matched SKU.
    120258
    121259== Changelog ==
    122260
     261= 1.0.1 =
     262
     263* Now requires WordPress 6.5 or later and PHP 7.4 or later.
     264* License clarified as GPLv2 or later, with copyright, trademark and third-party notices.
     265* Readme updated: privacy and external services details, link to MirrAR pricing, new screenshots.
     266
    123267= 1.0.0 =
    124 * Connects itself after you approve the shop in MirrAR — no keys to copy. The Store Connection tab is replaced by a status line in General settings.
     268
     269* Initial release.
     270* Live AR Try On button for WooCommerce product pages and product lists.
     271* Connects itself after you approve the shop in MirrAR — no keys to copy.
    125272* Try On buttons follow MirrAR try-on prep automatically; a manual choice on a product always wins.
    126 * New **MirrAR Virtual Try On** tab in Product data, with **Enable MirrAR Virtual Try On** and the SKU the product is matched by.
    127 * Products are matched by SKU automatically, including variable products with no SKU of their own; the separate "MirrAR SKU" field is gone.
    128 * Switches try-on off, or over to the new account, when the shop is disconnected in MirrAR, moved to another account, or MirrAR's key is revoked.
    129 * Tells MirrAR when the plugin is activated, deactivated or deleted.
    130 * "Show product list panel" moved to General settings.
    131 * Deleting the plugin now removes all of its data.
    132 * SVG uploads are no longer enabled.
    133 * Security and coding-standards fixes from Plugin Check.
    134 * Tested up to WordPress 7.1; requires WordPress 6.2 or later.
     273* Automatic SKU matching, including variable products with no SKU of their own.
     274* Custom button styling with live preview.
     275* Clean uninstall removes all plugin data.
    135276
    136277== Upgrade Notice ==
    137278
     279= 1.0.1 =
     280
     281Requires WordPress 6.5+ and PHP 7.4+. License and readme updates.
     282
    138283= 1.0.0 =
    139 Connects itself — no API keys needed any more. After updating, approve your shop from the WooCommerce connector in MirrAR if it is not connected yet.
     284
     285Initial release.

  • mirrar-virtual-try-on/trunk/LICENSE.txt

    r3728071 r3730980  
     1MirrAR Virtual Try On - WordPress plugin for WooCommerce
     2
     3Copyright (C) 2023-2026 MirrAR Innovation Technologies Private Limited
     4https://mirrar.ai
     5
     6This program is free software; you can redistribute it and/or modify
     7it under the terms of the GNU General Public License as published by
     8the Free Software Foundation; either version 2 of the License, or
     9(at your option) any later version.
     10
     11This program is distributed in the hope that it will be useful,
     12but WITHOUT ANY WARRANTY; without even the implied warranty of
     13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     14GNU General Public License for more details.
     15
     16You should have received a copy of the GNU General Public License
     17along with this program; if not, write to the Free Software
     18Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
     19
     20-------------------------------------------------------------------------
     21Notice (informational; does not add to or restrict the GPL terms below)
     22-------------------------------------------------------------------------
     23
     24Scope. This license covers the files distributed in this plugin package
     25only. The MirrAR service it connects to (app.mirrar.ai), including the
     26virtual try-on engine, try-on assets and the remotely served Try On
     27button script, is not part of this plugin and is provided under the
     28MirrAR Terms of Service: https://mirrar.ai/terms/
     29
     30Trademarks. "MirrAR" and the MirrAR logo are trademarks of MirrAR
     31Innovation Technologies Private Limited. The GPL covers the code, not
     32these marks. You may modify and redistribute this plugin under the GPL,
     33but please do not use the MirrAR name or logo in a way that suggests a
     34modified version is official MirrAR software.
     35
     36Third-party components. This package includes:
     37
     38  * Font Awesome 4.7.0 by Dave Gandy - https://fontawesome.io
     39    Font files: SIL Open Font License 1.1
     40    CSS: MIT License
     41    License: https://fontawesome.io/license
     42
     43=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
     44
    145                    GNU GENERAL PUBLIC LICENSE
    246                       Version 2, June 1991

  • mirrar-virtual-try-on/trunk/includes/mirrar.php

    r3728071 r3730980  
    7575                        $this->version = MIRRAR_VERSION;
    7676                } else {
    77                         $this->version = '1.0.0';
     77                        $this->version = '1.0.1';
    7878                }
    7979                $this->plugin_name = 'mirrar-virtual-try-on';

  • mirrar-virtual-try-on/trunk/mirrar-virtual-try-on.php

    r3728071 r3730980  
    2020 * Plugin Name:       MirrAR Virtual Try On
    2121 * Description:       Add MirrAR virtual try-on to your WooCommerce product pages. Customers try jewellery, eyewear and watches on themselves before they buy.
    22  * Version:           1.0.0
     22 * Version:           1.0.1
    2323 * Author:            MirrAR
    2424 * Author URI:        https://mirrar.ai/
    2525 * Text Domain:       mirrar-virtual-try-on
    26  * Copyright: © 2023 MirrAR.
    27  * License: GNU General Public License v3.0
    28  * License URI: http://www.gnu.org/licenses/gpl-3.0.html
    29  * Requires at least: 6.2
    30  * Requires PHP:      7.0
     26 * Copyright: © 2023-2026 MirrAR Innovation Technologies Private Limited
     27 * License:           GPLv2 or later
     28 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
     29 * Requires at least: 6.5
     30 * Requires PHP:      7.4
    3131 * Requires Plugins:  woocommerce
    3232 * WC requires at least: 3.0.0
    … …  
    4848 * Rename this for your plugin and update it as you release new versions.
    4949 */
    50 define( 'MIRRAR_VERSION', '1.0.0' );
     50define( 'MIRRAR_VERSION', '1.0.1' );
    5151
    5252/**

  • mirrar-virtual-try-on/trunk/readme.txt

    r3728071 r3730980  
    11=== MirrAR Virtual Try On ===
    22Contributors: mirrarofficial
    3 Donate link: https://mirrar.ai
    4 Tags: virtual try-on, augmented reality, woocommerce, jewellery, eyewear
    5 Requires at least: 6.2
     3Tags: virtual try on, jewelry, eyewear, augmented reality, woocommerce
     4Requires at least: 6.5
    65Tested up to: 7.1
    7 Stable tag: 1.0.0
    8 Requires PHP: 7.0
    9 License: GNU General Public License v3.0
    10 License URI: http://www.gnu.org/licenses/gpl-3.0.html
    11 
    12 Add MirrAR virtual try-on to your WooCommerce product pages. Customers try jewellery, eyewear and watches on themselves before they buy.
     6Requires PHP: 7.4
     7Requires Plugins: woocommerce
     8Stable tag: 1.0.1
     9License: GPLv2 or later
     10License URI: https://www.gnu.org/licenses/gpl-2.0.html
     11
     12Live AR virtual try-on for WooCommerce. Shoppers try jewellery, watches, eyewear and makeup on camera before they buy. No code, no app.
    1313
    1414== Description ==
    1515
    16 MirrAR Virtual Try On adds a **Try On** button to your WooCommerce products. Customers press it and see the product on themselves, live, through their camera — necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear and more.
    17 
    18 The plugin is the part that lives on your shop. Your try-ons are prepared in your MirrAR account, and the plugin shows the Try On button on exactly the products that have one.
    19 
    20 **What it does**
    21 
    22 * **Connects itself.** Approve your shop once from the WooCommerce connector in MirrAR. The plugin then collects its own credentials — there is no key or secret to copy and paste.
    23 * **Follows try-on prep.** When you publish a product's try-on in MirrAR, its Try On button appears on your shop within seconds, and disappears again if you unpublish it. You can still switch any product on or off by hand, and your choice always wins.
    24 * **Matches products by SKU, automatically** — the product's own SKU, or for a variable product with no SKU of its own, its variations' SKUs. The same rule MirrAR uses when it imports your products, so there is nothing to set up.
    25 * **Button styling.** Colours, text, icon, borders, padding and shadow, with a live preview.
    26 * **Stays in step with your MirrAR account.** If you disconnect the shop in MirrAR, move it to another MirrAR account, or revoke MirrAR's key in WooCommerce, the plugin notices and switches try-on off (or over) by itself.
    27 
    28 Requires WooCommerce and a MirrAR account.
     16**MirrAR Virtual Try On is a WooCommerce plugin that adds a live augmented reality (AR) Try On button to your product pages.** Shoppers press it and see the product on themselves through their camera, in real time: necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear, coloured eye lenses and cosmetics. The try-on opens in an overlay on the product page and runs in the browser on desktop and mobile, so shoppers never leave your shop and never install an app.
     17
     18It is built for jewellery (jewelry) stores, watch stores, eyewear and optical stores, and beauty stores that sell on WordPress with WooCommerce. The plugin is free; the try-on runs on a paid MirrAR plan with a 14-day free trial. See [MirrAR pricing](https://mirrar.ai/pricing/).
     19
     20= Why stores add virtual try-on =
     21
     22The question that stops an online jewellery or eyewear sale is "how will this look on me?" A product photo cannot answer it. A live try-on can. The shopper sees the necklace on their own neck, the frames on their own face and the watch on their own wrist, and decides with more confidence.
     23
     24= How it works =
     25
     261. **Install the plugin.** In Plugins → Add New, search for "MirrAR Virtual Try On", install and activate. WooCommerce must be active.
     272. **Approve your shop once.** In your MirrAR account, open the WooCommerce VTO Connector, enter your shop address and press Approve. The plugin connects itself. There is no API key or secret to copy and paste.
     283. **Publish try-ons.** Choose products in MirrAR try-on prep and publish them. A Try On button appears on those products in your shop within seconds.
     29
     30= A live mirror on every product page =
     31
     32The shopper presses Try On, allows the camera, and the product appears on their face, neck, ears, hand or wrist. It moves with them as they turn, like a mirror. It runs in the browser on desktop and mobile.
     33
     34= What shoppers can try on =
     35
     36* **Jewellery:** necklaces, earrings, rings, bracelets and bangles
     37* **Watches:** wrist watches, shown on the wrist at true scale
     38* **Eyewear:** glasses and sunglasses, as full 3D frames that turn with the head or as 2D front and side views
     39* **Eye lenses:** coloured contact lens shades
     40* **Makeup:** lipstick, eyeshadow and eyeliner shades
     41
     422D try-on goes live as soon as your product images are uploaded to MirrAR. You can also use your own 3D models for jewellery, watches and eyewear.
     43
     44= What shoppers can do in the try-on =
     45
     46* **Wear a full look.** Several pieces at once: a necklace with earrings, or rings, bracelets and a watch together.
     47* **Compare two pieces.** Split-screen compare on the same face, on desktop and mobile.
     48* **Capture and share.** Take a photo, download it, or share it to WhatsApp and Facebook.
     49* **Use any camera.** Front and rear camera, with zoom.
     50
     51= Plugin features =
     52
     53* **Connects itself.** Approve your shop once from the WooCommerce connector in MirrAR. The plugin collects its own credentials during approval. Nothing to copy and paste.
     54* **Automatic Try On buttons.** When you publish a product's try-on in MirrAR, its Try On button appears on your shop within seconds, and disappears again if you unpublish it.
     55* **You stay in control.** Switch try-on on or off for any single product by hand. Your choice always wins over the automatic setting.
     56* **Automatic SKU matching.** Products are matched by their own SKU. A variable product with no SKU of its own is matched by its variations' SKUs. Nothing to map or set up.
     57* **Works with variable products.** One Try On button per product.
     58* **Product pages and product lists.** Show the Try On button on single product pages, on shop and category lists, or both.
     59* **Button styling with live preview.** Set colours, text, icon, borders, padding and shadow so the button matches your theme.
     60* **Loads only where needed.** The try-on script loads only on pages that show a Try On button.
     61* **No permalink or .htaccess changes.** The try-on opens in an overlay and needs no rewrite rules.
     62* **Stays in step with your MirrAR account.** If you disconnect the shop, move it to another MirrAR account or revoke the key in WooCommerce, the plugin notices and switches try-on off (or over) by itself.
     63* **Clean uninstall.** Deleting the plugin removes all the data it stored.
     64
     65= Included with your MirrAR plan =
     66
     67These are set up in your MirrAR account, not in the plugin:
     68
     69* **Your brand on the try-on.** Your logo and three brand colours across the try-on screen.
     70* **Try-on analytics and leads.** See which pieces are tried on most, and receive enquiries with the product attached.
     71
     72= Pricing =
     73
     74The plugin is free. The try-on runs on a MirrAR plan, priced by the number of products you put on try-on. Every plan includes every feature, unlimited try-ons and a 14-day free trial.
     75
     76Plans and current prices: [mirrar.ai/pricing](https://mirrar.ai/pricing/)
     77
     78= Privacy =
     79
     80The plugin itself sends no customer data and no order data to MirrAR. To connect, you approve a read-only WooCommerce REST API key for MirrAR, which MirrAR uses to read your products and SKUs. The Try On button script is loaded from MirrAR on pages that show the button, and the visitor's camera is used only after the visitor presses Try On. Full details are in the External services section below. We recommend mentioning MirrAR in your shop's privacy policy.
     81
     82= Requirements =
     83
     84* WordPress 6.5 or later
     85* PHP 7.4 or later
     86* WooCommerce, installed and active
     87* A MirrAR account with the WooCommerce VTO Connector
     88* SKUs on the products you want try-on for
     89
     90= About MirrAR =
     91
     92MirrAR (mirrar.ai) is an augmented reality and AI commerce company based in Chennai, India, operated by MirrAR Innovation Technologies Private Limited. MirrAR builds virtual try-on for jewellery and eyewear, and Smart Mirror kiosks for retail stores. This plugin brings MirrAR virtual try-on to WooCommerce shops. The official MirrAR website is [mirrar.ai](https://mirrar.ai). MirrAR is not affiliated with any other try-on app, plugin or website that uses a similar name.
     93
     94== External services ==
     95
     96This plugin relies on the MirrAR service to show virtual try-on. It connects to it in the following ways.
     97
     98**MirrAR API — app.mirrar.ai**
     99
     100Used to connect the shop to your MirrAR account and to keep the Try On buttons up to date. Requests are made from your server, only while the shop is being connected or is connected:
     101
     102* When the shop is connected: your site address, the last seven characters of the "MirrAR Virtual Try-On" WooCommerce key and a signature made with that key's secret (the secret itself is never sent), plus the plugin, WooCommerce and WordPress version numbers.
     103* To sign in: the store's Client ID and Client Secret, which the plugin receives automatically when you approve the shop, exchanged for an access token.
     104* Every five minutes, and when MirrAR signals a change: your site address, to check that the shop is still connected and to read which product SKUs have a try-on ready.
     105* When the plugin is activated, deactivated or deleted, or MirrAR's key is revoked: your site address and which of these happened.
     106
     107The plugin sends no customer or order data.
     108
     109MirrAR can also send your shop a notice at `/wp-json/mirrar/v1/tryon-sync` when a try-on changes. It carries no data; the plugin answers it by reading the list above with its own credentials.
     110
     111**WooCommerce REST API access for MirrAR**
     112
     113When you approve your shop in the WooCommerce VTO Connector, WooCommerce asks you to grant read access to "MirrAR Virtual Try-On". This creates a read-only REST API key that MirrAR uses from its servers to read your products, variations and SKUs so it can prepare try-ons. Note that WooCommerce's read permission is not limited to products. You can see or revoke the key at any time in **WooCommerce → Settings → Advanced → REST API**.
     114
     115**MirrAR Try On button — app.mirrar.ai and your MirrAR store address**
     116
     117On pages that show a Try On button, the script `https://app.mirrar.ai/XR/vto/mirrar-tryon-button.min.js` is loaded in the visitor's browser. Loading it sends MirrAR the visitor's IP address and standard browser information, as with any web request. When a visitor presses Try On, the try-on opens from your MirrAR store address with the product's SKU and, once the visitor allows it, uses the visitor's camera for the live try-on. If the visitor chooses to share a photo to WhatsApp or Facebook, it is shared through that service and its own terms apply.
     118
     119MirrAR [Terms of Service](https://mirrar.ai/terms/) and [Privacy Policy](https://mirrar.ai/privacy/).
    29120
    30121== Installation ==
    … …  
    38129
    39130== Frequently Asked Questions ==
     131
     132= What is MirrAR Virtual Try On? =
     133
     134MirrAR Virtual Try On is a WooCommerce plugin that adds a Try On button to product pages. When a shopper presses it, the product appears on them live through their camera. It supports necklaces, earrings, rings, bracelets, bangles, wrist watches, eyewear, coloured eye lenses and cosmetics.
     135
     136= How do I add virtual try-on to a WooCommerce store? =
     137
     138Install and activate MirrAR Virtual Try On, approve your shop once in the WooCommerce VTO Connector in your MirrAR account, then publish try-ons for the products you choose. The Try On button appears on those products automatically. No code is needed.
     139
     140= Is this a virtual try-on plugin for jewelry stores? =
     141
     142Yes. Shoppers can try on necklaces, earrings, rings, bracelets and bangles, and wear several pieces together as a full look. Watches, eyewear, eye lenses and cosmetics are supported too.
     143
     144= Can shoppers try on glasses and sunglasses? =
     145
     146Yes. Eyewear is supported, so optical and sunglasses stores can offer a live try-on from the product page.
     147
     148= Can shoppers try on makeup? =
     149
     150Yes. Lipstick, eyeshadow and eyeliner shades can be tried on the shopper's face through the camera, along with coloured eye lenses.
     151
     152= Do shoppers need to install an app? =
     153
     154No. The try-on opens in an overlay on your product page and uses the shopper's camera live. It runs in the browser on desktop and mobile, with no app to download.
     155
     156= How does the try-on work for shoppers? =
     157
     158The shopper presses the Try On button on a product page and allows camera access. The product then appears on them live and moves as they move. They can wear several pieces together, compare two pieces side by side, and capture a photo to download or share.
     159
     160= Do I need to know how to code? =
     161
     162No. The plugin connects itself after you approve your shop, matches products by SKU and adds the Try On buttons. Button colours and text are set from a settings screen with a live preview.
     163
     164= How much does it cost? =
     165
     166The plugin is free. The try-on runs on a MirrAR plan, priced by the number of products you put on try-on. Every plan includes every feature, unlimited try-ons and a 14-day free trial. See current plans and prices at [mirrar.ai/pricing](https://mirrar.ai/pricing/).
     167
     168= What counts as a product? =
     169
     170One product that you put on try-on. Its metal, size and shade variants count once, so a ring sold in three metals and five sizes is one product. You can switch which products are on try-on at any time.
     171
     172= Is there a free trial? =
     173
     174Yes. Every MirrAR plan starts with a 14-day free trial.
     175
     176= Is there a limit on the number of try-ons? =
     177
     178No. Try-ons are unlimited on every plan and there is no charge per try-on. Only the number of products on try-on is limited by your plan.
     179
     180= Will it slow down my shop? =
     181
     182The try-on script loads only on pages that show a Try On button, and the camera try-on starts only when a shopper presses it.
     183
     184= What data does the plugin send to MirrAR? =
     185
     186Your site address, version numbers and the credentials needed to keep the shop connected. The plugin sends no customer data and no order data. MirrAR also reads your products and SKUs through the read-only WooCommerce key you approve. See External services for the full list.
    40187
    41188= What do I need before I start? =
    … …  
    86233= What happens when I deactivate or delete the plugin? =
    87234
    88 Deactivating keeps all your settings, and MirrAR is told the plugin is inactive; activate it again and it carries on. Deleting the plugin removes everything it stored — its settings and the Try On switches on your products — but keeps the "MirrAR Virtual Try-On" key in WooCommerce, which belongs to your MirrAR connection rather than to the plugin. Reinstall it and it connects itself again.
     235Deactivating keeps all your settings, and MirrAR is told the plugin is inactive; activate it again and it carries on. Deleting the plugin removes everything it stored — its settings and the Try On switches on your products — but keeps the "MirrAR Virtual Try-On" key in WooCommerce, which belongs to your MirrAR connection rather than to the plugin. Reinstall it and it connects itself again. If you are stopping MirrAR for good, also revoke that key in **WooCommerce → Settings → Advanced → REST API**.
    89236
    90237= Does my shop need a particular permalink setting or .htaccess change? =
    … …  
    96243SVG files can carry scripts, so the plugin does not enable SVG uploads — WordPress blocks them by default for the same reason. Use PNG, JPG, GIF or WebP.
    97244
    98 == External services ==
    99 
    100 This plugin relies on the MirrAR service to show virtual try-on. It connects to it in the following ways.
    101 
    102 **MirrAR API — app.mirrar.ai**
    103 
    104 Used to connect the shop to your MirrAR account and to keep the Try On buttons up to date. Requests are made from your server, only while the shop is being connected or is connected:
    105 
    106 * When the shop is connected: your site address, the last seven characters of the "MirrAR Virtual Try-On" WooCommerce key and a signature made with that key's secret (the secret itself is never sent), plus the plugin, WooCommerce and WordPress version numbers.
    107 * To sign in: the store's Client ID and Client Secret, exchanged for an access token.
    108 * Every five minutes, and when MirrAR signals a change: your site address, to check that the shop is still connected and to read which product SKUs have a try-on ready.
    109 * When the plugin is activated, deactivated or deleted, or MirrAR's key is revoked: your site address and which of these happened.
    110 
    111 No customer or order data is sent.
    112 
    113 MirrAR can also send your shop a notice at `/wp-json/mirrar/v1/tryon-sync` when a try-on changes. It carries no data; the plugin answers it by reading the list above with its own credentials.
    114 
    115 **MirrAR Try On button — app.mirrar.ai and your MirrAR store address**
    116 
    117 On product pages that show the button, the script `https://app.mirrar.ai/XR/vto/mirrar-tryon-button.min.js` is loaded in the visitor's browser. When a visitor presses Try On, the try-on opens from your MirrAR store address with the product's SKU, and uses the visitor's camera for the live try-on.
    118 
    119 MirrAR [Terms of Service](https://mirrar.ai/terms/) and [Privacy Policy](https://mirrar.ai/privacy/).
     245== Screenshots ==
     246
     2471. Try On buttons on a WooCommerce shop product list.
     2482. Live virtual try-on of a necklace and earrings, opened in an overlay on the product page.
     2493. Live virtual try-on of a bangle opened in an overlay on the product page.
     2504. Live virtual try-on of a bracelet opened in an overlay on the product page.
     2515. Live virtual try-on of a ring opened in an overlay on the product page.
     2526. Live virtual try-on of eyewear opened in an overlay on the product page.
     2537. Live virtual try-on of a wrist watch opened in an overlay on the product page.
     2548. Live virtual try-on of makeup opened in an overlay on the product page.
     2559. General settings with the "Connected to MirrAR" status line.
     25610. Custom Button Style with live preview.
     25711. The MirrAR Virtual Try On tab in Product data, showing the matched SKU.
    120258
    121259== Changelog ==
    122260
     261= 1.0.1 =
     262
     263* Now requires WordPress 6.5 or later and PHP 7.4 or later.
     264* License clarified as GPLv2 or later, with copyright, trademark and third-party notices.
     265* Readme updated: privacy and external services details, link to MirrAR pricing, new screenshots.
     266
    123267= 1.0.0 =
    124 * Connects itself after you approve the shop in MirrAR — no keys to copy. The Store Connection tab is replaced by a status line in General settings.
     268
     269* Initial release.
     270* Live AR Try On button for WooCommerce product pages and product lists.
     271* Connects itself after you approve the shop in MirrAR — no keys to copy.
    125272* Try On buttons follow MirrAR try-on prep automatically; a manual choice on a product always wins.
    126 * New **MirrAR Virtual Try On** tab in Product data, with **Enable MirrAR Virtual Try On** and the SKU the product is matched by.
    127 * Products are matched by SKU automatically, including variable products with no SKU of their own; the separate "MirrAR SKU" field is gone.
    128 * Switches try-on off, or over to the new account, when the shop is disconnected in MirrAR, moved to another account, or MirrAR's key is revoked.
    129 * Tells MirrAR when the plugin is activated, deactivated or deleted.
    130 * "Show product list panel" moved to General settings.
    131 * Deleting the plugin now removes all of its data.
    132 * SVG uploads are no longer enabled.
    133 * Security and coding-standards fixes from Plugin Check.
    134 * Tested up to WordPress 7.1; requires WordPress 6.2 or later.
     273* Automatic SKU matching, including variable products with no SKU of their own.
     274* Custom button styling with live preview.
     275* Clean uninstall removes all plugin data.
    135276
    136277== Upgrade Notice ==
    137278
     279= 1.0.1 =
     280
     281Requires WordPress 6.5+ and PHP 7.4+. License and readme updates.
     282
    138283= 1.0.0 =
    139 Connects itself — no API keys needed any more. After updating, approve your shop from the WooCommerce connector in MirrAR if it is not connected yet.
     284
     285Initial release.
Note: See TracChangeset for help on using the changeset viewer.