=== Pluximo Form Blocks - Contact Form Builder for Gutenberg ===
Contributors:      pluximo
Tags:              contact-form, form-builder, gutenberg, form, validation
Tested up to:      7.0
Stable tag:        1.3.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 6.7
Requires PHP:      7.4

Contact form builder for the block editor - drag-and-drop Gutenberg forms with validation, spam protection, and entries dashboard.

== Description ==

Pluximo Form Blocks is a Gutenberg contact form builder for WordPress. Build contact forms, inquiry forms, quote forms, feedback forms, newsletter forms, and simple application forms directly inside the block editor.

No separate form builder screen. No shortcode-only workflow. Add a Form Wrapper block, drop in the fields you need, publish the page, and start collecting submissions in your WordPress dashboard.

[youtube https://youtu.be/Rh89V2ejKvo]

= Build Contact Forms In Gutenberg =

Pluximo Form Blocks works like the editor you already use. Insert a form block, add fields as inner blocks, customize labels and validation, and preview the form in context with the rest of your content.

= Key Features =

* Contact form builder made for the WordPress block editor
* Drag-and-drop form building with native Gutenberg blocks
* Text input, email, URL, telephone, textarea, checkbox, radio, and select fields
* Required fields, length rules, field IDs, and custom validation messages
* Server-side validation so submissions are checked after the form is submitted
* Cloudflare Turnstile spam protection support
* IP-based submission throttling
* Form entries dashboard inside WordPress admin
* Optional email notifications for new submissions
* Custom success and error messages
* Responsive frontend form styling
* Translation-ready strings

= Good For =

* Contact forms
* Lead capture forms
* Quote request forms
* Service inquiry forms
* Feedback forms
* Newsletter signup forms
* Event registration forms
* Volunteer and job application forms

= Why Use A Gutenberg Form Builder? =

Traditional contact form plugins often make you build forms in a separate admin screen and paste shortcodes into pages later. Pluximo Form Blocks keeps form building in the page editor, where your content, layout, and form fields belong together.

You can build a form visually, save it with the page, and manage submissions from the WordPress dashboard.

= Spam Protection And Validation =

Pluximo Form Blocks validates submissions on the server, not only in the browser. It also supports Cloudflare Turnstile and throttles repeat submissions by client IP to help reduce spam.

= Entries Dashboard =

Every submitted form can be stored as a Form Entry in WordPress admin. Review submitted field data, form ID, IP address, user agent, and referer without leaving your site.

= Email Notifications =

Send new submission notifications to your chosen recipient. You can enable or disable notifications and customize the email subject from the plugin settings.

= Pluximo Form Blocks vs Contact Form 7 / WPForms =

Looking for a Contact Form 7 alternative or a lighter WPForms alternative? Here is where Pluximo Form Blocks fits.

* **Pluximo Form Blocks:** Best for native block-editor contact forms, Gutenberg form building, simple validation, spam protection, and built-in entries.
* **Contact Form 7:** Best for classic shortcode workflows and long-time Contact Form 7 users who prefer editing form markup separately.
* **WPForms:** Best for larger standalone form-builder suites where a separate builder interface is preferred.

Compared with Contact Form 7, Pluximo Form Blocks is block-first instead of shortcode-first. Compared with WPForms, Pluximo Form Blocks is more focused on lightweight Gutenberg contact forms rather than a broad form-builder suite.

Choose Pluximo Form Blocks if you want a contact form builder that feels native to Gutenberg and keeps form setup simple.

= Not Designed For =

Pluximo Form Blocks is focused on simple, reliable forms. It is not currently a payment form plugin, checkout replacement, file upload system, advanced conditional logic engine, or multi-step form builder.

== Installation ==

= From WordPress Admin =

1. Go to Plugins -> Add New.
2. Search for "Pluximo Form Blocks".
3. Click Install Now.
4. Activate the plugin.

= Manual Installation =

1. Download the plugin zip file.
2. Upload it to `/wp-content/plugins/pluximo-form-blocks/`.
3. Activate the plugin from the Plugins screen.

= Quick Start =

1. Edit any page or post in the WordPress block editor.
2. Add the Form Wrapper block.
3. Add Text Input, Textarea, Checkbox, Radio, or Select blocks inside the wrapper.
4. Configure labels, required fields, and validation messages.
5. Publish the page.
6. Submit the form on the frontend and check Form Entries in the dashboard.

== Screenshots ==

1. Build a contact form directly in the Gutenberg editor with native form blocks.
2. A live frontend contact form with responsive styling and a clear submit button.
3. The Form Entries dashboard where submitted messages are stored in WordPress admin.
4. Validation in action with required field and email-format errors.
5. Email notification settings for recipients and subject lines.
6. Cloudflare Turnstile spam protection settings and verification.

== Frequently Asked Questions ==

= Is Pluximo Form Blocks a contact form plugin? =

Yes. It is a contact form plugin and form builder for the WordPress block editor.

= Does it work with Gutenberg? =

Yes. The plugin is built for Gutenberg. Forms are created from blocks inside the editor.

= How is this different from Contact Form 7? =

Contact Form 7 is a classic shortcode-based contact form plugin. Pluximo Form Blocks is block-first, so you build forms directly inside the WordPress editor instead of creating a form elsewhere and pasting a shortcode.

= How is this different from WPForms? =

WPForms is a larger standalone form builder. Pluximo Form Blocks is focused on native Gutenberg form building, simple contact forms, validation, spam protection, and entries.

= Where are form submissions stored? =

Submissions are stored in WordPress admin as Form Entries.

= Does it send email notifications? =

Yes. You can enable or disable notifications, set the recipient email, and customize the subject.

Email delivery depends on your hosting setup. If messages do not arrive, check spam and confirm your WordPress site can send email. An SMTP plugin can improve reliability.

= Does it protect forms from spam? =

Yes. The plugin supports Cloudflare Turnstile and includes IP-based throttling.

= Can I customize validation messages? =

Yes. You can customize required field messages and other prompts from the block settings.

= Does it work with my theme? =

Yes. The frontend form output is responsive and designed to fit cleanly into most WordPress themes.

= Can I export form entries? =

Entries are stored in WordPress, so you can use WordPress export workflows or admin tooling around the entry post type.

= Is it translation-ready? =

Yes. Plugin strings are translation-ready.

== Changelog ==

= 1.3.0 - 2026-07-05 =

* Added email notification template for form submissions.

= 1.2.0 - 2026-04-05 =

* Form wrapper InnerBlocks allowlist includes all shipped field blocks (checkbox, radio, select) for consistent builder behavior.

= 1.1.0 - 2025-12-26 =

**New Features**

* Checkbox, radio, and select field blocks.
* Better spam protection.
* Optional email notifications.
* Editor warnings for empty forms.

**Enhancements**

* Cleaner validation messages and focus behavior.
* Improved accessibility and visual feedback.

= 1.0.0 - 2025-10-26 =

* Initial release.
* Form Wrapper block for creating form containers.
* Text Input block with email, URL, tel, password, and text types.
* Textarea block for multi-line input.
* Advanced validation system with required, min/max length, and regex patterns.
* Real-time client-side validation with custom error messages.
* Secure REST API endpoints for form processing.
* Custom post type for form entry storage.
* IP-based spam protection and rate limiting.
* WordPress nonce security verification.
* Tailwind CSS integration for professional styling.
* Responsive design that works on all devices.
* Translation-ready with proper internationalization.

== Upgrade Notice ==

= 1.3.0 =
Adds a formatted email notification template for submitted forms. Safe to upgrade.

= 1.2.0 =
Maintenance release: wrapper block now allows every shipped field type inside the form, with clearer contributor documentation. Safe to upgrade.

= 1.1.0 =
Major feature update. Adds checkbox, radio, and select field blocks, Cloudflare Turnstile spam protection, email notifications, and enhanced accessibility. Fully backward compatible and safe to upgrade.

= 1.0.0 =
Initial release. Start building professional contact forms directly in your WordPress block editor.
