=== 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.