=== pineX Commerce Suite ===
Contributors: amzydaniel
Donate link: https://pinex.co.uk/product/wp/plugins/pinex-commerce-suite/
Tags: woocommerce, slide cart, variation swatches, free shipping bar, product options
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 8.3
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce conversion suite with an AJAX slide-out cart drawer, dynamic free-shipping progress bar, variation swatches, and custom text fields.

== Description ==

**pineX Commerce Suite** replaces four separate storefront plugins with one fast, zero-bloat WooCommerce conversion toolkit. Engineered natively for **WooCommerce High-Performance Order Storage (HPOS)** and **PHP 8.3+**, it creates **zero custom database tables** and makes **zero third-party API requests**, keeping your store fast, clean, and easy to maintain.

*Trademark Notice: pineX Commerce Suite is an independent software product developed by pineX digital and is not affiliated with, endorsed by, or sponsored by WooCommerce or Automattic Inc.*

= Core Features (100% Free & Unlocked) =

* **AJAX Slide-Out Cart Drawer:** Instant glassmorphic fly-out cart drawer with live `+` / `-` quantity steppers, one-click item removal, real-time WooCommerce fragment synchronization, automatic drawer opening on add-to-cart, floating cart dock, and `[pinex_wcs_cart_trigger]` shortcode / Gutenberg block.
* **Dynamic Free-Shipping Progress Bar:** Live visual progress bar inside the slide-out cart drawer that automatically calculates how much more a shopper needs to add to unlock free shipping.
* **Visual Color & Size Variation Swatches:** Automatically transforms standard WooCommerce variation dropdowns into interactive color circles and size pill buttons—supporting custom color hex mappings and full WooCommerce variation reset compatibility.
* **Custom Product Text & Engraving Fields:** Add per-product personalization, engraving, or gift-note input boxes directly on WooCommerce single product pages with optional required validation, cart summary display, and WooCommerce HPOS order item metadata persistence.
* **Modular Switchboard:** Enable or disable any of the four modules independently with smart dependency handling and instant visual customization.

= Optional Pro Companion Extension =

Looking for in-cart and post-purchase 1-click order bumps, tiered cart milestone rewards (free gifts & auto-discounts), customer artwork file uploads, store credit wallet cashback, B2B quantity-break pricing tables, and customer-controlled recurring reorders? Learn more about the separate **pineX Commerce Suite Pro** companion plugin at [pinex.co.uk](https://pinex.co.uk/product/wp/plugins/pinex-commerce-suite/).

= Configuration & Quick Start =

1. Navigate to **pineX Suite -> Command Center** in your WordPress admin sidebar.
2. Toggle any module on or off in the **Modular Switchboard**.
3. Set your **Free Shipping Goal**, customize the progress bar messages, accent colors, and swatch shape, and click **Save Configuration**.
4. To enable custom text or engraving fields on a product, edit any WooCommerce product and open **Product Data -> General** to enable **Custom Text Field**.

== Installation ==

1. Ensure **WooCommerce 9.0 or newer** is installed and active on a server running **PHP 8.3 or newer** and **WordPress 6.9 or newer**.
2. Upload the `pinex-commerce-suite` folder to `/wp-content/plugins/pinex-commerce-suite/`, or install `pinex-commerce-suite.zip` via **Plugins -> Add New -> Upload Plugin** in WordPress.
3. Activate **pineX Commerce Suite** through the **Plugins** menu in WordPress.
4. Configure your cart drawer, shipping goal, and swatches under **pineX Suite -> Command Center**.

== Frequently Asked Questions ==

= Does pineX Commerce Suite create any custom database tables? =

No. pineX Commerce Suite uses native WordPress options and WooCommerce HPOS order/product metadata exclusively, leaving your database schema 100% clean.

= Does pineX Commerce Suite work with WooCommerce High-Performance Order Storage (HPOS)? =

Yes. pineX Commerce Suite explicitly declares full compatibility with WooCommerce `custom_order_tables` (HPOS) and `cart_checkout_blocks`.

= Does this plugin connect to any external servers or load third-party CDNs? =

No. Every stylesheet and script is 100% self-contained inside the plugin package and enqueued via native WordPress `wp_enqueue_style()` and `wp_enqueue_script()` functions.

= How do I embed the slide-out cart button in my header or navigation? =

Use the `[pinex_wcs_cart_trigger]` shortcode or insert the **pineX Cart Trigger** block inside any block theme header or widget area.

== Screenshots ==

1. Executive Command Center with Modular Switchboard and live Cart & Swatch customizer.
2. Storefront Glassmorphic Slide-Out Cart Drawer with live Free-Shipping Progress Bar and AJAX quantity controls.
3. Visual Color Circle & Size Pill Variation Swatches with Custom Product Personalization Field.

== Changelog ==

= 1.0.1 =
* Added WordPress.org plugin directory assets (`icon-128x128.png`, `icon-256x256.png`, and `screenshot-1.png`).
* Synchronized plugin version metadata across all core, module, UI, and localization files.

= 1.0.0 =
* Initial public release for WordPress 6.9-7.1, WooCommerce 9.0-11.3 (HPOS & Cart/Checkout Blocks), and PHP 8.3-8.5.
* Added AJAX Slide-Out Cart Drawer with live quantity steppers, instant item removal, automatic drawer open on add-to-cart, floating dock, and [pinex_wcs_cart_trigger] shortcode/block.
* Added Dynamic Free-Shipping Progress Bar with customizable threshold and progress/unlocked messages.
* Added Visual Color & Size Variation Swatches with custom color hex mappings.
* Added per-product Custom Text / Engraving Fields persisted to WooCommerce HPOS order line items.
* Added Modular Switchboard with dependency protection and zero custom database tables.

== Upgrade Notice ==

= 1.0.1 =
Adds WordPress.org directory icons and storefront screenshot metadata. No database or settings changes required.

= 1.0.0 =
Initial stable release of pineX Commerce Suite.