=== MirrAR Virtual Try On ===
Contributors: mirrarofficial
Tags: virtual try on, jewelry, eyewear, augmented reality, woocommerce
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live AR virtual try-on for WooCommerce. Shoppers try jewellery, watches, eyewear and makeup on camera before they buy. No code, no app.

== Description ==

**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.

It 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/).

= Why stores add virtual try-on =

The 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.

= How it works =

1. **Install the plugin.** In Plugins → Add New, search for "MirrAR Virtual Try On", install and activate. WooCommerce must be active.
2. **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.
3. **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.

= A live mirror on every product page =

The 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.

= What shoppers can try on =

* **Jewellery:** necklaces, earrings, rings, bracelets and bangles
* **Watches:** wrist watches, shown on the wrist at true scale
* **Eyewear:** glasses and sunglasses, as full 3D frames that turn with the head or as 2D front and side views
* **Eye lenses:** coloured contact lens shades
* **Makeup:** lipstick, eyeshadow and eyeliner shades

2D 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.

= What shoppers can do in the try-on =

* **Wear a full look.** Several pieces at once: a necklace with earrings, or rings, bracelets and a watch together.
* **Compare two pieces.** Split-screen compare on the same face, on desktop and mobile.
* **Capture and share.** Take a photo, download it, or share it to WhatsApp and Facebook.
* **Use any camera.** Front and rear camera, with zoom.

= Plugin features =

* **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.
* **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.
* **You stay in control.** Switch try-on on or off for any single product by hand. Your choice always wins over the automatic setting.
* **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.
* **Works with variable products.** One Try On button per product.
* **Product pages and product lists.** Show the Try On button on single product pages, on shop and category lists, or both.
* **Button styling with live preview.** Set colours, text, icon, borders, padding and shadow so the button matches your theme.
* **Loads only where needed.** The try-on script loads only on pages that show a Try On button.
* **No permalink or .htaccess changes.** The try-on opens in an overlay and needs no rewrite rules.
* **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.
* **Clean uninstall.** Deleting the plugin removes all the data it stored.

= Included with your MirrAR plan =

These are set up in your MirrAR account, not in the plugin:

* **Your brand on the try-on.** Your logo and three brand colours across the try-on screen.
* **Try-on analytics and leads.** See which pieces are tried on most, and receive enquiries with the product attached.

= Pricing =

The 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.

Plans and current prices: [mirrar.ai/pricing](https://mirrar.ai/pricing/)

= Privacy =

The 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.

= Requirements =

* WordPress 6.5 or later
* PHP 7.4 or later
* WooCommerce, installed and active
* A MirrAR account with the WooCommerce VTO Connector
* SKUs on the products you want try-on for

= About MirrAR =

MirrAR (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.

== External services ==

This plugin relies on the MirrAR service to show virtual try-on. It connects to it in the following ways.

**MirrAR API — app.mirrar.ai**

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:

* 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.
* 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.
* 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.
* When the plugin is activated, deactivated or deleted, or MirrAR's key is revoked: your site address and which of these happened.

The plugin sends no customer or order data.

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.

**WooCommerce REST API access for MirrAR**

When 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**.

**MirrAR Try On button — app.mirrar.ai and your MirrAR store address**

On 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.

MirrAR [Terms of Service](https://mirrar.ai/terms/) and [Privacy Policy](https://mirrar.ai/privacy/).

== Installation ==

1. In **Plugins → Add New**, search for **MirrAR Virtual Try On**, then **Install Now** and **Activate**. WooCommerce must be active. (The MirrAR connector also gives you a one-click install link for your shop.)
2. In your MirrAR account, open the **WooCommerce VTO Connector**, enter your shop address and press **Approve**. WooCommerce asks you to approve read access for "MirrAR Virtual Try-On" — approve it.
3. That is all. The plugin connects itself within a few minutes — or straight away if you press **Check now** in **MirrAR Virtual Try On → General settings**, which shows "Connected to MirrAR" when it is done.
4. In MirrAR try-on prep, choose the products that need try-on and publish them. Their Try On buttons appear on your shop by themselves.

The order of steps 1 and 2 does not matter: if you install the plugin first, it waits for the approval and connects as soon as it arrives.

== Frequently Asked Questions ==

= What is MirrAR Virtual Try On? =

MirrAR 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.

= How do I add virtual try-on to a WooCommerce store? =

Install 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.

= Is this a virtual try-on plugin for jewelry stores? =

Yes. 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.

= Can shoppers try on glasses and sunglasses? =

Yes. Eyewear is supported, so optical and sunglasses stores can offer a live try-on from the product page.

= Can shoppers try on makeup? =

Yes. Lipstick, eyeshadow and eyeliner shades can be tried on the shopper's face through the camera, along with coloured eye lenses.

= Do shoppers need to install an app? =

No. 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.

= How does the try-on work for shoppers? =

The 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.

= Do I need to know how to code? =

No. 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.

= How much does it cost? =

The 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/).

= What counts as a product? =

One 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.

= Is there a free trial? =

Yes. Every MirrAR plan starts with a 14-day free trial.

= Is there a limit on the number of try-ons? =

No. 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.

= Will it slow down my shop? =

The 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.

= What data does the plugin send to MirrAR? =

Your 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.

= What do I need before I start? =

A WooCommerce shop (WooCommerce must be active — WordPress will not activate the plugin without it) and a MirrAR account with the WooCommerce VTO Connector. Your products need SKUs, because that is how MirrAR and your shop match products.

= How do I know the plugin is connected? =

Look at the status line at the top of **MirrAR Virtual Try On → General settings**:

* **Connected to MirrAR** — with how many products are ready for try-on.
* **Not connected to MirrAR yet** — with the reason, for example that it is waiting for the shop to be approved, or that the shop was disconnected in MirrAR. Press **Check now** to try again straight away.

= How long after I publish a try-on does the button appear? =

Usually within seconds: MirrAR tells your shop that something changed. If that message cannot get through — some hosts block it — the plugin also checks every five minutes. On a shop with no visitors it can take longer, because WordPress only runs its scheduled checks when somebody visits.

= Why is the Try On button not showing on a product? =

Check, in order:

1. **MirrAR Virtual Try On → General settings** says "Connected to MirrAR".
2. "Show the Try On button on product pages" (and/or "…on product lists") is switched on in General settings.
3. The product's try-on is published in MirrAR try-on prep.
4. The product has a SKU (or, for a variable product, its variations do), and it is the same SKU as the product in MirrAR. The product's **MirrAR Virtual Try On** tab shows which SKU it is matched by.
5. On the product's **MirrAR Virtual Try On** tab, **Enable MirrAR Virtual Try On** is ticked. If you unticked it yourself earlier, MirrAR will not switch it back on — tick it again.

= Can I show or hide the button on one product by hand? =

Yes. Edit the product, open the **MirrAR Virtual Try On** tab in Product data, and tick or untick **Enable MirrAR Virtual Try On**. A change you make there always wins over MirrAR: a product you switch off stays off, and one you switch on stays on.

= Does it work with variable products? =

Yes, one Try On button per product. It is matched by the product's own SKU — or, if the product has no SKU of its own, by its variations' SKUs, the same way MirrAR names such a product when it imports it. Nothing to set up.

= How do I change how the button looks? =

**MirrAR Virtual Try On → General settings** → **Custom Button Style**. The preview on the right shows the result as you change it.

= How do I disconnect the shop? =

Press **Disconnect** in the WooCommerce VTO Connector in MirrAR. Within a few minutes the plugin switches try-on off on your shop. Revoking the "MirrAR Virtual Try-On" key in **WooCommerce → Settings → Advanced → REST API** does the same.

= Can I move the shop to another MirrAR account? =

Yes. Disconnect it from the first account, then approve it from the second. The plugin switches over by itself and removes the first account's key from your shop. While the first account is still connected, the second one cannot connect the shop.

= What happens when I deactivate or delete the plugin? =

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. If you are stopping MirrAR for good, also revoke that key in **WooCommerce → Settings → Advanced → REST API**.

= Does my shop need a particular permalink setting or .htaccess change? =

No. The try-on opens in an overlay on the product page and needs no rewrite rules.

= Why can't I upload an SVG logo? =

SVG 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.

== Screenshots ==

1. Try On buttons on a WooCommerce shop product list.
2. Live virtual try-on of a necklace and earrings, opened in an overlay on the product page.
3. Live virtual try-on of a bangle opened in an overlay on the product page.
4. Live virtual try-on of a bracelet opened in an overlay on the product page.
5. Live virtual try-on of a ring opened in an overlay on the product page.
6. Live virtual try-on of eyewear opened in an overlay on the product page.
7. Live virtual try-on of a wrist watch opened in an overlay on the product page.
8. Live virtual try-on of makeup opened in an overlay on the product page.
9. General settings with the "Connected to MirrAR" status line.
10. Custom Button Style with live preview.
11. The MirrAR Virtual Try On tab in Product data, showing the matched SKU.

== Changelog ==

= 1.0.1 =

* Now requires WordPress 6.5 or later and PHP 7.4 or later.
* License clarified as GPLv2 or later, with copyright, trademark and third-party notices.
* Readme updated: privacy and external services details, link to MirrAR pricing, new screenshots.

= 1.0.0 =

* Initial release.
* Live AR Try On button for WooCommerce product pages and product lists.
* Connects itself after you approve the shop in MirrAR — no keys to copy.
* Try On buttons follow MirrAR try-on prep automatically; a manual choice on a product always wins.
* Automatic SKU matching, including variable products with no SKU of their own.
* Custom button styling with live preview.
* Clean uninstall removes all plugin data.

== Upgrade Notice ==

= 1.0.1 =

Requires WordPress 6.5+ and PHP 7.4+. License and readme updates.

= 1.0.0 =

Initial release.
