=== Your AR Products ===
Contributors: wallview
Tags: woocommerce, 3d, augmented reality, glb, usdz
Requires at least: 6.8
Requires PHP: 8.1
Requires Plugins: woocommerce
Stable tag: 0.2.2
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Self-hosted 3D previews with a separate model for each WooCommerce variation.

== Description ==
Updated staging release. Classic WooCommerce product editor and variation forms supported.
Google model-viewer and a QR generator are bundled locally. No subscription, vendor account, telemetry, or hosted model service is required. Your uploaded models are public delivery assets, not DRM-protected.

Features: GLB/USDZ media selectors, exact per-variation mapping, optional poster, on-demand viewer loading, accessible native dialog, QR links preserving selected attributes, fixed AR scale, wall/floor placement, capability-aware AR and missing-model states.

== Installation ==
1. On a staging copy with WooCommerce active, upload your-ar-products-0.2.2.zip through Plugins > Add New > Upload Plugin.
2. Edit a simple product. Open Product data > 3D & AR and choose a self-contained .glb. Optional: choose .usdz and a poster image. Update.
3. For variable products, open each variation and assign its OWN files. Parent files are never silently inherited. Save changes, then Update.
4. Visit the product page, select a variation and click View in 3D.
5. Test a correctly authored asset on physical phones before checking Enable AR. Use HTTPS for staging/production phone tests. Localhost on a desktop is not a phone-accessible URL.
6. Use the normal WooCommerce product template, or add [your_ar_products id="123"] in a Shortcode block. Variable previews require the product's classic variation form on the page; otherwise the shortcode links to the product page.

== Model requirements ==
Self-contained GLB 2.0 (no external buffer/image URLs), maximum 100 MB and within your host's lower upload limit. Keep production models substantially smaller for mobile downloads. Asset units must represent metres and its origin/orientation must suit the intended mounting surface.
USDZ is optional: without it, model-viewer generates an iOS file at launch. For controlled iPhone results, use a prepared and tested USDZ. Upload validation requires PHP ZipArchive, a stored/uncompressed archive, a USD root layer first, and permitted model/texture entries. Header/container checks do not validate artistic quality, anchoring, dimensions or every USD feature.

== AR limitations ==
Wall mode excludes Android Scene Viewer and uses WebXR or Quick Look. Unsupported devices retain 3D viewing. iPhone wall anchoring depends on the USDZ and native viewer; ar-placement="wall" does not force Quick Look to mount an arbitrary asset on a wall. Do not promise this before a physical iPhone test. AR does not simulate accurate mirror reflections or LED lighting in a room.

== Compatibility and scope ==
Test on your actual theme, cache/optimization plugins and supported devices. Full integration with the new WooCommerce block product editor or block-native variation controls is not implemented. The shortcode can be placed in a block theme using a Shortcode block; classic variation form requirements still apply.
No model conversion service, licensing server, auto-updater, storefront gallery replacement or analytics is included. Disable other model-viewer plugins while testing to avoid competing web-component registrations. Manual ZIP updates for now. Deactivation/uninstall intentionally preserves media and product metadata.

== Privacy ==
Plugin assets, QR generation and models are served locally (or via your WordPress media/CDN configuration). No analytics or account calls. Choosing native AR may launch the device's Apple/Google viewer. Public models remain retrievable by visitors.

== Third-party software ==
See THIRD_PARTY_NOTICES.md and assets/vendor license files. Source and dependency lockfile are provided with the development workspace. No third-party WordPress plugin code is included.

== Changelog ==
= 0.2.2 =
Show the Product data > 3D & AR tab only for simple products. Variable product model fields remain inside each variation.

= 0.2.1 =
Allow vertical and horizontal finger drags to rotate the model in the 3D preview instead of scrolling the page behind it.

= 0.2.0 =
Renamed to Your AR Products. Existing plugin folder, data keys and legacy shortcode are retained for in-place updates. Upload the new ZIP and choose Replace current with uploaded; do not install a second copy.
QR generation is now bundled in viewer.js and rendered as inline SVG, avoiding separate .mjs MIME and data-image failures. QR errors are visible, with a copy-link fallback. Phones receive AR actions rather than instructions to scan their own screen. Compatible iPhones with a prepared USDZ get a native Quick Look link that does not wait for the GLB. Mobile header layout corrected; loading timeout and retry added.

= 0.1.0 =
Initial staging prototype.
