=== 3D Viewer - 3D Model Viewer & 3D Product Viewer with AR for WooCommerce === Contributors: bplugins, abuhayat, shehabulislam, freemius, farazi1 Tags: 3d product viewer, 3d model viewer, woocommerce, augmented reality, glb Requires at least: 6.5 Tested up to: 7.1 Requires PHP: 7.4 Stable tag: 2.1.1 Donate link: https://www.buymeacoffee.com/abuhayat License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html WooCommerce 3D product viewer and 3D model viewer with free AR. Rotate, zoom, place in room. GLB, glTF, OBJ, STL. Block, Elementor, shortcode. == Description == **Add a 3D product viewer to WooCommerce and a 3D model viewer to any WordPress page. Visitors rotate, zoom and inspect every angle, then place the product in their own room with free Augmented Reality (AR). No code, no app, no account.** [**3D Viewer**](https://bplugins.com/products/3d-viewer/) | [**Documentation**](https://bplugins.com/docs/3d-viewer/) | [**Pricing**](https://bplugins.com/products/3d-viewer/pricing) | [**Support**](https://bplugins.com/support/) | [**Live Demo**](https://bplugins.com/products/3d-viewer/#demos) https://www.youtube.com/watch?v=jQrPkx-nlB8 ### Why Use a 3D Product Viewer Instead of Flat Photos? Static images make shoppers guess. 3D Viewer lets them explore. Turn a product a full 360 degrees, zoom in on the details, then see it at real size in their own space with AR. Customers who can inspect a product before buying have fewer doubts, so product pages work harder and fewer orders come back. The plugin is responsive and touch-friendly. It works the same on phones, tablets and desktops. ### 3D Product Viewer for WooCommerce, FluentCart and Dokan Sell online? Show your products in 3D right on the product page. * **WooCommerce 3D product viewer:** Add a GLB or glTF model in the 3D Product Settings box. Show it above, below or instead of the product images, or as the first gallery image with a View in 3D button. * **Shortcode anywhere:** [3d_viewer_product id="..."] shows a product's model in any page, post or template. * **FluentCart:** Add a model in each product's 3D Model tab and show it in or around the gallery. * **Dokan marketplace:** Let vendors add 3D models and AR to their own products, within fixed safety limits. Off by default. * **Theme Compatibility Mode:** Fixes custom WooCommerce galleries in one click. ### Free Augmented Reality (AR) for WordPress 3D Models **AR is free. No upgrade, no add-on.** Turn on Enable AR for a GLB or glTF model in the block, the Elementor widget or a shortcode viewer. * **Android:** Scene Viewer or WebXR. * **iPhone and iPad:** Quick Look. An optional .usdz file is supported, or the viewer converts your GLB on the fly. * **Desktop visitors:** Scan a QR code to open the model on their phone. * **Placement:** Floor or wall. AR on WooCommerce product pages is part of Pro. ### 3D Model Viewer for GLB, glTF, OBJ, STL, FBX and STEP Files Two viewers are built in, so you pick the right one for each file. * **Lite viewer:** GLB and glTF with AR, realistic lighting, environment and skybox images, and lazy loading. Fastest option. * **Advanced viewer (Three.js):** OBJ, STL, FBX, DAE, 3DS, 3MF, WRL and STEP. Good for 3D printing, CAD and game assets. Upload from the Media Library or paste a model URL. ### Works With the Block Editor, Elementor and Shortcodes * 3D Model Viewer block with a live preview while you edit. * Two Elementor widgets: 3D Model Viewer and 3D Product Model. * Shortcode [3d_viewer id="..."] for any post, page, widget or theme template. ### Free Features - Everything You Need to Get Started * **Viewer controls:** Fullscreen, zoom, screenshot and download buttons (download is off by default). * **Lighting:** Exposure, shadows, an environment image and an HDR skybox. * **Poster and progress bar:** Show an image and loading progress until the model is ready. * **Size and background:** Width, height, alignment, color or transparent background. * **Lazy loading:** Lite viewer models load when they scroll into view. On by default in the block and shortcode viewers. * **Compressed models:** Draco and KTX2 compressed GLB files are supported. * **Easy admin:** A new admin interface with live preview (or the classic one) and a Guided Setup. * **Safe uploads:** Choose the allowed 3D formats. Scripts disguised as 3D files are refused. * **No tracking:** No account, no visitor tracking. ### 3D Viewer Pro - More Control for Bigger Catalogs [3D Viewer Pro](https://bplugins.com/products/3d-viewer/pricing) adds: * **Hotspots and annotations:** Info, link, image, video, product, animation and waypoint hotspots. * **Several models in one viewer,** with a thumbnail strip. * **WooCommerce 3D gallery:** Several models per product, a model per variation, a 3D tab, popups, 3D in shop listings and AR on product pages. * **Camera control:** Initial view, zoom level, auto-rotate and rotation locks. * **Animations and material variants,** exploded view and real-world dimensions. * **Cloud Storage:** Serve models from your own Amazon S3, Cloudflare R2, Google Drive, Dropbox and more, using signed URLs. * **More formats:** Advanced viewer on WooCommerce products, plus PLY, OFF, 3DM, AMF, IFC, BREP, IGES, FCSTD and BIM uploads. * **Presets, 3D analytics,** custom loading spinner, poster-only mode for phones and drag-and-drop control placement. * **More for FluentCart and Dokan:** Per-variant models, hotspots, popups and more vendor controls. ### How to Add a 3D Model to WordPress in Under a Minute 1. Go to 3D Viewer, then Add New. 2. Upload your 3D model, or paste its URL. 3. Pick the Lite or Advanced viewer. Adjust lighting, AR, buttons, size and background. 4. Click Publish and copy the [3d_viewer id="..."] shortcode. 5. Paste it into any post, page or widget. **WooCommerce:** Open a product, add a GLB or glTF file in the 3D Product Settings box, choose a 3D Viewer Position and publish. **Block editor:** Add the 3D Model Viewer block, choose your model and publish. ### Use Cases * **Online stores:** Furniture, jewelry, shoes, bags, electronics, toys and more. Let customers inspect products before buying. * **Education and training:** Anatomy, machines and science models. * **Architecture and engineering:** Buildings, plans and prototypes. * **3D printing and CAD:** Show STL and STEP files right in the browser. * **Portfolios:** Sculpture, product design and game assets. ### Supported 3D File Formats * **Lite viewer (with AR):** GLB, glTF * **Advanced viewer:** OBJ, STL, FBX, DAE, 3DS, 3MF, WRL, STEP, GLB, glTF * **Advanced viewer, from a URL:** PLY, OFF, 3DM, AMF, IFC, BREP, IGES, FCSTD, BIM * **Also accepted:** USDZ for iPhone and iPad AR, and HDR for skybox and environment images WooCommerce product pages use the Lite viewer. ### What Users Say "It's the most valid plugin I have found for viewing 3D models. The support is also very good and an issue I reported was immediately corrected." - diegoparoni "The 3D Viewer plugin is an excellent tool - very powerful, easy to use, and perfect for displaying product designs in a clear and engaging way." - fumiotanuma "...the free version offers the necessary capabilities to view and render our models effectively." - Brandon Like the plugin? Missing a feature? Send your feedback through the [support page](https://bplugins.com/support/). We ship improvements every month. ### Check Out Our Other WordPress Plugins * [HTML5 Video Player](https://wordpress.org/plugins/html5-video-player/) - Videos and playlists in multiple skins. * [HTML5 Audio Player](https://wordpress.org/plugins/html5-audio-player/) - Audio and podcast player. * [PDF Poster](https://wordpress.org/plugins/pdf-poster/) - Embed PDF files. * [StreamCast](https://wordpress.org/plugins/streamcast/) - Live radio player. * [Advanced Post Block](https://wordpress.org/plugins/advanced-post-block/) - Posts in different layouts. == Installation == **From your WordPress dashboard (recommended):** 1. Go to Plugins, then Add Plugin (Add New Plugin in older WordPress versions). 2. Search for "3D Viewer". 3. Click Install Now, then Activate. 4. Follow the short Guided Setup that opens, or skip it. 5. Go to 3D Viewer, then Add New to add your first model. **Manual installation:** 1. Upload the 3d-viewer folder to the /wp-content/plugins/ directory. 2. Activate the plugin through the Plugins menu in WordPress. 3. Create a viewer under 3D Viewer, then Add New and paste its [3d_viewer id="..."] shortcode into any page, post, or widget. 4. To embed it in a theme template, use: `` == Frequently Asked Questions == = How do I add a 3D model to a WooCommerce product? = Open the product, find the 3D Product Settings box, add a GLB or glTF model in 3D Source, and choose a 3D Viewer Position: above, below or instead of the product images, or on the first gallery image with a View in 3D button (the default for new products). To show a product's model anywhere else, use [3d_viewer_product id="..."] or the 3D Product Model Elementor widget. Pro adds several models per product, a model per variation, a 3D tab, popups, 3D in shop listings, and AR on product pages. = Is there a free 3D product viewer for WooCommerce? = Yes. The free version shows a GLB or glTF model on WooCommerce product pages with rotate, zoom, fullscreen and lazy loading. Pro adds several models per product, a model per variation and AR on product pages. = Does it support Augmented Reality (AR)? = Yes, and it is free. Turn on Enable AR for a GLB or glTF model (Lite viewer) in the 3D Model Viewer block, the Elementor widget or the viewer editor, then choose the AR placement (floor or wall) and AR mode. Visitors on supported Android phones open the model with Scene Viewer or WebXR, and on iPhone and iPad with Quick Look. Desktop visitors can scan a QR code to open it on their phone. An iOS .usdz file is optional: without one, the viewer converts your GLB for Quick Look on the fly. On WooCommerce product pages, AR is part of Pro, and it also works for models added by Dokan vendors. = How do I add AR to my WooCommerce store? = Use Pro to turn on AR on product pages. In the free version, you can add AR to any page, post or landing page with the block, the Elementor widget or a shortcode viewer, then link to it from your product. = Which 3D file formats does this plugin support? = The Lite viewer shows GLB and glTF files, with AR. The Advanced viewer also opens OBJ, STL, FBX, DAE, 3DS, 3MF, WRL and STEP files, plus PLY, OFF, 3DM, AMF, IFC, BREP, IGES, FCSTD and BIM files from a URL. Choose the viewer in the block, the Elementor widget or the viewer editor. WooCommerce product pages use the Lite viewer, so add GLB or glTF files to products. = Lite or Advanced viewer - which should I use? = Use Lite for GLB and glTF: it loads fastest and supports AR, lighting, environment and skybox images, and lazy loading. Use Advanced for other formats, such as STL files for 3D printing or STEP files from CAD software. For the web, GLB is the best choice, and most 3D tools can export it. = How do I show an STL or OBJ file in WordPress? = Go to 3D Viewer, then Add New, upload the file, and choose the Advanced viewer. Tick the format under Allowed Mime Types in 3D Viewer, then Settings first if the upload is blocked. Then paste the shortcode into any page or post. = Can I use this plugin with Elementor? = Yes. Use the 3D Model Viewer widget for any model, or the 3D Product Model widget for a product's model. Shortcodes work in Elementor too. = Does 3D Viewer work with FluentCart? = Yes, with FluentCart 2.2.0 or newer. Open a FluentCart product, go to its 3D Model tab, and pick a model and viewer. Show it in the gallery as a thumbnail, above or below the gallery, instead of it, or nowhere (shortcode only). You can turn the integration off under 3D Viewer, then Settings, then FluentCart. = Can Dokan vendors add 3D models? = Yes, once you turn on Allow vendors to add 3D models under 3D Viewer, then Marketplace (Dokan). Vendors can then add a GLB model (up to 20 MB), a poster, AR with an optional USDZ file for iOS, a viewer position and a background color to their own products. It is off by default. = My model doesn't show, or keeps loading. What can I check? = * The selected viewer supports the file's format (Lite shows GLB and glTF only). * The model's URL uses HTTPS if your site does. * A plugin that minifies, combines or delays JavaScript isn't changing 3D Viewer's scripts. If it is, exclude them. * No other 3D plugin loads its own copy of model-viewer on the same page. * The file isn't too large for mobile visitors. A few MB is ideal. = I can't upload my .glb, .obj or .stl file. = Tick the format under Allowed Mime Types in 3D Viewer, then Settings, and make sure the file is smaller than your server's maximum upload size. If you copied the file to your server another way (for example by FTP), paste its URL instead. It won't appear in the Media Library. = The 3D model breaks my theme's product gallery. = Turn on Theme Compatibility Mode under 3D Viewer, then Settings, then Woocommerce Settings. If your theme uses its own gallery, also set its Gallery Selector there. Still stuck? [Contact support](https://bplugins.com/support/) with a link to the page. = Can I load models from an external URL? = Yes. Paste the model's URL in the block, the Elementor widget, the viewer editor (new interface) or the WooCommerce product box. The server hosting the file must allow cross-origin requests (CORS). Share links from services like Google Drive open a web page rather than the file, so they won't load. Pro adds Cloud Storage, so you can pick models from your own Amazon S3, Cloudflare R2, Google Drive, Dropbox and other storage. = Will 3D models slow down my website? = Not if you keep them light. Lite viewer models load only when they scroll into view. This is on by default in the block and shortcode viewers. In the Elementor widget, turn on Lazy Load. For WooCommerce, set Loading Type to Lazy under 3D Viewer, then Settings, then Woocommerce Settings. Keep files small: Draco and KTX2 compressed GLB files are supported, and a few MB is ideal. = My model looks dark, white or has no textures. = Export a GLB file with its textures embedded. In the Lite viewer, raise Exposure or choose another Environment Image for brighter, more realistic lighting. = Can visitors download my 3D model file? = Only through the download button, and it is off by default. Turn on 3D File Download Button per viewer in the block, the Elementor widget or the viewer editor. A browser has to download a model to display it, so no viewer can fully stop a determined visitor from saving the file. = Can the model rotate by itself, play its animation or start at a set angle? = These are Pro features: auto-rotate with speed and delay, animation autoplay and selector, initial view, zoom level and rotation locks. = What happens to my 3D models if I uninstall the plugin? = They stay, unless you turn on Delete data on uninstall under 3D Viewer, then Settings, then General Settings. Nothing is deleted while 3D Viewer Pro is installed. = Does 3D Viewer track visitors or need an account? = The free version doesn't. There is no account to create and no visitor tracking. Models load from your own site or the URL you set. The few outside requests the plugin can make, such as decoders for compressed models, are listed under External Services. = How can I get help, or ask for customization? = Contact us through [bPlugins support](https://bplugins.com/support/) for help, feature requests and custom work. Pro customers, please use that page too. The WordPress.org forums are for the free version only. == Screenshots == 1. WooCommerce: 3D right in the product gallery, with one tap back to the photos. 2. WooCommerce: or put the 3D model in place of the product image (four free positions). 3. A 3D viewer anywhere on your site, with zoom, screenshot, download and fullscreen buttons. 4. Fullscreen: visitors turn and zoom the model on the whole screen. 5. Made for phones: touch to turn and zoom, and one tap for AR on iPhone and Android. 6. On a computer? Visitors scan the QR code to see the model in their room with AR. 7. STL, STEP, OBJ, FBX and more, shown right on the page with no conversion. 8. As many viewers as you need: collections, portfolios, blogs and landing pages. 9. A modern editor with a live preview: paste or upload a model and see it in 3D as you work. 10. Built into the block editor: set the model, poster, lighting and skybox in the sidebar. == Source Code == The uncompiled source of everything in `build/` is on GitHub, where you can also report bugs and contribute: [**3D Viewer on GitHub**](https://github.com/bPlugins/3d-viewer-wp) (this release is tag `v2.1.1`). To build it, clone [bpl-tools](https://github.com/bPlugins/bpl-tools) next to the plugin folder, then run `npm install --legacy-peer-deps` and `npx wp-scripts build --webpack-copy-php`. == External Services == 3D Viewer connects to the services below. Only the decoder downloads (Google Hosted Libraries, jsDelivr) and the Android AR hand-off (Google Scene Viewer) can happen for site visitors; the others happen in wp-admin, for administrators. Like any web request, these reveal the browser's IP address and user agent. = bPlugins = * **Service:** bPlugins product API – `https://api.bplugins.com` – and demo site – `https://3d-viewer.bplugins.com` * **What it does:** Loads 3D Viewer's plans and prices for the Pricing and Feature Comparison tabs of **3D Viewer → Help & Demos**, and shows a live demo when you click one on the Demos tab. * **What data is sent:** A request from the administrator's browser for the product ID or the demo page. No site content. * **When:** Only when an administrator opens those tabs or clicks a demo. * **Terms of Service:** [https://bplugins.com/terms-of-service/](https://bplugins.com/terms-of-service/) * **Privacy Policy:** [https://bplugins.com/privacy-policy/](https://bplugins.com/privacy-policy/) = WordPress.org Plugins API = * **Service:** `https://api.wordpress.org`, with plugin icons from `https://ps.w.org` * **What it does:** Lists other plugins by bPlugins (titles, icons, ratings, active installs) on the Our Plugins tab of **3D Viewer → Help & Demos**. * **What data is sent:** A public, read-only query (`https://api.wordpress.org/plugins/info/1.2/?action=query_plugins&request[author]=bplugins`) and icon requests. No site content. * **When:** Only when an administrator opens that tab. * **Privacy Policy:** [https://wordpress.org/about/privacy/](https://wordpress.org/about/privacy/) = Freemius (opt-in usage data) = * **Service:** `https://api.freemius.com` * **What it does:** After activation, offers an opt-in for update notices and diagnostic data, and an optional feedback form on deactivation. * **What data is sent:** Only after an administrator opts in: site address and title, WordPress, PHP, plugin and Freemius SDK versions, site language, the plugin's status, and that administrator's name and email address; the list of plugins and themes only if that permission stays on; and a deactivation reason, if one is submitted. [Details](https://freemius.com/wordpress/usage-tracking/8795/3d-viewer/) * **When:** Nothing is sent until an administrator clicks "Allow & Continue"; then on activation, deactivation and periodic syncs. * **Terms of Service:** [https://freemius.com/terms/](https://freemius.com/terms/) * **Privacy Policy:** [https://freemius.com/privacy/](https://freemius.com/privacy/) = Freemius Checkout = * **Service:** `https://checkout.freemius.com` * **What it does:** Opens the checkout inside wp-admin to buy 3D Viewer Pro or an add-on. The **3D Viewer → Extensions** page loads Freemius's `checkout.min.js` when it opens. * **What data is sent:** Product, plan, license count, billing cycle and the wp-admin page address. Buying an add-on on the Extensions page, or on the Extensions tab of Help & Demos, also sends the administrator's name and email address to pre-fill the form. Payment details go only to Freemius. * **When:** When an administrator opens the Extensions page or clicks a buy or upgrade button. * **Terms of Service:** [https://freemius.com/terms/](https://freemius.com/terms/) * **Privacy Policy:** [https://freemius.com/privacy/](https://freemius.com/privacy/) = YouTube = * **Service:** `https://www.youtube-nocookie.com` (privacy-enhanced mode) * **What it does:** Plays the tutorial video in the Guided Setup. * **What data is sent:** The player request from the administrator's browser; YouTube may set cookies once the video plays. * **When:** Only when an administrator clicks the tutorial video. * **Terms of Service:** [https://www.youtube.com/t/terms](https://www.youtube.com/t/terms) * **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy) = Google Hosted Libraries (Draco and Basis decoders) = * **Service:** `https://www.gstatic.com` * **What it does:** The bundled `` library downloads the Draco mesh decoder and the Basis Universal texture decoder from Google's CDN, but only for models that use Draco compression or KTX2/Basis textures. * **What data is sent:** A plain file request. No site content. * **When:** On the front end and in editor previews, when such a model is shown in the Lite viewer. * **Terms of Service:** [https://developers.google.com/speed/libraries/terms](https://developers.google.com/speed/libraries/terms) * **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy) = jsDelivr = * **Service:** `https://cdn.jsdelivr.net` * **What it does:** The bundled Online 3D Viewer (the Advanced viewer) downloads the `occt-import-js`, `rhino3dm`, `web-ifc` and `draco3d` decoders for models that need them (STEP, IGES, BREP, 3DM, IFC or Draco-compressed). In the classic admin interface, the bundled Codestar Framework loads the Font Awesome 5.15.4 icon stylesheets. * **What data is sent:** A plain file request. No site content. * **When:** On the front end and in editor previews, when such a model is shown in the Advanced viewer; on 3D Viewer admin screens when the classic interface is selected. * **Terms of Service:** [https://www.jsdelivr.com/terms](https://www.jsdelivr.com/terms) * **Privacy Policy:** [https://www.jsdelivr.com/terms/privacy-policy](https://www.jsdelivr.com/terms/privacy-policy) = Google Scene Viewer (AR on Android) = * **Service:** Scene Viewer, part of the Google app on Android * **What it does:** When AR is on, `` can hand the model to Scene Viewer, which downloads it from your site and shows it in AR. * **What data is sent:** The model file's address and the page address, passed to the Google app on the visitor's device. * **When:** Only when an Android visitor taps the AR button. AR is off by default. * **Terms of Service:** [https://policies.google.com/terms](https://policies.google.com/terms) * **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy) == Third-Party Libraries == 3D Viewer bundles the libraries below. = Google Model Viewer 4.2.0 = * **File:** `public/js/model-viewer.latest.min.js` – `dist/model-viewer.min.js` of `@google/model-viewer` 4.2.0, unchanged except that the source-map comment is removed * **Source:** [https://github.com/google/model-viewer](https://github.com/google/model-viewer) * **License:** Apache-2.0 – [https://github.com/google/model-viewer/blob/master/LICENSE](https://github.com/google/model-viewer/blob/master/LICENSE) * **Includes:** Three.js r182 – MIT – [https://github.com/mrdoob/three.js](https://github.com/mrdoob/three.js); Lit (lit-html 3.3.2, LitElement 4.2.2, @lit/reactive-element 2.1.2) – BSD-3-Clause – [https://github.com/lit/lit](https://github.com/lit/lit) * **Purpose:** The `` web component behind the Lite viewer, AR and WooCommerce product display. = Online 3D Viewer 0.15.0 = * **File:** `public/js/o3dv.min.js` – `build/engine/o3dv.min.js` of release 0.15.0, plus a zoom on/off switch (`SetZoomStatus()`) for the Zoom setting * **Source:** [https://github.com/kovacsv/Online3DViewer](https://github.com/kovacsv/Online3DViewer) * **License:** MIT – [https://github.com/kovacsv/Online3DViewer/blob/master/LICENSE.md](https://github.com/kovacsv/Online3DViewer/blob/master/LICENSE.md) * **Includes:** Three.js r163 – MIT; fflate 0.8.2 – MIT – [https://github.com/101arrowz/fflate](https://github.com/101arrowz/fflate); Chevrotain 9.0.1 – Apache-2.0 – [https://github.com/Chevrotain/chevrotain](https://github.com/Chevrotain/chevrotain) * **Purpose:** The Advanced viewer. = Codestar Framework 2.3.1 = * **Folder:** `vendor/codestar-framework/` * **Source:** [https://github.com/Codestar/codestar-framework](https://github.com/Codestar/codestar-framework) * **License:** GPLv2 – [https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md](https://github.com/Codestar/codestar-framework/blob/master/LICENSE.md) * **Purpose:** The classic admin interface. = bfields 1.1.1 = * **Folder:** `lib/bfields/` * **Source:** [https://github.com/bPlugins/bfields](https://github.com/bPlugins/bfields), tag `v1.1.1` – [bfields 1.1.1 (zip)](https://github.com/bPlugins/bfields/releases/download/v1.1.1/bfields.zip). `lib/bfields/build/` is compiled from that tag's `ui/` folder with `npm ci && npm run build`. This copy adds a few layout rules directly to the readable `build/index.css` and `build/index-rtl.css`, plus coding-standards comments and input sanitizing in `php/`. * **License:** GPLv2 or later – [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) * **Purpose:** The new admin interface for Settings, viewers and product boxes. = bp-extension-manager 1.0.0 = * **Folder:** `vendor/bp-extension-manager/` * **Source:** [https://github.com/bPlugins/bp-extension-manager](https://github.com/bPlugins/bp-extension-manager) (commit `028b866`); `build/` is compiled from its `src/` folder. * **License:** GPLv2 or later – [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) * **Purpose:** The **3D Viewer → Extensions** page. Its add-on list is a local file (`public/extensions.php`); the page loads Freemius Checkout (see External Services). = bpl-tools = * **Used in:** `build/blocks/3d-viewer/index.js` and `build/dashboard.js` (compiled in) * **Source:** [https://github.com/bPlugins/bpl-tools](https://github.com/bPlugins/bpl-tools) (commit `5074778`) * **License:** GPLv2 or later – [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) * **Purpose:** Shared block editor controls and the Help & Demos checkout. = Freemius SDK 2.13.5 = * **Folder:** `vendor/freemius/wordpress-sdk/` * **Source:** [https://github.com/Freemius/wordpress-sdk](https://github.com/Freemius/wordpress-sdk) * **License:** GPLv3 – [https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt](https://github.com/Freemius/wordpress-sdk/blob/master/LICENSE.txt) * **Purpose:** The opt-in, deactivation feedback and licensing (see External Services). = Inter (font) = * **Files:** `build/fonts/inter-*.woff2`, `lib/bfields/build/fonts/inter-*.woff2` * **Author:** Rasmus Andersson – [https://github.com/rsms/inter](https://github.com/rsms/inter) * **License:** SIL Open Font License 1.1 – [https://github.com/rsms/inter/blob/master/LICENSE.txt](https://github.com/rsms/inter/blob/master/LICENSE.txt) * **Purpose:** The typeface of the Help & Demos, Guided Setup and new admin interface screens. Self-hosted; no requests to Google Fonts. = Fisherman's Bastion environment map = * **Files:** `build/images/posx|negx|posy|negy|posz|negz.*.jpg` (unchanged, taken from Online 3D Viewer's website assets) * **Author:** Emil Persson, aka Humus – [http://www.humus.name](http://www.humus.name) * **License:** CC BY 3.0 – [https://creativecommons.org/licenses/by/3.0/](https://creativecommons.org/licenses/by/3.0/) * **Purpose:** The reflections in the Advanced viewer. = Also compiled into build/ = * node-qrcode 1.5.4 – MIT – [https://github.com/soldair/node-qrcode](https://github.com/soldair/node-qrcode) – draws the AR QR code in the browser * React Router 7.18.1 – MIT – [https://github.com/remix-run/react-router](https://github.com/remix-run/react-router) – Help & Demos navigation * Freemius Checkout JS – MIT – [https://github.com/Freemius/freemius-checkout-js](https://github.com/Freemius/freemius-checkout-js) – the Help & Demos checkout == Changelog == = 2.1.1 - 19 November, 2026 = * Changed: Viewer buttons are round with outline icons and a larger touch area; custom icon colours on `.control-btn` now need `!important`. * Changed: The AR QR code card is larger and titled "View in AR". * Changed: The WooCommerce 3D Product Settings box now sits right below Product data. * Changed: The classic Settings screen no longer shows Reset buttons. * Fixed: On right-to-left sites the Lite viewer model no longer slides off the stage. * Improvement: Clearer labels and help text in Settings, the viewer editor, the block and the Elementor widget. = 2.1.0 - 2 November, 2026 = * New: FluentCart integration: show 3D models on FluentCart product pages. * New: Dokan integration: vendors can add 3D models to their own products (off by default). * New: WooCommerce products show AR and the iOS USDZ model set in Pro or by a Dokan vendor; the product box can switch AR and change the USDZ file. * Improvement: Products without 3D settings start on Show 3D on First Image instead of None; products with 3D settings keep theirs. * Changed: The AR QR code opens centred over the model instead of beside the AR button. * Fixed: A product without a model no longer loads an empty viewer and its scripts. * Fixed: The Lite viewer poster is now centred instead of anchored to the top-left. * Fixed: Advanced Viewer: switching models threw console errors, and pages with Tailwind CSS shrank it to a small box. * Security: The iOS (USDZ) model URL now accepts web addresses only, so an unsafe link can no longer reach the AR button. = 2.0.0 - 18 October, 2026 = * New: New admin interface for Settings, viewers and WooCommerce products; switch back to the classic interface any time from Settings. * New: Redesigned Help & Demos dashboard. * New: Exit fullscreen button. * Changed: Model pickers show only 3D files. * Changed: Viewer controls are now buttons; custom CSS that targets `svg.control-btn` should use `.control-btn`. * Fixed: Saving in the free version no longer drops data added with the Pro version. * Fixed: Lazy Load now works for blocks and WooCommerce products. * Fixed: Theme Compatibility Mode works with more themes. * Fixed: The Advanced viewer no longer downloads the model twice. * Fixed: Multi-model viewers made with Pro show their first model, as Pro does without a licence. * Fixed: Re-saving an older viewer no longer turns on zoom buttons, the progress bar, or a different environment image. * Fixed: The download button icon no longer goes blank on some themes and in the Live Preview. * Fixed: The model picker notes list the formats actually enabled for upload. * Fixed: `[3d_viewer_product id="…"]` shows that product's model on any page. = 1.9.4 - 26 September, 2026 = * Changed: Redesigned the guided setup as a three-step onboarding. * New: Added a Monthly billing cycle to the Pricing page. * Update: The block editor placeholder now reads "Add Your 3D Model" and keeps the block's height. * Update: The old guided setup URL now redirects to the new one. = 1.9.3 - 9 September, 2026 = * New: Environment Image and HDR Skybox Image are now available in the free version, in the Gutenberg block, the Elementor widget, and the shortcode generator. * Fixed: The viewer no longer spins forever when the 3D model file is missing (404) or fails to load; it now shows a short message instead. * Update: All supported 3D formats, including .hdr for skybox images, are now enabled for upload by default; any of them can still be turned off in Settings → Allowed Mime Types. * Fixed: The double-extension upload guard (e.g. model.php.glb) passed such files through instead of blocking them; they are now refused. * Fixed: Guided Setup kept its full-screen layout only if no other plugin appended its admin body class without a space (e.g. Tutor LMS); it now stays full-screen regardless. = 1.9.2 - 12 August, 2026 = * New: Added a 3D file download button that lets visitors download the model file from the viewer. Off by default, and available in the Gutenberg block, the Elementor widget, and the shortcode generator. * New: Added a guided setup walkthrough for new installs, covering the ways to add a model and ending on your first 3D model. Existing sites can start it from Help & Demos → Guided Setup. * Fixed: Uninstalling the free plugin no longer removes 3D Viewer data while 3D Viewer Pro is active. * Fixed: The Elementor widget no longer stays blank on sites that reorder, defer, or delay scripts, and the editor preview now always loads the viewer libraries. * Update: The Elementor widget keeps its configured height while no model is selected, instead of collapsing to the widget icon. * Update: Rebuilt the Elementor file picker with a file preview, a Replace button and a Remove button. Selected files are unchanged. * Fixed: The Elementor file picker no longer clashes with other bPlugins plugins (Panorama Lite, HTML5 Video Player) that shipped a control of the same name, which could leave one plugin's picker unresponsive. * Update: Augmented Reality (AR) is now available in the free version, including WebXR, Scene Viewer, Quick Look, QR code access, AR placement, and the iOS .usdz source. = 1.9.1 - 19 July, 2026 = * New: Enabled GLB and GLTF uploads by default; other formats can be enabled from Settings → Allowed Mime Types. * New: Added reminder notices in the shortcode generator, Gutenberg block, and Elementor widget prompting to enable other 3D formats from settings. = 1.9.0 - 18 July, 2026 = * New: Added Augmented Reality (AR) support with WebXR, Scene Viewer, and Quick Look modes, including QR code access to view models in AR from mobile devices. * New: Added an iOS-specific (.usdz) model source for AR Quick Look on Apple devices. * New: Added Exposure and Shadow Intensity controls for the Model Viewer. * New: Added a live 3D model preview panel to the editor metabox. * New: Added an Extensions catalog and manager to the admin dashboard. * Update: Refactored the admin dashboard with section icons and an improved layout. = 1.8.13 - 01 June, 2026 = * Update: Tested with WordPress 7.0 and Updated Product Meta Field. * Update: Prefixed isGutenberg meta key and configuration options for standards compliance. * Fixed: Hardened file extension exception checks against double-extension script uploads. * New: Added Allowed Mime Types settings checklist to enable/disable 3D file formats on upload. * New: Integrated dynamic and minimal warning notices in Metaboxes and Gutenberg sidebar. = 1.8.12 - 16 May, 2026 = * Update: Overall code quality and strengthened security protocols. * Update: Required WordPress version updated. = 1.8.11 - 13 May, 2026 = * Update: Removed Custom CSS Field from Settings = 1.8.10 - 09 May, 2026 = * Improved: Overall code quality and strengthened security protocols. = 1.8.9 - 05 May, 2026 = * Update: Updated Codestar Framework for better stability. * Update: Removed restricted "Locked Fields" to improve user flexibility * New: Added Zoom In/Out controls to the Classic Shortcode Generator. * New: Added Camera controls to the Classic Shortcode Generator. * Improved: Overall code quality and strengthened security protocols. = 1.8.8 - 02 April, 2026 = * Fixed: Woocommerce order issue = 1.8.7 - 28 Mar, 2026 = * Fixed: Move elements fields to 'Elements' tab in classic editor * Fixed: Zoom not working in 'Advanced' Viewer * Update: Freemius SDK = 1.8.6 - 15 Mar, 2026 = * Fixed: Remove unknown anchor link = 1.8.5 - 10 Mar, 2026 = * Fixed: STL File does not work * Fixed: Does not work on Elementor Page Builder = 1.8.4 - 28 Feb, 2026 = * New: 4-step Setup Wizard after installation. * Fixed: WooCommerce variation not working. * Fixed: Shadow not working. * Fixed: Rotation Delay not working. * Update: Added Info text with all the controls. * Update: Remove affiliate and contact Submenu. * Update: Minimize Shortcode area (Classic Shortcode Generator). = 1.8.3 - 17 Dec, 2025 = * Fixed: new shortcodes were not working properly. = 1.8.2 - 4 Dec, 2025 = * Feature: Option to add Link on hotspot (Premium) * Improved: Some JS and CSS coding * Feature: AR mode on Classic Shortcode Generator = 1.8.1 - 5 Nov, 2025 = * Update: Library update * Fixed: Flatsome theme conflict * Removed: Hand tool on the model * Featature: Fullscreen Button on iPhone = 1.8.0 - 15 Sep, 2025 = * New Page: Dashboard * Added: Visual Editor * Feature: Show 3D on First Image of Woocommerce Gallery * Fixed: Broken Product Page Layout * Fixed: public.css not found * Improved: Code * Feature: Set Initial View (Premium) * Feature: Argument Reality (AR) (Premium) * Feature: Option to add Hotspot/Annotation (Premium) * Feature: Lock X/Y Axis Rotation (Premium) * Feature: Capture Button (Premium) * Feature: Zoom In/Out Button (Premium) * Feature: AR view using QR code (Premium) * Added: Presets (Premium) * Improved: Display 3D models in shop pages and product listings (Premium) = 1.7.0 - 9 Jul, 2025 = * Fixed: AR Icon on iPhone * Fixed: Fatal/Critical error on product page * Fixed: Showing Different 3D Models for Product Variations in WooCommerce when single attribute * Fixed: Fullscreen does not work on iPhone * Fixed: 3d_viewer_product shortcode does not work properly * Feature: Field to add Skybox Height * Feature: Show model based on multiple product variable * Feature: Added Loader = 1.6.3 - 7 May, 2025 = * Fixed: _load_textdomain_just_in_time was called incorrectly = 1.6.2 - 12 Feb, 2025 (Pro) = * Feature: Option to Show Edge and Customize the color (Advanced Viewer, Premium) * Option: Enable/Disable Zoom (Advanced Viewer) * Option: Enable/Disable Zoom (Woocommerce) = 1.6.1 - 12 Feb, 2025 (Pro) = * Fixed: can't read properties of undefined percentageWrapper = 1.6.0 - 5 Feb, 2025 (Pro) = * Option: Add HDR skybox image (Premium) * Option: Tone Mapping (only available on Gutenberg) (Premium) * Feature: Apply Factor and Texture to a model (only available on Gutenberg) (Premium) * Feature: Modify Material using Texture option (only available on Gutenberg) (Premium) = 1.5.1 - 1 Feb, 2025 = * Update: WordPress SDK = 1.5.0 - 03 Sep, 2024 = * Feature: Set Skybox Image to the model * Feature: AR Feature * Fixed: Rotation delay = 1.5.0 - 03 Sep, 2024 = * Improved: code * Feature: Option to display a poster/image until the model loads. * Feature: Compatible with most themes * Fixed: Does not work fullscreen on product shortcode = 1.4.2 - 27 June, 2024 = * Fixed: create dynamic property = 1.4.0 - 24 March, 2024 = * Feature: Set Zoom Level * Feature: Set Environment Image = 1.3.28 - 3 Mars, 2024 = * Fixed: WoodMart Single product image CSS = 1.3.27 - 12 Feb, 2024 = * Fixed: Custom Angle = 1.3.26 - 7 Feb, 2024 = * Fixed: Modal width issue = 1.3.25 - 28 Jan, 2024 = * Feature: Lite/Advanced viewer added on WooCommerce product = 1.3.24 - 17 Jan, 2024 = * Improved: Custom Selector = 1.3.23 - 7 Dec, 2023 = * Improved: Pricing page = 1.3.20 - 23 Nov, 2023 = * Fixed: $product is not defined = 1.3.19 - 11 Nov, 2023 = * SDK Updated = 1.3.17 - 12 Oct, 2023 = * Fixed Single product view on Divi theme = 1.3.16 - 5 Oct, 2023 = * model/popup on product page for 3D * Fix Poster issue = 1.3.15 - 24/08/2023 = * Fix OV is not defined = 1.3.14 - 17/08/2023 = * Fix Elementor Issue * Viewer 2 in classic shortCode Generator = 1.3.11 - 29/07/2023 = * Fix Percentage issue = 1.3.11 - 19/07/2023 = * Fix Percentage issue = 1.3.10 - 17/07/2023 = * Fix Settings page issue = 1.3.9 - 11/07/2023 = * Gutenberg Shortcode Generator * Woocommerce Custom Selector = 1.3.8 - 30/03/2023 = * Fixed: Full Screen button issue * Fixed: SSL issue on woocommerce = 1.3.3 - 04/09/2022 = * added apply_filters hook to add attribute on model = 1.3.1 = * Fixed full screen issue = 1.2.9 = * Fixed width issue = 1.2.7 = * SDK Updated = 1.2.6 = * Fix mirror issues = 1.2.5 = * Fix Product Metabox issues. * Fix Other mirror issues = 1.2.4 = * Fix mirror issues. = 1.2.3 = * Fix Product issues. = 1.2.2 = * Improve Performance. * Fix mirror issues. = 1.2.1 = * New Shortcode Generator * Fix mirror issues. = 1.2.0 = * Woocommerce Support * Multiple Source Option for Models * Dedicated Settings Panel. * Preset Settings = 1.1.1 = * Full Screen Feature Added * Custom Angle Supported For Specific Model * Script Improved * Fix other issues = 1.1.0 = * Added New Feature In Pro * Optimize Option Panel * Script Improved * Progress bar issues * Fix other issues = 1.0.10 = * Fix old Version shortcode Issues. * Script Improved * Fix mirror issues = 1.0.9 = * Multiple Shortcode Support in same page / post. * Script Updated * Responsiveness improved * Fix mirror issues = 1.0.8 = * Fix https issues. = 1.0.7 = * Auto Rotation speed and delay option added ( Pro Only ). * Fix mirror issues. = 1.0.6 = * New Exclusive Feature Included. * Fix mirror issues. = 1.0.5 = * New Exclusive Feature Included. * Fix mirror issues. * Updated script = 1.0.4 = * New Feature Include. * Fix mirror issue. * Updated script = 1.0.2 = * Fix mirror issue. * Updated script = 1.0.1 = * Fix json issue. = 1.0.0 = * Initial Release