=== Fieldnest - Custom Checkout Fields for WooCommerce (Store API) ===
Contributors: duafatima
Tags: custom checkout fields, checkout fields, block checkout, checkout field editor, woocommerce checkout
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add custom fields to the WooCommerce block checkout - no code. Text, dropdowns & checkboxes that save to the order via the native Store API.

== Description ==

**Fieldnest** is a no-code editor for adding **custom checkout fields** to the modern **WooCommerce block checkout**. Add text inputs, dropdowns and checkboxes, choose where they appear, mark them required - and they save to the order automatically. No coding, no snippets, and no reverting to the old shortcode checkout.

= Built for the block checkout, not the classic one =

WooCommerce's newer **checkout block** (the React-based, Store API checkout) is replacing the classic `[woocommerce_checkout]` shortcode. Most "checkout field" plugins were written for that old PHP checkout, so on a block checkout their fields silently break - or never appear at all.

Fieldnest is **block-first**. It is built on WooCommerce's official **Additional Checkout Fields API**, part of the **Store API**, so every field you add:

* Renders correctly in the block checkout
* Saves to the order and the customer profile as proper order metadata
* Is available through the Store API and REST
* Keeps working across WooCommerce updates - because it uses the supported, native API instead of fragile workarounds

If you have moved (or are moving) to the block checkout and your old checkout-field plugin stopped showing fields, Fieldnest is built to fix exactly that.

= Features =

* **No-code editor** - add and manage fields from one simple screen under WooCommerce
* **Text**, **dropdown (select)** and **checkbox** field types
* Place fields in the **Contact**, **Address** or **Order** section of the checkout
* Mark any field **required** or optional
* **Reorder** fields with drag handles, and remove a field in one click
* Field values **save to the order** and are exposed through the **Store API**
* **HPOS compatible** (High-Performance Order Storage)
* No shortcode revert, no admin nag banners, **no external services and no tracking**

= Example uses =

Collect the information the default checkout leaves out, for example:

* A **delivery date** or preferred delivery time
* **Delivery instructions** ("leave at the back door")
* A **gift message** or gift-wrap choice
* A **VAT / tax number** or company name for invoices
* A **purchase order (PO) number** for B2B orders
* An "**I agree**" or age-confirmation checkbox
* How the customer **heard about you**

= Privacy friendly =

Fieldnest does its work entirely on your own site. It does not call home, does not load external scripts, and does not collect or send any data about you or your customers.

= Fieldnest Pro =

Need more power? **Fieldnest Pro** builds on the free plugin with:

* **Conditional logic** - show a field only when another field has a certain value
* **Validation rules** - regex pattern, minimum/maximum length and custom error messages
* **More field types** - **date picker**, **radio buttons**, **multi-select** and **file upload**
* **Order admin & email display** - show submitted field values on the order screen and in order emails

Fieldnest Pro is a separate plugin. Learn more and upgrade at [Fieldnest Pro](https://checkout.freemius.com/product/32415/). Your existing free fields carry over automatically - no re-entry needed.

== Installation ==

1. In your WordPress admin, go to **Plugins -> Add New** and search for "Fieldnest", or upload the plugin ZIP to `/wp-content/plugins/`.
2. Activate **Fieldnest** through the **Plugins** screen.
3. Go to **WooCommerce -> Checkout Fields**.
4. Click **+ Add field**, set a label, type and location, mark it required if needed, then **Save**.
5. Open your store's checkout to see the field live on the block checkout.

Fieldnest requires WooCommerce 8.9 or newer (the version that introduced the Additional Checkout Fields API).

== Frequently Asked Questions ==

= Does this work with the WooCommerce block checkout? =

Yes - that is the whole point. Fieldnest uses WooCommerce's native Additional Checkout Fields API (part of the Store API), so fields render in the block checkout without reverting to the classic shortcode.

= Will it work with the classic (shortcode) checkout? =

Fieldnest is designed for the block checkout. The Additional Checkout Fields API it relies on is provided for the block-based checkout, so the block checkout is what we support and recommend.

= Do my custom fields save to the order? =

Yes. Each field value is stored as standard order (and where relevant, customer) metadata, and is available through the Store API. You can see the values on the order.

= Which field types are supported? =

The free version supports text, dropdown (select) and checkbox fields. Fieldnest Pro adds date, radio, multi-select and file-upload fields.

= Where can I place fields on the checkout? =

In the Contact, Address or Order section of the block checkout - you choose per field.

= Is it compatible with High-Performance Order Storage (HPOS)? =

Yes. Fieldnest declares compatibility with HPOS and with the cart and checkout blocks.

= Does it slow down the checkout? =

No. Fieldnest registers fields through WooCommerce's own API and adds no external requests, so there is no measurable overhead.

= Does Fieldnest send any data to third parties? =

No. There is no tracking, no external API calls and no nag banners. Everything runs on your site.

= How is this different from other checkout field plugins? =

Many checkout-field plugins were built for the classic PHP checkout and only partly support (or completely miss) the block checkout. Fieldnest is built block-first on the native API, so fields actually appear, save correctly and keep working after updates.

= Can I show a field only when another field is selected? =

That is conditional logic, available in Fieldnest Pro, along with validation rules and extra field types.

== Screenshots ==

1. The no-code field editor under WooCommerce -> Checkout Fields.
2. Custom fields rendered natively in the block checkout.

== Changelog ==

= 0.1.2 =
* Expanded and clarified the plugin description and FAQ (block checkout / Store API support, example uses, privacy).
* No functional changes to the plugin.

= 0.1.1 =
* Added a link to the Fieldnest Pro version (conditional logic, validation and more field types).

= 0.1.0 =
* Initial release: add text, select and checkbox fields to the block checkout, with location and required controls, reordering and delete.

== Upgrade Notice ==

= 0.1.2 =
Documentation update only - clearer description and FAQ. No functional changes.
