=== Fieldwren – Contact Form & Block Form Builder ===
Contributors: webangon
Tags: contact form, form builder, gutenberg forms, multi-step form, payment form
Requires at least: 6.5
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

Contact forms and a full form builder in the block editor. 45 field blocks, multi-step, conditional logic, quizzes, payments, entries and reports.

== Description ==

**Fieldwren** builds forms the way you already build pages: in the block editor. Every field is a block. You can move it, duplicate it, put it in columns and style it from the sidebar. There is no separate builder screen to learn.

You can have a simple contact form running in under a minute. Or you can start from one of **79 ready-made templates**, such as quote requests, job applications, event registration, appointment booking, NPS surveys, quizzes, price calculators and order forms with payment. You can edit every template.

Features, screenshots and a full FAQ are on the [Fieldwren website](https://webangon.com/plugins/fieldwren/).

= Why Fieldwren =

* **Native block editor.** Fields are real blocks with live preview, undo, copy and paste.
* **Everything is in the free plugin.** Multi-step forms, conditional logic, calculations, file uploads, payments, entries, reports and integrations are all included. No field is locked.
* **Entries you can work with.** Entries are stored in your own database. You can search, star and export them, and see where every lead came from.
* **Light front end.** The form script is plain JavaScript and does not need jQuery.

= 45 field blocks =

* **General:** Text (with input masks), Email (confirmation, allowed or blocked domains), Name, Textarea, Number, Phone (country codes), URL, Hidden (UTM, referrer and user capture), Password.
* **Choice:** Dropdown (searchable or multiple, filled from posts, terms or users), Radio and Checkboxes (list, inline, columns, buttons, cards, image choices, "Other", select all, min/max), Country, Rating, NPS, Range slider, Likert grid, Ranking, Color.
* **Advanced:** Date and Time (min/max, weekends, blocked dates), File and Image upload (drag and drop), Signature, Terms / GDPR consent, Calculation (safe formula engine), Address (optional Google Places autocomplete), Map pin, Repeater.
* **Layout:** Columns, Section break, Custom HTML, Form step, Submit, Captcha, Save and resume, Shortcode, Action hook.
* **Payment:** Payment item, Item quantity, Custom amount, Subscription, Payment method, Coupon, Payment summary.

= Smart forms =

* **Conditional logic** on fields, steps, notifications, confirmations and integrations.
* **Multi-step forms** with a progress bar, per-step validation and saved progress.
* **Calculations** for quotes, estimates, and loan and savings calculators.
* **Quizzes and personality tests** with scoring, grades and answer review.
* **Save and resume later**, plus partial entries from abandoned forms.
* **Conversational mode** that shows one question at a time.
* **Landing pages** at `/form/{slug}/` so you can share a form without building a page.

= After submit =

* Show a confirmation message, redirect to a page or URL, or set conditional confirmations.
* Send unlimited email notifications with routing rules, CC/BCC and attachments, designed with the built-in email designer.
* Use double opt-in or admin approval, create posts, register users or update profiles.
* Set entry limits and schedules, make forms login-only or allow one entry per person.

= Entries and reports =

* Entry list with views for unread, starred, awaiting approval, partial, spam and trash entries.
* Search, date filters, bulk actions, CSV/JSON export, notes, an activity log, printing and editing.
* Reports on views, starts, submissions and conversion rate, plus survey results (NPS, answer breakdowns).
* Logs of every email, integration call and payment call.
* A front-end entries table with `[fieldwren_entries form="ID"]`.

= Payments =

Stripe (including subscriptions), PayPal (including subscriptions), Mollie, Razorpay, Paystack, Square, Authorize.net and offline / bank transfer. Coupons, server-side totals, signed webhooks, refunds and a transactions screen are included.

= Spam protection =

Honeypot, time trap and rate limit work out of the box. Cloudflare Turnstile, Google reCAPTCHA v2/v3, hCaptcha and Akismet are optional.

= Integrations =

Webhooks, Zapier, Make, n8n, Slack, Discord, Telegram, Microsoft Teams, Twilio SMS and WhatsApp, Mailchimp, Brevo, MailerLite, Kit, Klaviyo, ActiveCampaign, GetResponse, Campaign Monitor, Drip, Moosend, MailPoet, FluentCRM, HubSpot, Salesforce, Pipedrive, Zoho CRM, Odoo, Help Scout, Google Sheets, Google Drive, Dropbox, Airtable, Notion, Trello, Asana and ClickUp.

= Also included =

* Popups and slide-ins that can show any form.
* SMTP sending through Gmail, Amazon SES, SendGrid, Mailgun, Postmark and more.
* Conversion tracking with dataLayer events and GA4, Meta Pixel and LinkedIn conversions.
* The Fieldwren Form block, an Elementor widget and the `[fieldwren_form id="123"]` shortcode.
* An importer for Fluent Forms forms and entries.

= Developers =

PHP hooks include `fwren/register_fields`, `fwren/validate`, `fwren/values`, `fwren/submission/inserted`, `fwren/submission/completed`, `fwren/feed/{integration}` and `fwren/smartcode`.
In JavaScript you can use `window.FWRENForms` and the events `fwren:ready`, `fwren:change`, `fwren:step`, `fwren:submitted` and `fwren:error`.
REST routes: `fwren/v1/forms/{id}/submit`, `upload`, `draft` and `track`, and `fwren/v1/entries`.

= Links =

* [Fieldwren website](https://webangon.com/plugins/fieldwren/): features, screenshots and FAQ
* [Support forum](https://wordpress.org/support/plugin/fieldwren/)
* [Contact Webangon](https://webangon.com/contact/)
* [More free plugins from Webangon](https://webangon.com/plugins/)

== External services ==

Fieldwren works without any outside service. It contacts the services below only when you turn on the matching feature, and most of them also need your own account keys. Each service receives only the data that its feature needs.

* **Google reCAPTCHA** (spam check). The visitor's browser loads the reCAPTCHA script. When a form is submitted, your server sends the token and the visitor's IP address to Google. [Terms](https://policies.google.com/terms), [Privacy](https://policies.google.com/privacy)
* **hCaptcha** (spam check). Sends the same data as reCAPTCHA. [Terms](https://www.hcaptcha.com/terms), [Privacy](https://www.hcaptcha.com/privacy)
* **Cloudflare Turnstile** (spam check). Sends the same data as reCAPTCHA. [Terms](https://www.cloudflare.com/website-terms/), [Privacy](https://www.cloudflare.com/privacypolicy/)
* **Akismet** (spam check, needs the Akismet plugin). Sends the submission's name, email, message and IP address. [Terms](https://akismet.com/tos/), [Privacy](https://automattic.com/privacy/)
* **Google Maps Places** (address autocomplete, needs your API key). The visitor's browser sends the address they type to Google. [Terms](https://cloud.google.com/maps-platform/terms), [Privacy](https://policies.google.com/privacy)
* **OpenStreetMap** (Map pin field). On pages with a map field, the visitor's browser loads map tiles from OpenStreetMap. The Leaflet map library is bundled with the plugin. [OpenStreetMap tile policy](https://operations.osmfoundation.org/policies/tiles/), [OpenStreetMap privacy](https://osmfoundation.org/wiki/Privacy_Policy)
* **Google Fonts** (only when you choose a Google font in the style settings). The visitor's browser loads the font from Google. [Privacy](https://policies.google.com/privacy)
* **api.qrserver.com** (form landing page, only when you click "QR code"). Sends the landing page URL. [Privacy](https://goqr.me/privacy-safety-security/)
* **Payment gateways.** When a visitor pays, the amount, currency, description and the payer's name and email go to the gateway you connected: Stripe ([Terms](https://stripe.com/legal), [Privacy](https://stripe.com/privacy)), PayPal ([Terms](https://www.paypal.com/legalhub/home), [Privacy](https://www.paypal.com/myaccount/privacy/privacyhub)), Mollie ([Terms](https://www.mollie.com/legal), [Privacy](https://www.mollie.com/privacy)), Razorpay ([Terms](https://razorpay.com/terms/), [Privacy](https://razorpay.com/privacy/)), Paystack ([Terms](https://paystack.com/terms), [Privacy](https://paystack.com/privacy)), Square ([Terms](https://squareup.com/legal/general/ua), [Privacy](https://squareup.com/legal/general/privacy)) or Authorize.net ([Terms](https://www.authorize.net/about-us/terms.html), [Privacy](https://usa.visa.com/legal/privacy-policy.html)).
* **SMTP and email API providers** (Gmail, Outlook, Amazon SES, SendGrid, Mailgun, Postmark, Brevo, Mailjet, SMTP2GO, Resend, Elastic Email, Mailtrap and others). Your site's emails go through the provider you choose.
* **Integrations** (Forms → Settings → Integrations). These include Mailchimp, HubSpot, Salesforce, Pipedrive, Zoho, Odoo, Google Sheets, Google Drive, Dropbox, Airtable, Notion, Trello, Asana, ClickUp, Slack, Discord, Telegram, Microsoft Teams, Twilio, Zapier, Make and n8n. After you connect one, the entry fields you map are sent to that service when a form is submitted. Each provider's own terms and privacy policy apply.

== Credits ==

* [Leaflet](https://leafletjs.com/) 1.9.4 by Volodymyr Agafonkin, BSD 2-Clause License. Bundled in `assets/vendor/leaflet` for the Map pin field.

== Installation ==

1. Install Fieldwren from Plugins → Add New, or upload the `fieldwren` folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Forms → Templates** to pick a template, or to **Forms → Add New** to start from scratch.
4. Add the form to any page with the **Fieldwren Form** block or the shortcode `[fieldwren_form id="123"]`.

== Frequently Asked Questions ==

= Is this a contact form plugin or a full form builder? =

It is both. The contact form template takes one click, and the same editor builds surveys, quizzes, calculators, applications and payment forms.

= Do I need a page builder? =

No. Fieldwren uses the WordPress block editor. If you use Elementor, an Elementor widget is included.

= Where are entries stored? =

In your own WordPress database, in tables whose names start with `{prefix}fwren_`. Entries are not sent to us.

= Can I accept payments? =

Yes. Add the payment blocks and connect Stripe, PayPal, Mollie, Razorpay, Paystack, Square or Authorize.net, or use offline / bank transfer.

= Can I move my forms from Fluent Forms? =

Yes. Forms → Tools imports Fluent Forms forms and their settings, and their entries too if you want them.

= Is there a Pro version? =

No. Fieldwren is free, and every feature is in this plugin. See the [Fieldwren website](https://webangon.com/plugins/fieldwren/) for the full feature list.

= Where can I get help? =

Ask in the [support forum](https://wordpress.org/support/plugin/fieldwren/), or get in touch through the [Webangon contact page](https://webangon.com/contact/).

== Screenshots ==

1. The dashboard with form stats, a quick start and a getting-started checklist.
2. Building a form in the block editor. Every field is a block with its own settings.
3. A contact form on the front end.
4. A multi-step form with a progress bar and per-step validation.
5. A calculation field for quotes, estimates and price calculators.
6. Entries: search, filter, star, export and bulk-manage submissions.
7. Reports on views, starts, submissions and conversion for every form.
8. 79 ready-made form templates, grouped by use case.

== Changelog ==

= 1.0.0 =
* First release.
