=== Buildora – PC Builder for WooCommerce ===
Contributors: riponhossain
Author URI: https://profiles.wordpress.org/riponhossain/
Tags: woocommerce, pc builder, configurator, compatibility, components
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce PC builder with step-by-step component selection, compatibility checks, build saves, and cart integration.

== Description ==

**Buildora PC Builder for WooCommerce** is the complete PC building solution for WooCommerce stores that sell computer hardware. It guides your customers step-by-step through selecting compatible PC components, then adds the entire build to the WooCommerce cart in a single click.

Perfect for:
*   **Custom PC retailers** — sell workstations, gaming rigs, office builds, server configurations
*   **Hardware stores** — help customers match a CPU to a motherboard, RAM, GPU, PSU, and more
*   **System integrators** — showcase pre-configured build templates that customers can tweak
*   **eLearning / hobbyist stores** — guide new builders through the PC building process

### Core Features

*   🧩 **17 Component Types Included** — CPU, Motherboard, RAM, Storage, Graphics Card (GPU), Power Supply (PSU), Case, CPU Cooler, Monitor, Mouse, Keyboard, Case Fans, Headset, Wi‑Fi Adapter, Speakers, Antivirus Subscription, and UPS
*   ✅ **Compatibility Engine — Real-time Warnings** — Instant compatibility feedback with helpful warnings when incompatible parts are selected (CPU socket vs motherboard, RAM generation, PSU wattage vs draw, form-factor vs case, GPU length vs case clearance, and more) — shown after component selection
*   🛒 **WooCommerce Cart Integration** — One-click "Add to Cart" adds every selected component as a separate line item (or grouped) so the customer can checkout directly
*   💾 **Build Templates** — Create pre-configured build templates (Budget, Gaming, Workstation, Office, etc.) that customers can start from or load with one click
*   👤 **My Account Saved Builds** — Logged-in customers can save up to 5 builds and revisit them from the WooCommerce My Account area
*   🧭 **Setup Wizard** — Onboarding wizard auto-detects existing product categories and recommends mappings, plus optional demo-data import for instant testing
*   📊 **Admin Dashboard** — Dashboard with build overview, monthly charts, top-selling components, quick-action shortcuts, and system status checks
*   🗺️ **Component Category Mapping** — Smart keyword-based auto-detection maps WooCommerce product categories to component types (CPU, GPU, RAM, etc.)
*   📋 **Product Specs Meta — Core Specs** — Dedicated product-spec fields on each WooCommerce product (socket, RAM type, form-factor, RAM slots, PSU wattage, chipset, TDP, storage interface) used by the compatibility engine
*   🎨 **Customizable Builder Design** — 2-color accent and background customization that matches your store branding
*   🖨️ **Basic Print** — Print button for hardcopy of the current configuration
*   📤 **Copy to Clipboard** — One-click copy of build summary to share via email / chat
*   ⚙️ **Gutenberg Block + Elementor Widget + Shortcode** — Embed the builder anywhere:
    *   Gutenberg Block: `[PC Builder]`
    *   Shortcode: `[bpcb_pc_builder]`
    *   Elementor Widget: "PC Builder"


== Installation ==

= Minimum Requirements =

*   WordPress 6.0 or greater
*   WooCommerce 7.0 or greater
*   PHP 7.4 or later (PHP 8.0+ recommended)
*   MySQL 5.6 or greater OR MariaDB 10.1 or greater

= Automatic installation =

1.  Go to **Plugins → Add New** in your WordPress admin
2.  Search for **"Buildora PC Builder for WooCommerce"**
3.  Click **Install Now** and then **Activate**

= Manual installation =

1.  Download the plugin `.zip` file
2.  Go to **Plugins → Add New → Upload Plugin**
3.  Upload the `.zip` file and click **Install Now**
4.  Activate the plugin after installation

= After activation =

1.  You will be redirected to the **Setup Wizard** automatically
2.  Follow the wizard to:
    *   Map your existing WooCommerce categories to PC component types (or auto-create them)
    *   Optionally import demo products and specs for testing
    *   Create and configure the PC Builder page
3.  Open the **Builder Page** and start building!

= Quick start (no existing products) =

1.  Activate the plugin and run the Setup Wizard
2.  On the **Demo Data** step, click **Import Full Demo** — categories, 60+ demo products, specs, compatibility rules, and 3 pre-made build templates will be created
3.  Open the Builder — everything works out of the box

== Frequently Asked Questions ==

= Does it require WooCommerce? =

Yes. WooCommerce must be installed and active. The plugin was built for WooCommerce product catalogs and the cart/checkout flow.

= Will it work with my theme? =

PC Builder uses its own isolated React-based UI that's rendered via shortcode, Gutenberg block, or Elementor widget. It includes responsive styling and works with any properly-coded WooCommerce-compatible theme.

= Can I change which component types appear? =

Yes. Go to **PC Builder → Settings → Components** and toggle rows on/off, reorder them, or change their labels. The plugin includes all 17 standard PC components.

= Where are product specs stored? =

PC Builder adds its own dedicated spec meta fields to WooCommerce products. Edit any product and use the **PC Builder Specs** panel to fill in socket, TDP, chipset, form-factor, RAM slots, PSU wattage, etc. These specs power the compatibility engine.

= How many builds can a customer save? =

Logged-in customers can save up to **5 builds**.

= Can builds be shared with customers or on social media? =

Customers can copy a plain-text build summary to clipboard.

= Is HPOS (High-Performance Order Storage) supported? =

Yes. The plugin declares WooCommerce HPOS compatibility via the official `FeaturesUtil::declare_compatibility` method.

= Is the plugin translation-ready? =

Yes. The text domain is `buildora-pc-builder` and a `.pot` file is included in the `languages/` folder.

= Is personal data collected? =

No. PC Builder does not send any data to external servers. Saved builds are stored locally as WordPress user meta. See the **Privacy** section below.

== Screenshots ==

1.  **Builder UI (Classic Layout)** — Step-by-step component selection with live compatibility feedback and live pricing.
2.  **Admin Dashboard** — Monthly build overview chart, top components, quick actions, and system status.
3.  **Setup Wizard** — Category detection, mapping, and optional demo data import for instant testing.
4.  **Component Mapping** — Smart auto-detection matches WooCommerce categories to component types.
5.  **Product Specs** — Fill in CPU socket, TDP, chipset, form-factor and more to power compatibility checks.
6.  **Build Templates** — Pre-configured builds (Gaming, Workstation, Office) that customers load and customize.
7.  **My Account Saved Builds** — Customers revisit and edit their saved builds from the WooCommerce My Account area.

== Changelog ==

= 1.0.0 =
*   Initial public release on WordPress.org
*   React-based PC Builder UI with Classic layout
*   17 standard component types (CPU, Motherboard, RAM, Storage, GPU, PSU, Case, Cooler, Monitor, Mouse, Keyboard, Fans, Headset, Wi‑Fi, Speakers, Antivirus, UPS)
*   Real-time Compatibility Engine with warnings (shown after selection)
*   WooCommerce cart integration (complete builds only)
*   Setup Wizard with smart category detection + demo data import
*   Admin Dashboard with charts + quick actions
*   Saved Builds (5 per logged-in user) with My Account endpoint
*   Build Templates
*   Gutenberg Block + Elementor Widget + Shortcode
*   Core Product Specs meta on WooCommerce products
*   2-color builder design customization
*   Basic print + clipboard share
*   WooCommerce HPOS (High-Performance Order Storage) compatibility declared

== Privacy Notices ==

Buildora PC Builder for WooCommerce is designed with privacy in mind:

*   No data is sent to external servers. All core features (builder UI, compatibility engine, cart integration, saved builds) run entirely locally on your own WordPress/WooCommerce installation.
*   **Saved builds** are stored as WordPress user meta (`bpcb_builds`) and only for logged-in users that explicitly click **Save Build**.
*   **No cookies** are set by the plugin beyond the standard WordPress/WooCommerce login and session cookies.
*   **No tracking, telemetry, or usage data** is collected or transmitted.

When using the demo-data importer, demo products are created only when you explicitly click "Import" in the Setup Wizard or Tools page. Imported demo content can be bulk-deleted from **PC Builder → Tools → Remove Demo Data**.
