=== Petal Forms ===
Contributors: satbirgandhi
Tags: form, form builder, contact form, drag and drop, survey
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A fast, no-upsell drag-and-drop form builder. Unlimited forms, fields, and entries — free.

== Description ==

Petal Forms is a lightweight WordPress form builder. Unlike the free tier of most
form plugins, it does not lock common fields (Phone, Date, Time, Number) behind
a paid upgrade, and it does not cap forms, fields, or entries.

**Features**

* Drag-and-drop-style form builder in wp-admin
* 13 field types out of the box, including Phone, Date, and Time — free
* Entries stored in the database, viewable and exportable to CSV
* Email notifications to the site admin, with optional confirmation email to the submitter
* Honeypot spam trap + submission rate limiting, no configuration required
* Optional Google reCAPTCHA v2 integration
* Shortcode (`[petal_form id="1"]`) and a native Gutenberg block
* File uploads with an extension allow-list
* Clean uninstall option — leaves no orphaned database tables unless you opt in

**What this is not**

Petal Forms does not include payment processing (Stripe/PayPal), third-party CRM
integrations (Salesforce, HubSpot), or multi-site license management. If you need
those, a mature paid plugin will serve you better. Petal Forms is built for people
who just want a solid, unrestricted form builder.

== Installation ==

1. Upload the `petal-forms` folder to `/wp-content/plugins/`.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to Petal Forms → Add New to build your first form.
4. Paste the generated shortcode into any page or post, or use the Petal Forms block.

== Frequently Asked Questions ==

= Does this cost anything? =

No. There is no paid tier, no feature gating, and no license key.

= Where are entries stored? =

In two dedicated database tables (`wp_petalforms_forms` and `wp_petalforms_entries`),
created on activation. Deactivating the plugin keeps your data; deleting it does too,
unless you check "Delete all forms and entries" under Petal Forms → Settings first.

= Can I export entries? =

Yes — Petal Forms → Entries → Export CSV.

== External services ==

This plugin optionally integrates with Google reCAPTCHA to help block spam submissions. It only connects to Google's servers if you enter a Site Key and Secret Key under Petal Forms → Settings; with no keys entered, no data is ever sent to Google.

When enabled, on every form submission the visitor's reCAPTCHA response token and IP address are sent to Google's siteverify API to confirm the submission is human. The reCAPTCHA widget script is also loaded from Google on any page showing a form.

This service is provided by Google: [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy).

== Screenshots ==

1. All Forms — every form you've built, at a glance, with entry counts and shortcodes.
2. The drag-and-drop builder — add and arrange fields with a live preview.
3. Payment (Stripe) field — collect payments right in the form, no separate checkout.
4. Entries — every submission stored and searchable, with one-click CSV export.
5. The finished form on the front end — clean, unstyled-by-default, and ready to match your theme.

== Changelog ==

= 1.0.0 =
* Initial release.
