PegasusCo 3D Previews for WooCommerce

PegasusCo 3D Previews for WooCommerce adds a 3D preview to WooCommerce product pages. Assign GLB models to simple products or individual variations so the preview follows the shopper's selected size or finish. Shoppers can also switch variations inside an open preview. Optional USDZ files provide a prepared model for Apple's Quick Look on supported devices. Shoppers can rotate and zoom product models, then open AR on supported phones. Desktop shoppers can scan a QR code that keeps the selected product variation. The plugin bundles its viewer and QR code software locally. It does not require an account, subscription, analytics, or a hosted model service. Product models are public files served by your WordPress site or configured CDN.

1. Install and activate WooCommerce.
2. In WordPress, go to Plugins > Add New Plugin > Upload Plugin, upload the plugin ZIP, install it, and activate PegasusCo 3D Previews for WooCommerce.
3. For a simple product, edit the product and use Product data > 3D & AR to select its GLB model. Add a USDZ model and poster image if available.
4. For a variable product, open Variations and assign each variation its own model files. Save the variations and update the product. Models are not inherited from the parent product or another variation.
5. Open View in 3D directly on the product page, then choose a model-supported variation inside the preview. You can also place [your_ar_products id="123"] in a Shortcode block. Variable-product shortcodes can preview model-supported choices directly; matching classic forms also synchronise purchase selections.
6. Enable AR only after checking the model's scale, orientation, finish, and placement on the intended physical devices. Use HTTPS for phone testing. Only variations with a saved GLB appear in the preview controls; USDZ remains optional. View in 3D opens the selected supported variation or the closest available preview choice, without requiring purchase options first. If the purchase selection has no model, a notice explains that the preview explores other available variations. The preview controls identify the displayed choice; parent models are never inherited. Products with no variation GLBs keep the preview disabled. Automatic matches recognised storefront colour swatches and text buttons, with labelled dropdowns as the fallback. Text options such as Size are never inferred to be colours from their background. In Product data > Variations > 3D preview controls, choose Automatic, Dropdown, Text buttons or Colour swatches for each attribute, then Update the product. These settings only affect the preview. Colour swatches require configured storefront colour chips and fall back to a labelled dropdown when those colours are unavailable. Store owners can expand Model delivery diagnostics in each simple product or variation to check saved file URLs, sizes, MIME types, and server HTTP headers. On the product page, signed-in product editors can expand Device diagnostics for the current selection and run browser HEAD checks. These checks are on demand; a native AR app cannot report its final result back to the page. Save file changes before running editor diagnostics.

No external account or service registration is needed. Upload the individual model and poster files through the product editor; do not upload the model pack ZIPs.

0.2.11 Match the translation text domain to the WordPress.org slug pegasusco-3d-previews-for-woocommerce. Give license notices a .txt extension. 0.2.10 Recognise colour controls separately from text options so Size never becomes an empty colour circle in Automatic mode. Add per attribute preview display settings for Automatic, Dropdown, Text buttons and Colour swatches under Product data > Variations. 0.2.9 Use the display name PegasusCo 3D Previews for WooCommerce. The QR button says Hide QR code while the code is open. 0.2.8 Open 3D previews without choosing purchase options first. Show only model-supported preview variations and reuse storefront colour swatches. Keep classic selections and QR links aligned with the preview. 0.2.7 Link to source code for the bundled minified viewer and clarify where source for bundled libraries can be found. 0.2.6 Add storefront support for WooCommerce Add to Cart + Options variation pills and dropdowns, plus automatic preview placement beside product add-to-cart blocks. Follow the resolved variation, clear missing models, preserve selected attributes in QR links, and retain click-to-load behaviour. 0.2.5 Add a variation picker inside the open 3D preview, keeping it in sync with the WooCommerce selection and clearing unmapped models. Replace the preview close control with a centred icon. Allow Android Scene Viewer as a fallback for wall products and clarify AR availability messages. 0.2.4 Add owner-only saved-file delivery checks and current-device diagnostics, including browser checks and AR launch-route reporting. Make unmapped variation behavior explicit and keep previous models cleared. 0.2.3 Clarify plugin description, installation, requirements, support contact, and support scope for public distribution. 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.