=== Baba 3D Gallery for WooCommerce ===
Contributors: atababa
Tags: woocommerce, 3d, gallery, showroom, webgl
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 2.1.0
Requires PHP: 7.4
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Transforms your WooCommerce store into an immersive, interactive 3D virtual showroom powered by WebGL.

== Description ==

Transform your standard WooCommerce store into an engaging, interactive 3D virtual showroom powered by WebGL and Three.js — without requiring 3D models or complex rendering pipelines!

WooBaba automatically builds double-sided exhibition kiosks directly from your existing 2D product images, categories, and inventory data. Give your shoppers a memorable spatial walkthrough on desktop, tablet, and mobile devices.

= Key Features =
* **Instant 2D-to-3D Architecture:** Converts standard product images and attributes into realistic display kiosks with zero 3D modeling overhead.
* **Interactive 3D Walkthrough:** Ultra-smooth 60FPS navigation with natural camera motion for desktop trackpads/mice and mobile touch controls.
* **Magnetic Double-Click Snapping:** Double-click or double-tap any product poster to smoothly slide and align the camera right in front of the kiosk.
* **Integrated Product Details & Variations:** Interactive popups showcasing product descriptions, variable attributes (sizes, colors), and image gallery previews directly inside the 3D space.
* **WooCommerce Cart Sync:** Direct integration with WooCommerce Store API for live item counts, real-time totals, and instant add-to-cart operations.
* **Built-in Category Drawer & Search:** Visitors can search by keywords or filter by product categories on the fly without reloading the scene.
* **Environment Appearance Customization:** Fine-tune solid color tints over realistic plaster walls, parquet wood floors, ceilings, and baseboard moldings.
* **Configurable Frontend Trigger:** Optional floating action button with custom label and position control (bottom-right / bottom-left) to let shoppers easily enter the showroom.
* **Zero Overhead on Normal Pages:** The WebGL engine only loads on your designated 3D gallery URL route, keeping normal shop and checkout pages lightweight and SEO-friendly.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/baba-3d-gallery` directory, or install it via the WordPress Plugins menu.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Ensure WooCommerce is installed and active.
4. Navigate to **WooBaba** in your WordPress admin menu to configure your custom showroom slug, floating button, and environment colors.
5. Visit your configured 3D gallery URL (e.g., `yoursite.com/3d-gallery/`) to explore the showroom.

== Frequently Asked Questions ==

= Do I need 3D models (.GLB or .OBJ) for every product? =
No. WooBaba automatically generates interactive 3D kiosks using your existing standard 2D WooCommerce product images and attributes.

= Does this support variable products (size, color, etc.)? =
Yes. Shoppers can view and select product variations directly from the interactive kiosk popup inside the 3D space.

= Will this slow down my standard WooCommerce pages? =
No. The Three.js WebGL rendering pipeline is completely isolated to your custom 3D gallery route. Standard shop, single product, cart, and checkout pages remain untouched.

= Can I hide or customize the floating entrance button? =
Yes. You can toggle the floating button on or off, edit its label, and choose between bottom-right or bottom-left placement directly in the WooBaba admin settings.

== Screenshots ==

1. Interactive 3D showroom walkthrough with dual-sided product stands.
2. Product detail kiosk with variation options and cart integration.
3. Category browser and live product search overlay.
4. WordPress admin settings panel for 3D environment appearance and floating trigger.

== Changelog ==

= 2.1.0 =
* Initial public release on WordPress.org.
* Interactive 3D gallery showroom powered by Three.js and WebGL.
* Magnetic double-click camera snapping for smooth kiosk framing.
* Integrated product detail panel with variation attribute support.
* Direct WooCommerce cart synchronization with real-time total updates.
* Multi-level category drawer and instant keyword search.
* Color tint customization for walls, floors, ceilings, and baseboard moldings.
* Configurable frontend floating trigger with position and label settings.
* Seamless full-page canvas routing preserving standard WordPress template hierarchy.
