PegasusCo 3D Previews for WooCommerce

By PegasusCo

0+ active installationsVersion 0.3.2

Add self-hosted 3D previews and optional mobile AR to WooCommerce, with a separate model for each product variation.

Description

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. Sources for the bundled JavaScript libraries, including Google model-viewer 4.3.1, are listed in THIRD_PARTY_NOTICES.md; license notices are included in the plugin ZIP. The plugin does not require a vendor account, subscription, or a hosted model service. Product models are public files served by your WordPress site or configured CDN.

Dimensions and hotspots

The free plugin includes standard dimension labels, custom point measurements and hotspots with text, images, videos or links to published WooCommerce products.

Use Edit dimensions and hotspots in the product or variation settings. Click the model to place points, click Save in the editor, then Update the product or save the variation changes. Measurement lines overlay the model and are not occluded by its surfaces.

When viewing your store, you can now preview the 3D models. Models load when the preview opens. Custom catalogue templates must include one of these hooks or place the shortcode explicitly.

Guided camera views, animation controls, advanced rendering and lighting controls belong to the separate Pro plugin. Free hotspots and dimensions remain available when Pro is deactivated.

Please note: Browser annotations and controls are not transferred to native phone AR viewers.

Storewide settings

Open 3D Previews > Settings in the WordPress sidebar to manage variation display defaults, dimensions, hotspots, preview images and owner diagnostics across your store. One Augmented reality switch controls phone AR and the iPhone USDZ model fields. Each model must also be enabled and tested individually before shoppers can use AR.

Choose the View in 3D button text, appearance and placement. Automatic buttons can be enabled separately for product pages and shop or category pages. Turn off automatic placement and use the shortcode for manual placement, or disable all previews with the main switch.

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.

Usage analytics

Usage recording is on by default and can be paused in 3D Previews > Settings. Free analytics show store totals for Daily (today), 7 Days and 30 Days. Counts include successful 3D model loads and AR launch attempts. Store owner previews are excluded. Counts are interactions, not unique shoppers or confirmed completed native AR views.

The separate updated Pro add-on unlocks 90 Days, All time and By product reports. These choices are greyed out and marked Premium in Free. Free dimensions and hotspots remain available without Pro.

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

Android AR can use WebXR or Google’s Scene Viewer on a compatible ARCore phone with Google Play Services for AR; Scene Viewer also accepts vertical-placement requests for wall products. Unsupported devices retain 3D viewing. Android and iPhone wall placement depends on the model, device, and native viewer; ar-placement=”wall” does not guarantee wall anchoring. Check both on physical phones before enabling AR. AR does not simulate accurate mirror reflections or LED lighting in a room.

Compatibility and scope

Requires WordPress 6.8 or later, PHP 8.1 or later, and WooCommerce. Test compatibility with your theme, cache/optimization plugins, and devices. Product assignments use the classic WooCommerce product editor. Storefront previews support classic variation forms, the Add to Cart Form block, and the Add to Cart + Options block with its native variation pills or dropdowns. The preview is added beside these product blocks automatically; [your_ar_products] can also be placed in a Shortcode block. Add to Cart + Options follows storefront changes and offers model-supported choices inside the preview. Preview changes in this block do not alter the purchase selection; use Change size or finish to return to its storefront controls. QR links preserve the selected attributes. Block support is tested with WooCommerce 11.1.1; check customised themes and future WooCommerce releases. The experimental block-based admin product editor was retired in WooCommerce 11.0.

The free plugin does not create or convert 3D models, guarantee AR behaviour on a particular device, replace your product gallery, or include a vendor licensing service or hosted model service. Mirror reflections and room lighting are not simulated. Deactivation and uninstall preserve product model assignments and uploaded media.

Support

For help with installing the plugin, assigning models, or investigating a reproducible plugin issue, email hello@pegasusco.com.au. Include your WordPress, WooCommerce, and PHP versions, the steps to reproduce the issue, and relevant screenshots. Do not email passwords, private customer information, or secret access links.

Support covers this plugin’s documented features. It does not include 3D modelling or model repair, custom theme development, general WordPress or hosting support, or guarantees that a particular model will work with every phone or AR viewer. Device and theme compatibility should be checked on your own store before enabling AR for shoppers.

Privacy

Plugin assets, QR generation and models are served by your WordPress site or configured media CDN. Usage recording is enabled by default and stores the calendar date, product ID and aggregate interaction counts in your WordPress database. It does not store visitor identifiers, IP addresses or tracking cookies, and local product analytics stay in your WordPress database. Optional count sharing is off by default. If enabled in 3D Previews > Settings, the plugin sends aggregate 3D open counts and a random delivery ID to PegasusCo once monthly. No product details, store URL, visitor identifiers or AR attempts are sent. PegasusCo may use shared counts in periodically updated public totals. Disable sharing to stop sending new counts. The receiving hosting service processes the store server connection information when handling requests. Counts are sent to https://www.pegasusco.com.au/api/plugins/usage. See privacy information and terms. Pause recording in 3D Previews > Settings. Existing counts are kept when recording is paused. Choosing native AR may launch the device’s Apple or Google viewer. Public models remain retrievable by visitors.

Installation

  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 assigned GLB do not show View in 3D. 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. 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.

Changelog

0.3.2

  • Quality of life improvements and a sidebar for easier settings navigation.

0.3.1

  • Added the 3D Previews sidebar hub for storewide settings and optional product variation overrides.
  • Added controls for preview button appearance, placement and visibility.
  • Combined phone AR and iPhone USDZ settings into one storewide switch.
  • Added local usage recording, enabled by default, with free Daily, 7 Days and 30 Days totals.
  • Added optional monthly sharing of aggregate 3D open counts with PegasusCo, disabled by default.
  • Added integration with the updated Pro add-on for extended history and product reports.
  • Improved the dimensions and hotspots editor with compact add buttons, conditional units, separated delete actions and a Save button.
  • Preserved saved model files and annotations when features are disabled.

0.3.0

  • Added free dimension overlays and custom point measurements.
  • Added free text, image, video and linked product hotspots with a visual editor.
  • Added previews on shop and category product cards that load models on demand.
  • Added integration points for Premium camera views, animations and rendering.

0.2.12

  • Added a preview of optional Pro lighting controls in the existing product and variation settings.
  • Added integration points for the separate Pro plugin. Lighting functionality is not included in this free plugin.

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.