← All changes | readme.txt +30 -18 5.6.3 → 5.7.0 View file →

		@@ -1,12 +1,12 @@
1	1	=== Double Opt-In for Contact Form 7 – Secure, GDPR-Compliant Email Verification ===
2	2	Contributors: forge12
3	3	Donate link: https://www.paypal.com/donate?hosted_button_id=MGZTVZH3L5L2G
4		-Tags: contact form 7, double opt-in, gdpr, email verification
	4	+Tags: contact form 7, double opt-in, gdpr, email verification, newsletter
5	5	Requires at least: 6.0
6	6	Tested up to: 7.0
7	7	Requires PHP: 7.4
8		-Stable tag: 5.6.3
	8	+Stable tag: 5.7.0
9	9	License: GPLv3
10	10	License URI: http://www.gnu.org/licenses/gpl-3.0.html
11	11
12	12	**Protect your Contact Form 7 forms with GDPR-compliant Double Opt-In.**
		@@ -42,13 +42,12 @@
42	42	[Read the Quick Guide](https://www.forge12.com/blog/so-verwendest-du-das-double-opt-in-fuer-contact-form-7/)
43	43
44	44	= Free Features =
45	45
46		-* **Block-Based Email Templates** -- build your confirmation email from heading, text, button, spacer, divider and placeholder blocks
47	46	* **Double Opt-In for Contact Form 7** -- per-form activation with full CF7 integration
48	47	* **Centralized Form Settings** -- manage all form integrations from a single admin panel
49		-* **Email Template Presets** -- start from a pre-built template (one saved template on the free version)
50		-* **Send Test Email** -- preview your confirmation emails before going live
	48	+* **Built-In Email Designs** -- write the confirmation email per form and pick one of three ready-made HTML layouts, or send it plain
	49	+* **Resend Confirmation** -- resend the confirmation email to a single recipient from the opt-in detail view
51	50	* **Custom Confirmation Pages** -- redirect users to a specific page after confirmation
52	51	* **Dynamic Conditions** -- enable opt-in based on user input (e.g. only when a checkbox is checked)
53	52	* **Delete Confirmation Modal** -- safety dialog before deleting an opt-in record to prevent accidental deletion
54	53	* **GDPR Consent Export** -- export individual consent records as JSON or CSV directly from the opt-in detail view
		@@ -63,13 +62,13 @@
63	62	* **Category System** -- organize opt-ins into categories for better management
64	63	* **Pagination & Search** -- search and filter opt-in records in the admin dashboard
65	64	* **Admin Tooltips** -- contextual help tooltips throughout the admin interface
66	65	* **WordPress Multisite** -- network-wide activation creates tables on all sites automatically
67		-* **Developer Hooks** -- 44 action hooks, 72 filters, and 11 typed events for full extensibility
	66	+* **Developer Hooks** -- 44 action hooks, 74 filters, and 11 typed events for full extensibility
68	67
69	68	= Pro Features =
70	69
71		-Unlock the full potential of Double Opt-In with the [Pro version](https://www.forge12.com):
	70	+Unlock the full potential of Double Opt-In with the [Pro version](https://www.forge12.com/shop/contact-form-7-double-opt-in?from=readme&utm_source=double-opt-in&utm_medium=plugin&utm_campaign=readme):
72	71
73	72	**Additional Form Integrations:**
74	73
75	74	* **Double Opt-In for Elementor Forms** -- seamless integration with Elementor's form widget
		@@ -85,10 +84,9 @@
85	84	**Email & Communication:**
86	85
87	86	* **Double Opt-Out System** -- unique opt-out links per submission with confirmation emails
88	87	* **Opt-In Reminder System** -- automatic reminders for unconfirmed opt-ins via cron
89		-* **Visual Email Editor** -- drag & drop editor with live preview and mobile preview, plus unlimited saved templates
90		-* **Resend Confirmation** -- resend the confirmation email to a single recipient from the admin dashboard
	88	+* **Visual Email Editor** -- drag & drop block editor with live preview and mobile preview, template presets, unlimited saved templates and test emails
91	89	* **Conditional Email Templates** -- dynamic content blocks based on form data
92	90	* **Multi-Column Layouts** -- 2-column, 3-column, and sidebar layouts in the email editor
93	91	* **Image & Social Blocks** -- add images and social media icons to your emails
94	92
		@@ -153,9 +151,9 @@
153	151	If you configured Double Opt-In on an Avada form before Core 5.0, a one-time notice appears in your WordPress admin with a **"Claim free Avada grandfather license"** button. One click installs the paid Avada addon with a permanent free license bound to your site. Your existing setup continues working with zero configuration changes. The free claim window is open until October 2026.
154	152
155	153	= Can I customize the confirmation email? =
156	154
157		-Yes. The plugin includes a visual drag & drop email editor with block-based design. You can choose from pre-built template presets or create your own. Placeholders like `[doubleoptinlink]`, `[doubleoptin_form_date]`, and form field values are replaced automatically.
	155	+Yes. In the free version you write subject and text of the confirmation email in each form's settings and choose one of three built-in designs or plain text. Placeholders like `[doubleoptinlink]`, `[doubleoptin_form_date]`, and form field values are replaced automatically. The Pro version adds a visual drag & drop editor with template presets, reusable templates and test emails.
158	156
159	157	= What happens if the user does not confirm? =
160	158
161	159	Unconfirmed opt-ins are stored in the database and can be cleaned up automatically. You can configure the retention period for unconfirmed entries in the settings (e.g. delete after 30 days). In the Pro version, you can also send automatic reminder emails.
		@@ -193,9 +191,9 @@
193	191	The free version requires at least one supported form plugin. However, developers can register custom form integrations using the `f12_cf7_doubleoptin_register_integrations` action hook. See the developer documentation for details.
194	192
195	193	= Where can I find the developer documentation? =
196	194
197		-A hook, filter, and event reference with code examples ships at `docs/hooks-and-events.md` inside the plugin directory. It documents 27 of the 44 action hooks, 22 of the 72 filters, and all 11 typed events — the ones extensions actually reach for. The rest are discoverable in the source; if you need one documented, ask and we will add it.
	195	+A hook, filter, and event reference with code examples ships at `docs/hooks-and-events.md` inside the plugin directory. It documents 27 of the 44 action hooks, 22 of the 74 filters, and all 11 typed events — the ones extensions actually reach for. The rest are discoverable in the source; if you need one documented, ask and we will add it.
198	196
199	197	= How do I report a bug or request a feature? =
200	198
201	199	Please visit [forge12.com](https://www.forge12.com) or contact us via the WordPress support forum.
		@@ -201,15 +199,16 @@
201	199	Please visit [forge12.com](https://www.forge12.com) or contact us via the WordPress support forum.
202	200
203	201	== Screenshots ==
204	202
205		-1. **Opt-In Dashboard** -- Overview of all opt-in records with status, email, form, date, and actions.
206		-2. **Form Settings** -- Per-form configuration with sender, subject, recipient field, confirmation page, and conditions.
207		-3. **Email Template Editor** -- Visual drag & drop editor with blocks, live preview, and mobile preview.
208		-4. **Template Presets** -- Choose from pre-built email template designs.
209		-5. **Single Opt-In View** -- Detailed view of an opt-in record with form data, timestamps, and IP addresses.
210		-6. **Global Settings** -- Configure data retention, token expiry, telemetry, and opt-out settings.
211		-7. **Category Management** -- Organize opt-in records into categories.
	203	+1. **Dashboard** -- Total, confirmed and pending opt-ins at a glance, with the latest submissions.
	204	+2. **Opt-In list** -- Every record with form, status and date; search and filter by status, follow-up actions and mail delivery.
	205	+3. **Opt-in detail** -- Timestamps and IP addresses of request and confirmation, the consent text, and whether the form mail ran after the click.
	206	+4. **Forms** -- All Contact Form 7 forms with Double Opt-In switched on or off per form.
	207	+5. **Form settings** -- Consent text, acceptance field, category, sender, subject and confirmation page for one form.
	208	+6. **Setup wizard** -- Sender, forms, confirmation email and the page after the click, in four steps.
	209	+7. **Settings** -- Data retention, privacy policy page, token expiry and rate limits.
	210	+8. **What the visitor sees** -- After submitting: where the confirmation mail comes from and what to do if it does not arrive.
212	211
213	212	== Privacy & Telemetry ==
214	213
215	214	**As of version 5.1.7 the plugin no longer transmits any telemetry.** The daily
		@@ -239,8 +238,11 @@
239	238	licensed under the SIL Open Font License 1.1 (see licenses/inter-OFL-1.1.txt).
240	239
241	240	== Upgrade Notice ==
242	241
	242	+= 5.7.0 =
	243	+Adds a setup wizard for new installations. Existing forms and settings are not changed.
	244	+
243	245	= 5.6.3 =
244	246	Ships the hook and Addon API reference the readme refers to. No functional changes.
245	247
246	248	= 5.6.2 =
		@@ -335,8 +337,18 @@
335	337	= 3.1.0 =
336	338	Adds optional anonymous telemetry (opt-out). No breaking changes.
337	339
338	340	== Changelog ==
	341	+
	342	+= 5.7.0 =
	343	+
	344	+**A setup wizard gets new sites to the first working confirmation email**
	345	+
	346	+* New: after installing the plugin, a short wizard sets up the sender, the Contact Form 7 forms that should ask for confirmation, the confirmation email and the page visitors see after clicking the link. Everything is prefilled; it takes about three minutes and can be skipped at any time. A test email to yourself shows the result before visitors see it.
	347	+* New: the sender name and address from the wizard are used for every form you switch on later. Confirmation emails without a sender name no longer arrive as "WordPress".
	348	+* New: if you also use Elementor Pro, WPForms, Gravity Forms or Avada Forms, the wizard tells you which add-on protects those forms.
	349	+* Improved: forms that already use Double Opt-In are left exactly as they are. Existing sites do not see the wizard unless you start it under Settings.
	350	+* Fix: this description listed the visual email editor, saved templates and test emails as free features. They are part of the email editor add-on; the free plugin offers three built-in email designs. Resending a confirmation email from the opt-in details is free.
339	351
340	352	= 5.6.3 =
341	353
342	354	* Fix: the developer reference this readme points to — `docs/hooks-and-events.md` and `docs/addon-api.md` — was never actually included in the plugin. Both files now ship.