A WordPress plugin to embed interactive 3D models and 360° product views into posts, pages, widgets, and WooCommerce product pages — no code required. Supports GLB, GLTF, OBJ, STL, FBX, DAE, PLY, and 3DS files.

This is the developer README. For the user-facing plugin description, screenshots, and changelog, see readme.txt.

• Product page: https://bplugins.com/products/3d-viewer/
• Documentation: https://bplugins.com/docs/3d-viewer/
• WordPress.org: https://wordpress.org/plugins/3d-viewer/
• Support: https://bplugins.com/support/

• Embed 3D models via Gutenberg block, shortcode, or Elementor widget
• Two viewer engines — Lite (Google <model-viewer>) and Advanced (Online 3D Viewer)
• WooCommerce product integration with variant galleries
• Touch / pan / zoom / rotate controls and auto-rotation
• Reusable viewer presets
• Lazy loading for performance

1. Upload the plugin folder to /wp-content/plugins/.
2. Activate it through the Plugins menu in WordPress.
3. Go to 3D Viewer → Add New, upload a model, and copy the generated shortcode — or use the 3D Viewer Gutenberg block.

To embed in a theme template: <?php echo do_shortcode('YOUR_SHORTCODE'); ?>

git clone https://github.com/bPlugins/3d-viewer-wp.git 3d-viewer
cd 3d-viewer
composer install   # PHP dependencies (Freemius SDK)
npm install        # JS/TS dependencies
npm run build      # compile assets into build/

Install dependencies, then start the watch build:

npm start          # wp-scripts dev build with file watching

Issues and pull requests are welcome at https://github.com/bPlugins/3d-viewer-wp.

Before submitting a PR, run npm run check-types and npx playwright test.

GPLv2 or later — © bPlugins.