=== Royal Checkout Field Manager for WooCommerce ===

Contributors: sonianant
Tags: woocommerce, checkout, custom fields, checkout fields, forms
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add custom checkout fields with visibility conditions and optional fees for WooCommerce. 100% GPL, no tracking, WordPress.org compliant.

== Description ==

Royal Checkout Field Manager for WooCommerce lets you add custom fields to the WooCommerce checkout page with full control over placement, validation, visibility conditions, and optional fees.

= Features =

* **Field types:** Text, Textarea, Number, Checkbox, Color, Datepicker, Weekpicker, Timepicker, Select (Select2), Multiselect (Select2), Radio, Password, Country, State, Email, Phone, Search, URL, Range
* **General options:** Label, placeholder, default value, description, required, save as customer meta
* **Position:** Section (billing, shipping, account, order) and priority
* **Input options:** Max length, min/max value, step, autofocus, autocomplete
* **Styling:** Wrapper, label, and input CSS classes
* **Visibility conditions:** Show fields based on product categories, product tags, products, user roles, min/max cart amount, shipping classes, virtual/downloadable products, countries
* **Fee system:** Optional fee when field has a value (fixed or percent), with taxable option
* **Display:** Custom fields appear in admin order view, order emails, and My Account order details
* **HPOS compatible:** Declared compatible with WooCommerce High-Performance Order Storage
* **AJAX checkout:** Works with WooCommerce AJAX checkout updates

= WordPress.org compliant =

* 100% GPL compatible
* No obfuscated code, tracking, or telemetry
* No remote API calls or external CDN scripts
* No promotional banners or premium upgrade notices
* Clean uninstall (removes options and customer meta; keeps order meta per best practice)
* PHPCS and WordPress coding standards compatible

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via Plugins > Add New.
2. Activate the plugin through the Plugins screen. WooCommerce must be installed and active.
3. Go to WooCommerce > Checkout Fields to add and configure custom fields.
4. Configure each field's type, label, section, priority, visibility conditions, and optional fee.

== Frequently Asked Questions ==

= Does this work with WooCommerce High-Performance Order Storage (HPOS)? =

Yes. The plugin declares full compatibility with WooCommerce custom order tables (HPOS).

= Are custom field values saved on the order? =

Yes. Values are saved as order meta and displayed in the admin order screen, in order emails, and in the My Account order view.

= Can I show a field only when certain products are in the cart? =

Yes. Use the visibility conditions to show fields based on product categories, product tags, specific products, cart amount, shipping classes, virtual/downloadable products, user roles, or countries.

= Can I charge a fee when a custom field is filled? =

Yes. Enable the fee option for a field and set the value (fixed amount or percent), title, and whether the fee is taxable.

== Screenshots ==

1. Admin: Custom Checkout Fields list and editor
2. Checkout: Custom fields on the checkout page
3. Order: Custom field values in admin order details

== Changelog ==

= 1.0.0 =
* Initial release
* Field types: Text, Textarea, Number, Checkbox, Color, Datepicker, Weekpicker, Timepicker, Select, Multiselect, Radio, Password, Country, State, Email, Phone, Search, URL, Range
* General options, position, input options, styling
* Visibility conditions: product categories, tags, products, user roles, cart amount, shipping classes, virtual/downloadable, countries
* Fee system: fixed/percent, title, taxable
* Order meta and customer meta save
* Display in admin order, emails, My Account
* HPOS compatibility
* AJAX checkout support

== Upgrade Notice ==

= 1.0.0 =
Initial release of Checkout Field Manager for WooCommerce.
