=== BeautyForms Form Builder ===
Contributors: beautifulplugins
Tags: forms, form builder, block editor, gutenberg, contact form
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build forms directly in the block editor from native field blocks and collect submissions as a custom post type.

== Description ==

**BeautyForms Form Builder** is a lightweight, block-native form builder for the WordPress block editor. A form is just a block: drop in a **Form** block, nest the field blocks you need, and publish. Submissions are validated on the server and stored as entries.

Because every field is a real block, forms live inside normal posts and pages — no shortcodes, no embeds, no separate builder screen. Reuse a form anywhere with core synced patterns.

= Fields =
- Text, Email, Textarea, Number, Phone, URL
- Select, Radio, Checkbox (single consent and multiple)
- Date, Hidden, Submit

= Features =
- **Native styling** — fields use the block editor's own spacing, typography, color, and border controls. Nothing hand-rolled to relearn.
- **Server-side validation** — the server rebuilds the form's field schema from the source post and validates every submission against it. The browser's field list is never trusted.
- **Spam protection** — a honeypot field and a submission time-trap, both on by default.
- **Email notifications** — send submissions to one or more recipients with a configurable subject and from address.
- **Entry storage** — submissions are saved as a `beautyforms_entry` custom post type with one meta value per field.
- **Success behavior** — show a message or redirect to a URL.
- **Developer friendly** — extend the field allowlist through the `beautyforms_field_blocks` filter and hook `beautyforms_submission_saved` to react to new entries.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/beautyforms-form-builder`, or install through the WordPress plugins screen.
2. Activate the plugin from the Plugins screen.
3. Edit any post or page, add the **Form** block, and insert the field blocks you need.
4. Configure recipients and success behavior in the Form block settings, then publish.

== Frequently Asked Questions ==

= Where are submissions stored? =
Each submission is stored as a `beautyforms_entry` custom post type with one meta value per field. Notification emails are sent to the recipients you configure.

= Does it work with the classic editor? =
No. BeautyForms Form Builder is built exclusively for the WordPress block editor.

= How do I reuse a form across pages? =
A form is a normal block, so use a core synced pattern to reuse it anywhere.

= Can developers add their own field types? =
Yes. Register a block in the `beautyforms` category and append it to the allowlist with the `beautyforms_field_blocks` filter.

== Changelog ==

= 1.0.0 =
* Initial release.

== License ==

BeautyForms Form Builder is distributed under the terms of the GNU General Public License v2 or later. See https://www.gnu.org/licenses/gpl-2.0.html for more details.
