=== SentientMail Forms & Newsletter ===
Contributors: sentientmail
Tags: newsletter, forms, email marketing, signup, contact form
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Newsletter signups and full-featured forms that flow straight into your SentientMail audience.

== Description ==

SentientMail Forms connects your WordPress site to [SentientMail](https://sentientmail.com), so every newsletter signup and form submission lands in your email audience automatically — ready for journeys, campaigns, and transactional email.

**Newsletter signups in two minutes**

1. Install and activate the plugin
2. Paste your SentientMail Events API key on the Get Started screen
3. Add the ready-made Newsletter Signup form to any page — as a block or a shortcode

**Everything else a small site needs from forms**

* Contact, application, and custom forms with 14 field types (including file uploads)
* Every submission saved as an entry, with CSV export
* Email notifications with smart tags (`{all_fields}`, `{field_id="2"}`, …)
* Show-a-message or redirect confirmations
* Invisible anti-spam (honeypot + time trap) out of the box; optional Cloudflare Turnstile
* Trigger a SentientMail transactional email to the submitter (welcome emails, promo codes)
* Outgoing webhooks with HMAC signatures for anything else (Zapier, Make, custom apps)
* One-click import of WPForms forms and entries if you're switching

The plugin works without a SentientMail account too — forms, entries, and notifications are fully functional standalone. Connect an account when you're ready to grow your list.

== Installation ==

1. Upload the plugin ZIP under Plugins → Add New → Upload Plugin, then activate it.
2. You'll land on the Get Started screen. Paste your Events API key from SentientMail (Settings → API Keys).
3. Add the Newsletter Signup form to a page: add a block and search "SentientMail Form", or paste the shortcode shown on the Get Started screen.

== Frequently Asked Questions ==

= Do I need a SentientMail account? =

No — forms, entries, and email notifications work standalone. A free SentientMail account adds audience sync, journeys, and transactional email.

= Where do submissions go? =

Three places: the Entries screen in your dashboard, your notification email(s), and — if connected — your SentientMail audience.

= Does it work with my page builder? =

The `[sentientmail_form id=123]` shortcode works anywhere shortcodes are supported, and the block works in the standard editor.

= What data does the plugin send to SentientMail? =

Only what a form collects, and only when you've connected an API key and enabled sync for that form. Nothing is sent anywhere else.

== Changelog ==

= 1.0.0 =
* Initial release: newsletter signups, form builder, entries, notifications, confirmations, chunked file uploads, SentientMail audience sync + transactional sends, signed webhooks, Turnstile, WPForms import.
