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

Help customers visualize artwork on their walls before buying and purchase with confidence.

== Description ==

🎥 Watch the short demo video 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 walls 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).

Perfect for:

* Artists
* Art galleries
* Photographers
* Canvas stores
* Print sellers
* Home décor businesses
* Any WooCommerce store selling products that benefit from in-room visualization

== Why Use Mawu Art – View in Your Space? ==

* Increase buyer confidence.
* Reduce hesitation before purchasing.
* Help customers understand scale and placement.
* Improve engagement on product pages.
* Works without requiring an app.
* Lightweight and fast.
* No external service required.

== Features ==

* Uses the WooCommerce product featured image.
* Customers can upload a wall photo or take one using their device.
* Drag to reposition the artwork.
* Pinch to resize on touch devices.
* Scroll to resize on desktop.
* Keyboard controls on desktop.
* Frame options: none, black, white, and gold.
* Download the final preview as an image.
* Desktop-to-mobile QR bridge for camera usage.
* Optional continuation in the MawuARtview mobile app.
* Works with most WooCommerce themes.
* Lightweight and privacy-friendly.

== Compatibility ==

✓ WordPress 5.0+

✓ WooCommerce

✓ Most themes

✓ Desktop and mobile browsers

✓ iPhone and Android

✓ Touch and mouse devices

✓ No external API required

✓ Lightweight and fast

== 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 ensure the feature is enabled.
4. Make sure each WooCommerce product has a featured image.
5. Visit a product page. The “View in your space” button appears automatically.

== How to Use ==

1. Click “View in your space”.
2. Upload a wall photo or take one using your device.
3. Drag the artwork into place.
4. Resize using touch gestures, mouse wheel, or keyboard shortcuts.
5. Choose a frame style if desired.
6. Save the preview image.

On desktop, users can scan the QR code to continue on their phone for a more natural camera experience.

Users can also continue in the MawuARtview mobile app for a deeper experience.

== Frequently Asked Questions ==

= Which image does this plugin use? =

The plugin automatically uses the featured image of the WooCommerce product.

= Does this work with any theme? =

Yes. It works with most themes that use the standard WooCommerce single product template.

= Does this use augmented reality? =

The plugin provides a fast and accurate 2D in-space preview. Users seeking a more immersive experience can continue in the MawuARtview mobile app.

= Why doesn’t “Take a photo” open my camera on desktop? =

Desktop browsers usually open a file picker instead of the camera 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 customers to continue the same experience on their phone, where taking a wall photo is easier and more natural.

= Is an app required? =

No. The plugin works directly inside WooCommerce. The MawuARtview app is optional.

= Does the plugin send images to external servers? =

No. Everything happens locally in the customer's browser.

== Screenshots ==

1. Help customers visualize artwork before buying.
2. "View in your space" button on WooCommerce product pages.
3. Upload or take a wall photo.
4. Desktop experience with drag, scroll and keyboard controls.
5. Mobile experience with touch gestures.
6. Change frame colors and save the preview.
7. Continue on your phone with the desktop QR bridge.
8. Configure the plugin from WordPress settings.
== Changelog ==

= 2.5.0 =

* Added compatibility improvements.
* Improved settings experience.
* Added support and review links.
* Added review request mechanism.
* Improved plugin reliability and usability.
* Internal optimizations.

= 2.4.1 =

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

= 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.
* Introduced canonical artwork deep links.
* Minor UI enhancements.

= 2.1.1 =

* Added translation support.
* Improved script handling and dependency safety.
* Added defer loading for better performance.

= 2.1.0 =

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

= 2.0.0 =

* First public release.

== Love Mawu Art – View in Your Space? ==

If this plugin helps your customers visualize artwork more confidently, please consider leaving a review on WordPress.org.

Your support helps independent creators continue improving free tools for artists, galleries, and WooCommerce stores.