=== Ballin Simple ===
Contributors: ryan123zone, ballinkit
Donate link: https://ballinkit.com/
Tags: woocommerce, product customizer, custom jersey, name and number, add-on price
Requires at least: 5.8
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

Add custom Name and Number options with dynamic add-on pricing and live jersey previews to WooCommerce products.

== Description ==

**Ballin Simple** is an athletic kit customizer plugin for WooCommerce. It allows your customers to personalize jerseys, apparel, and merchandise with their custom Name and Number directly on the product detail page.

### Key Features

* **Custom Name & Number Add-ons:** Allow customers to type their custom name and jersey number with optional flat add-on fees.
* **Interactive Live Preview:** Real-time visual overlay on product images (front and back views).
* **Draggable Text Layers:** Customers can adjust and fine-tune the exact positioning of their name and number.
* **Multiple Athletic Fonts:** Support for popular sports and athletic typefaces (Teko, Bebas Neue, Outfit, Anton).
* **Seamless WooCommerce Flow:** Custom choices and dynamic add-on pricing flow directly through Cart, Checkout, Order emails, and Admin order management.
* **High-Performance Order Storage (HPOS) Ready:** Full compatibility with WooCommerce Custom Order Tables (HPOS).
* **Per-Product Overrides:** Configure default customization settings globally or override add-on pricing and preview images per product.

== Installation ==

1. Upload the `ballin-simple` folder to the `/wp-content/plugins/` directory, or install the ZIP file via **Plugins > Add New > Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **WooCommerce > Kit Customizer** to configure global personalization settings, default add-on pricing, and live preview options.
4. (Optional) Edit individual products to upload custom Front/Back view images or override pricing.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =
Yes, Ballin Simple requires WooCommerce 5.0 or higher to be installed and active.

= Is High-Performance Order Storage (HPOS) supported? =
Yes, Ballin Simple declares full compatibility with WooCommerce HPOS (Custom Order Tables).

= Where are the customer customization details saved? =
Custom Name, Number, chosen font style, and generated preview mockups are saved directly in the WooCommerce Order Line Item metadata, visible in both the customer's order confirmation and the store admin.

== Screenshots ==

1. Frontend product page with live jersey preview and name/number customization options.
2. WooCommerce admin settings page for configuring add-on pricing and features.
3. Product edit screen with Kit Customizer tab for uploading front and back view images.
4. WooCommerce order details page showing custom name, number, and generated mockup preview.

== Changelog ==

= 1.0.0 =
* Initial release.
* Added Name and Number customization fields with dynamic add-on pricing.
* Added interactive Front & Back live visual preview with draggable text positioning.
* Added support for athletic jersey font families.
* Full Cart, Checkout, and HPOS Order integration.
