=== Mawu Art – View in Your Space ===
Contributors: mawuart
Tags: woocommerce, product preview, product image, view in room, wall art
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


Let your customers see your artwork in their own space — instantly.


== Description ==

🎥 Watch the short demo video below to see how “View in Your Space” works in real life.

👉 https://www.youtube.com/watch?v=KV9HvvcN-uc


Mawu Art – View in Your Space is a lightweight WooCommerce plugin that allows customers to preview artworks directly on their wall using their own photos.

In just a few seconds, buyers can visualize how a piece will look in their space — helping them better understand scale, placement, and overall fit before purchasing.

No app required. No setup friction.


For a more immersive experience, users can continue in the MawuARtview mobile app (if installed).


Features include:


* Uses the WooCommerce product's **featured image**.
* Customers can upload a wall photo or take one using their device.
* Drag to reposition the artwork.
* Pinch to resize (touch devices).
* Scroll to resize (desktop).
* Keyboard controls on desktop (move, resize, reset, close).
* Frame options: **none**, **black**, **white**, **gold**.
* Download the final preview as an image.
* Desktop-to-mobile QR bridge for camera usage.
* Optional continuation in the **MawuARtview mobile app** for a deeper experience.
* Works with any theme using the standard WooCommerce product page.


A fast, intuitive way to help your customers make confident decisions — and reduce hesitation before purchase.


== Installation ==


1. Upload the `mawu-art` folder to `/wp-content/plugins/`, or install the ZIP through **Plugins → Add New → Upload Plugin**.
2. Activate the plugin from the **Plugins** menu in WordPress.
3. Go to **Settings → Mawu Art View in Your Space** and make sure the feature is enabled.
4. Ensure each WooCommerce product has a **featured image**.
5. Visit a single product page — the **View in your space** button will appear automatically.


== How to Use ==


1. Click **View in your space** on a product page.
2. Choose one of the options:
   * **Upload from gallery**
   * **Take a photo** (opens the camera on supported mobile devices)
3. The wall photo will load into the preview.
4. Move the artwork:
   * **Drag** with mouse or touch
   * **Arrow keys** (desktop)
5. Resize the artwork:
   * **Pinch** on touch devices
   * **Scroll wheel** (desktop)
   * **+ / - keys** (desktop)
6. Select a frame style (optional).
7. Click **Save** to download the preview, or **Close** to exit.

💡 On desktop, you can scan the QR code to continue on your phone using your camera.

For a more immersive experience, users can tap **Open in MawuARtview app** (if available).


No setup beyond activation is required.


== Frequently Asked Questions ==


= Which image does this plugin use? =
It always uses the **featured image** of the WooCommerce product.


= Does this work with any theme? =
Yes, as long as the theme uses the standard WooCommerce single product template.


= Does this use AR? =
This plugin provides a fast, accurate 2D in-space preview. For an immersive augmented experience, users can continue in the MawuARtview mobile app.


= Why doesn’t “Take a photo” open my camera on desktop? =
On desktop and laptop browsers, the “Take a photo” option opens a file picker instead of the camera. This is expected browser behavior for privacy and security reasons. On supported mobile devices, the same option opens the camera directly.

= What is the QR code shown on desktop? =
The QR code allows users to open the same artwork on their phone, where they can use their camera for a more natural experience.


== Screenshots ==


1. See the artwork on your wall before buying.
2. WooCommerce product page showing the "View in your space" button.
3. The overlay with upload and camera options.
4. Live preview interface on desktop (drag + scroll).
5. A wall photo loaded with artwork placed on it.
6. Frame selection and resizing in use.
7. Desktop QR bridge for mobile continuation.
8. Plugin settings page in WordPress.


== Changelog ==

= 2.4.1 =
* Added desktop QR bridge for continuing the preview on mobile.
* Added desktop keyboard controls for moving, resizing, resetting, and closing the preview.
* Improved desktop instructions and camera guidance.
* Improved desktop preview usability with mouse and keyboard support.

= 2.3.5 =
* Improved screenshots and visual presentation

= 2.3.4 =
* Updated screenshots for improved clarity

= 2.3.3 =
* Updated plugin icon for better clarity and visual impact

= 2.2.0 =
* Added MawuARtview app bridge (continue artworks in the mobile app).
* Introduced canonical artwork deep links.
* Minor UI enhancement.


= 2.1.1 =
* Added text domain loading for translation support.
* Improved script handling and dependency safety.
* Added `defer` loading for better performance.
* Updated asset handles and versioning.


= 2.1.0 =
* UI improvements for drag and touch interactions.
* More stable pinch-to-zoom.
* Updated frame rendering and shadow styling.
* Internal code cleanup and better compatibility.


= 2.0.0 =
* First public release based on the original snippet.