=== Immersive Designer – 3D Product Configurator for WooCommerce === Contributors: bluegamediversion Donate link: https://www.buymeacoffee.com/azouamauriac Tags: woocommerce, 3d, product customizer, customizer, configurator Requires at least: 5.9 Tested up to: 7.0 Requires PHP: 7.4 WC requires at least: 5.0.0 WC tested up to: 10.8 Stable tag: 1.1.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Let customers configure your WooCommerce products in interactive 3D — change colors, materials and textures live before adding to cart. == Description == **Immersive Designer** turns any WooCommerce product into an interactive 3D experience. Upload a 3D model, define color, material and texture options for each part, and your customers configure the product in real time directly on your shop — no external service, no subscription fee. = Quick Start = Before you begin: make sure **WooCommerce** is installed and active. Immersive Designer won't work without it. **Step 1 — Install Immersive Designer** In your WordPress dashboard go to *Plugins → Add New*, search for "Immersive Designer", click *Install Now*, then *Activate*. A new "Immersive Designer" menu item appears in the left sidebar. **Step 2 — Get a 3D model** You need a 3D file in GLB, GLTF or OBJ format. If you don't have one yet, download a free GLB from [Sketchfab](https://sketchfab.com) (filter by "Free" license), or export one from Blender via *File → Export → glTF 2.0 (.glb/.gltf)*. GLB is recommended — it's a single file and loads fastest. **Step 3 — Create a configuration** Go to *Immersive Designer → Add New*. Give it an internal name (e.g. "Red Chair configurator") — customers never see this. In the *3D File Importer* panel, choose your format, then click *Upload* and pick your file. The viewer renders your model and lists every mesh it detected (a mesh is a named part of the model, e.g. "Seat", "Frame", "Legs"). **Step 4 — Add customer options** Click **+ Add Option Group**. Choose a mesh from the dropdown, then give it a label your customers will read (e.g. *Seat Color*). Click **+ Add Option** for each choice: * *Color* — pick a hex value from the color picker * *Texture* — upload an image (fabric, wood, leather…) * *Material* — enter a material name from your 3D file Optionally set an **Extra Price** on any option (e.g. +5.00 for a premium finish). The extra cost updates live in the configurator. **Step 5 — Link to a product** Open the *Linked Products* panel on the right. Search for a WooCommerce product and click *Link*. One configuration can be attached to several products. **Step 6 — Publish and test** Click *Publish*. Open the product page in your shop — you'll see a **Configure** button. Click it, pick options, add to cart, and confirm the chosen configuration appears in the cart summary and in the WooCommerce order detail. = Why Immersive Designer? = Most 3D configurator plugins lock their best features behind expensive plans. Immersive Designer ships the complete configurator — 3D viewer, per-part customization, cart integration, and multi-language support — for free. = Core features = * **Real-time 3D preview** — customers see every change instantly in the embedded viewer * **Per-part customization** — assign Color, Material or Texture options to individual meshes * **Extra price per option** — charge more for premium materials or finishes; shown live to the customer * **Cart & order integration** — the full configuration travels with the cart item and appears in the WooCommerce order detail * **Camera controls** — orbit, zoom and four preset angles (Front / Back / Left / Right) * **Mobile responsive** — viewer and option panel reflow on any screen size * **Loading state & error handling** — spinner during model load, clear error message on failure * **6 languages included** — English, French, Spanish, Portuguese (Brazil), German, Italian, Japanese = Supported 3D formats = * GLB (binary GLTF) — recommended; most compact, native export from Blender, Sketchfab and Spline * GLTF (JSON) — fully supported * OBJ + MTL — supported for legacy asset libraries = Requirements = * WordPress 5.9+ * WooCommerce 5.0+ * PHP 7.4+ = Presentation video = [youtube https://youtu.be/VU8l4goka9I] == Installation == 1. Upload the `immersive-designer` folder to `/wp-content/plugins/` 2. Activate the plugin through the **Plugins** menu in WordPress 3. Make sure WooCommerce is installed and active 4. Go to **Immersive Designer → Add New** to create your first 3D configuration == Frequently Asked Questions == = Which 3D formats are supported? = GLB and GLTF (recommended) and OBJ + MTL. FBX is not supported — export to GLB from your 3D editor first (Blender, Cinema 4D, Maya all support GLB export). = Where do I export my GLB model from? = Any modern 3D editor works: Blender (File → Export → glTF 2.0), Sketchfab (download as GLB), Spline (Export → GLB). = Can I charge a different price for each option? = Yes. Each option has an **Extra Price** field. The added cost is shown to the customer in real time and included in the cart item price. = Does the configurator work on mobile? = Yes. The 3D viewer and the option panel are fully responsive. = Can I link one configuration to multiple products? = Yes. From the **Linked Products** meta box inside the configuration, you can attach it to as many WooCommerce products as you need. = Is the customer's configuration saved in the order? = Yes. The full configuration (part name, option name, option type and value) is stored as order item meta and visible in the WooCommerce order detail. == Screenshots == 1. 3D viewer on the product page — customer choosing a material in real time 2. Admin configuration — uploading a GLB model and defining option groups 3. Per-option settings — color picker, texture upload and extra price 4. Linked Products meta box — attaching a configuration to WooCommerce products 5. WooCommerce cart showing the selected configuration details == Changelog == = 1.0.0 = * Initial release. == Upgrade Notice == = 1.0.0 = Initial release — no upgrade steps required. == Feedback == Found a bug or have a feature request? [Open a support thread](https://wordpress.org/support/plugin/immersive-designer/) or [contact us directly](mailto:bluegamediversion@gmail.com).