3D Product Customizer & Configurator for WooCommerce
| 开发者 |
deosebitsoft
freemius |
|---|---|
| 更新时间 | 2026年6月22日 18:23 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
DEMO
Let customers build their perfect product in 3D — swap materials, hide parts, and share their design. Powered by Three.js, built for WooCommerce.
Key features:
- Real-time 3D model viewer powered by Three.js (WebGL)
- PBR (Physically Based Rendering) material support — base color, roughness, normal, AO, metalness, and displacement maps
- Per-step customization: define multiple configuration steps (e.g. Upper, Sole, Logo), each targeting specific model meshes
- Bulk material assignment in the admin
- Geometry visibility toggles — show or hide mesh groups per option
- Undo / redo history
- URL-based configuration sharing — customers can share their exact design via a link
- Download a PDF preview
- AR view on supported mobile devices
- HDR environment map for realistic lighting
- Background color switcher
- Customization data saved to the WooCommerce order as line-item meta
- Reusable texture library via a dedicated Custom Post Type
- Upload & display a 3D model
- Base color texture or color picker per option
- Roughness & metalness sliders
- Customization steps
- Viewer Only Mode
- Camera, zoom & background settings
- HDR environment map
- Undo / redo, PDF, AR view
- Set custom icons (images) for every step / options of a step
- Material Preview
- Multiple textures per option
- Bulk Add Materials to a step
- Show / Hide mesh controls per option
- Normal, AO, metalness & displacement maps
- Reflection intensity & displacement scale
- Hotspots/Annotations
安装:
- Upload the
product-customizerfolder to/wp-content/plugins/. - Activate the plugin through the Plugins menu in WordPress.
- Ensure WooCommerce is installed and active.
- Navigate to Model Textures in the WordPress admin and create texture entries. Each texture can include a base-color image (featured image) plus optional PBR maps and scalar material properties.
- Open any WooCommerce product and locate the 3D Configurator metabox.
- Upload or select a
.glb/.gltfmodel using the Select Model button. - Click Scan Model to auto-detect mesh names from the file.
- Add one or more Steps and assign Options (textures or geometry toggles) to each step.
- Save the product. The 3D configurator will now appear on the product's front-end page.
- Visit Model Textures → Global Settings to configure camera position, zoom limits, background colors, and an optional HDR environment map.
屏幕截图:
常见问题:
What 3D file formats are supported?
GLB (binary GLTF) is the recommended format. GLTF (JSON-based) is also supported. The plugin registers these MIME types with WordPress so they can be uploaded through the standard Media Library.
Can I use multiple HDR environment maps per product?
The HDR environment map is a global setting. All products share the same HDR file. Per-product HDR support is planned for a future release.
Why does the 3D viewer not appear on a product page?
The configurator only renders when the product has a valid .glb model URL AND at least one configured step with at least one option. Check the 3D Configurator metabox on the product.
How is the customization saved to the order?
When a customer clicks Add to cart, the current configuration is sent as a JSON payload. Each selected option (part → material name) is stored as a WooCommerce line-item meta entry and is visible on the order detail and in emails.
Is this compatible with WooCommerce variable products?
The plugin targets simple products. Variable product support is not officially tested.
Are the bundled JavaScript files minified?
Yes. The source files are included in the js/ directory and the webpack.config.js build configuration is included in the plugin package.
更新日志:
3.6.6
Code quality
3.6.5
- Updated presentation site url in the codebase
- Added guard to manual placement setting
- Fixed support notice not staying dismissed
- Fixed
customizerDataalready declared error on product pages when shortcode or FSE block is used - Manual hook
dprcu_display_customizernow accepts an optional product ID argument
- Added product ID attribute to shortcode — use
[dprcu-customizer id="123"]on any page - Added product search/select to the FSE block — pick any WooCommerce product from the sidebar
- Fixed FSE block not being clickable in the editor (added
useBlockProps)
- Fixed dismisable support notice
- Fixed encoding of special chars
- Added docs / support notice to admin
- Replaced Lucide icon picker with WordPress media library for step and option icon selection
- Added per-option icon image field — each option can have its own icon shown in geometry swatches
- Option icon now takes priority over texture thumbnail/color in material swatches when set
- Cached icon images in IndexedDB to avoid re-fetching on every session load
- Fixed Bulk Add Options not working — added missing bulk modal HTML and #tmpl-option template
- UI refactor
- Fixed zoom keyboard shortcuts (+/-) ignoring admin-set zoom limits (minDistance/maxDistance)
- Fixed option selection forcing targeted meshes visible when no show/hide configured
- Added Demo, Docs, and Buy Premium links to the plugin row on the Plugins page
- Regenerated pot file
- Fixed position of the additional price input in the ajax response
- Added per-option additional pricing — set a surcharge on any option within a step
- Live price display updates in real-time as the user selects different options
- Price badges shown on option swatches when a surcharge applies
- Option surcharge applied to cart total via WooCommerce before_calculate_totals
- Uses WooCommerce currency symbol and position settings
- Bug fixes and maintenance
- Renamed plugin to "3D Product Customizer & Configurator for WooCommerce" for better search visibility
- Updated plugin name references in watermarks, notices, and readme.txt
- Regenerated pot file
- Updated docs URL in the PDF
- Added 12 new i18n strings (adding, loading, PDF labels, alerts) — now translatable via
__()in PHP - Disabled OrbitControls damping for instant rotation stop on release
- Removed stale CSS selectors from metabox-styles.css
- Fixed deprecated
THREE.WebGLShadowMapwarning — switched toPCFShadowMap - Increased shadow map resolution to 4096 and tightened shadow camera frustum for sharper ground shadows
- Added camera position/angle controls in admin 3D editor — save and reset the default camera view per product
- Fixed JSON corruption when saving camera position (
sanitize_text_fieldno longer destroys JSON data) - Front-end 3D viewer now applies the saved per-product camera position on load
- Fixed garbled character encoding in the help modal close button
- Fixed help modal rendering on mobile Safari — GPU compositing, dynamic viewport height, touch event handling
- Removed nested
position: fixedon mobile modal to prevent layout issues
- Fixed all
_e()output to use proper escaping functions (esc_html_e,esc_attr_e) - Added ABSPATH guard to block render file
- Removed UTF-8 BOM from main plugin file
- Added nonce verification to review notice dismissal
- Added nonce compliance annotations to add-to-cart handler
- Fixed undefined variable warnings in PDF download and background toggle
- Normalized IndexedDB config key across URL variants
- Improved add-to-cart AJAX — applies WooCommerce fragments directly and fires proper events
- Use WooCommerce
wc_ajax_urlfor add-to-cart requests (handles subdirectory installs) - Replaced
filemtime()fallback withfile_exists()check to suppress PHP warnings - Fixed extra
>in checkbox HTML markup
- Switched PDF generation from pdf-lib to jsPDF for better clickable link support
- Renamed URL query parameter
cfgtodprcu_cfgto avoid conflicts - Cleaned
dprcu_cfgparameter from the URL after configuration load - Added multi-angle PDF captures with options summary page
- Added site logo, product name, timestamp, and URL to PDF output
- Added footer links (Plugin Page, Docs, Demo) to PDF pages
- Added option thumbnails and color swatches to the PDF options table
- Updated PDF column layout to full-width images proportional to canvas aspect ratio
- Fixed taxonomy slug in texture category filter dropdowns — categories now show up correctly in modals
- Fixed valid zero values (roughness 0.0, metalness 0.0, env intensity 0.0) being silently ignored on the frontend
- Fixed HTML validation: nonce field moved outside
<select>element in admin texture filter - Fixed duplicate
get_post_meta()call in texture color swatch metabox - Eliminated duplicate watermark rendering logic with a shared helper
- Added fallback version string for
filemtime()to prevent PHP warnings when assets are missing - Updated texture caching to correctly query the
dprcu_texture_categorytaxonomy
- Added three display methods (Automatic, Shortcode, Manual Hook) for flexible customizer placement
- Implemented 18+ WordPress action hooks for developer extensibility
- Fixed wpautop filter interfering with shortcode output
- Added Global Settings page with display method selection
- Fixed premium notice css
- Added auto framing to the customizer
- Updated admin model scanner layout
- Introduced Material preview metabox for Premium
- Introduced color picker for materials with only basic colors
- Introduced Free vs Premium tier via Freemius licensing.
- Premium: multiple textures per option (free tier limited to one per option).
- Premium: Bulk Add Materials button in the product metabox.
- Premium: Show/Hide mesh controls per customization option.
- Premium: full PBR map set — normal, AO, metalness, and displacement map uploads.
- Premium: reflection intensity and displacement scale sliders on texture entries.
- Added custom isometric cube icon in the WordPress admin sidebar.
- Added persistent upgrade prompts comparing free and premium features.
- Freemius account menu integrated into the 3D Customizer admin menu.
- Added glass/transmission material support.
- Added bulk material assignment in the product metabox.
- Added drag-to-reorder for steps and options.
- Added geometry visibility (show/hide meshes) per option.
- Improved undo/redo history system.
- Performance: texture list now cached with a transient.
- Security: fixed text domain inconsistency across all files.
- Security: attachment IDs now sanitized with absint() instead of sanitize_text_field().
- Security: ABSPATH guard moved to top of plugin-settings.php.
- Security: all HTML attribute echoes in settings render callbacks now escaped with esc_attr().
- Multi-texture options: assign multiple textures to a single option card.
- New step/option data structure with explicit target meshes.
- Added HDR environment map setting.
- Added URL-based configuration sharing.
- Added AR export with QR code.
- Initial release.