How to use the double opt-in for Contact Form 7 (v2.11)

With our plugin Forge12 Double-Opt-in for Contact Form 7 you extend the Contact Form 7 WordPress plugin with an additional opt-in system (DOI).

For this, only a few simple steps are needed to convert your form(s) to WordPress forms.

Install Double-Opt-in Plugin #

First, the plugin must be installed via the WordPress Plugin Manager. To do this, simply go to the backend of your WordPress website to the Plugins’ menu item and select the Installation menu item in the sub-navigation (WordPress Dashboard > Plugins > Install).

Use the Upload Plugin button to upload the plugin to your server.

Then click on the “Activate” button to register the Contact Form 7 Double-Opt-in plugin with WordPress.

Configure double opt-in #

After installing the plugin, your Contact Form 7 forms, new settings are available (Forms > Contact Forms > [any_form] > Double-Opt-in).

To enable opt-in for one or more of your forms, first go to the form’s settings (Forms > Contact forms > [any_form]). There you will find a new tab called Double-Opt-in.

There you can define all important settings for the double opt-in procedure.

Furthermore, in addition to the standard Contact Form 7 tags, additional shortcodes are available for use in the message body:

How the double opt-in system works #

Activating the double opt-in system also changes the behavior of the form.

User confirms double opt-in #

These steps are executed in case the user confirms the double opt-in:

1. Double opt-in mail is sent
2. Visitor confirms the double opt-in link
3. Double opt-in information is stored
4. Normal e-mail (1) is sent
5. Normal e-mail (2) will be sent – if this has been activated.

User does not confirm double opt-in #

These steps are performed in case the user does not confirm the double opt-in:

1. Double opt-in mail is sent
2. Visitor does not confirm the link within 7 days
3. Data will be deleted

Old data will be deleted automatically by a WP cron job after the time you selected. You have several options to choose from here.

What data is stored #

A double opt-in must be logged. This ensures that the e-mail can really be assigned to the recipient.

For this purpose, our plugin stores some information. The information can be viewed at any time via Tools / Forge12 Double-Opt-in.

All data is stored for the duration you set in order to be able to prove that a visitor has registered via the double opt-in and that this has been confirmed. Even after an opt-out, the data will be kept for 30 days.

Export Double-Opt-in Data #

All performed opt-ins can be exported as a CSV file at any time. Both individual and all opt-ins can be exported. If categories are used, only opt-in information of a certain category can be exported as well.

Export all opt-in data #

To export all data, go to Forge12 Double Opt-In > Dashboard in the WordPress backend. There you will find an overview of the most recent opt-ins. At the end of the table, you will find the button to export all entries as CSV.

Export individual opt-in data #

It is also possible to export only single information. To do this, go to Forge12 Double Opt-In > Dashboard in the WordPress backend. Then move the mouse over the desired opt-in to get the link to the details page. On the details page, you will find the button to export the data (Export as CSV).

Export all opt-in data of a category #

To export all opt-ins of a category, go to Forge12 Double Opt-In > Categories > [category name] in the WordPress backend. There you will find all opt-ins that have been assigned to the respective category. The option to export the opt-ins can be found at the end of the table (Export as CSV).

How to use the opt-out system #

With version 2 of the opt-in system, the possibility of giving visitors the option to unsubscribe from performed opt-ins was integrated.

The opt-out page for the visitor #

First, you need a new page, on which everything else will be displayed for the visitor later. To do this, simply create a new page in the backend of WordPress and insert the following shortcode.

[f12-cf7-doubleoptin-optout-list]

Of course, you can continue to design the page and add additional content. The only important thing is that the shortcode is placed on the page.

Configure the opt-out #

Next, go to Forge12 Double Opt-In > Opt-out in the backend of WordPress. There, you can now make all further settings for the opt-out.

The opt-out form #

The last thing to do is to integrate the opt-out form. For this, you use the following shortcode.

[f12-cf7-doubleoptin-optout-form]

The shortcode creates a simple form through which the visitor can access the opt-out process.

Once the form has been submitted, a one-time link is generated and sent to the selected e-mail address. The link is only temporarily valid and will be deleted afterwards.

The shortcode for the form can be placed anywhere on the page. The display can then be done via the WordPress Customizer or by separate CSS files.

The Opt-Out List #

As soon as the visitor clicks on the opt-out link, he will be redirected to the previously created page, where he will receive an overview of all performed and pending opt-ins. This can look like the following, for example:

The visitor then sees whether and when the opt-in was performed and how long the data is stored. Via Opt-Out now! He can also unsubscribe from performed opt-ins. The column “valid until” results from the configured settings.

Available filters and hooks for the extension #

For developers, we offer the possibility to access built-in WordPress hooks to connect the system to external interfaces.

Double opt-ins #

Allows to process opt-ins that have been performed twice. (e.g. when the opt-in link is clicked twice).

/**
 * @param string
 * @param OptIn $OptIn
 */
function already_confirmed($hash, $OptIn){
   // Do Something
}
add_action('f12_cf7_doubleoptin_already_confirmed', 'already_confirmed', 10, 2);

Before the opt-in confirmation #

Allows to edit an opt-in before it is saved.

/**
 * @param string
 * @param OptIn $OptIn
 */
function before_confirm($hash, $OptIn){
   // Do Something
}
add_action('f12_cf7_doubleoptin_before_confirm', 'before_confirm', 10, 2);

After the opt-in confirmation #

Allows modifying the opt-in after confirmation. Also allows passing the opt-in to interfaces after confirmation.

/**
 * @param string
 * @param OptIn $OptIn
 */
function after_confirm($hash, $OptIn){
   // Do Something
}
add_action('f12_cf7_doubleoptin_after_confirm', 'after_confirm', 10, 2);

After sending the opt-in mail #

Allows to perform further steps after sending the opt-in mail.

/**
 * @param array $form_data - An Array containing all dynamic form fields and placeholder data.
 * @param int $post_id - The Form ID
 */
function after_optin_mail_sent($form_data, $post_id){
   // Do Something
}
add_action('f12_cf7_doubleoptin_sent', 'after_optin_mail_sent', 10, 2);

Summary #

Using the Forge12 Double-Opt-in Plugin for Contact Form 7 is quick and easy thanks to its integration. Thanks to the logging of the data, proof of the double opt-in can be provided at any time.

Do you have ideas how to extend the plugin, or would you like to have additional features? Then just write us a comment.