So verwendest du das Double-Opt-in für Contact Form 7, Avada und Elementor (v2.3.8)

Mit unserem Plugin Forge12 Double-Opt-in für Contact Form 7 erweiterst du die Formulare von Contact Form 7, Elementor und Avada um ein zusätzliches Opt-in System (DOI). Die Light Version kannst du direkt aus dem WordPress-Plug-in Repository installieren (Link).

Es sind lediglich wenige, einfache Schritte notwendig, um das Double-Opt-in zu konfigurieren

Gerne kannst du auch das Video anschauen, dieses wurde für Version 2.3.8 aufgezeichnet:

Double-Opt-in Plugin installieren #

Als Erstes muss das Plugin über den WordPress-Plugin-Manager installiert werden. Hierzu wechselst du im Backend deiner WordPress Webseite einfach zum Menüpunkt Plugins und wählst dort in der Unternavigation den Menüpunkt Installieren aus (WordPress Dashboard > Plugins > Installieren).

Über die Schaltfläche Plugin hochladen kannst du das Plugin auf deinen Server hochladen.

Anschließend betätigst du noch die Schaltfläche „aktiveren“, um das Contact Form 7 Double-Opt-in Plugin bei WordPress zu registrieren.

Double-Opt-in konfigurieren #

Nach der Installation des Plugins stehen deinen Contact Form 7 Formularen, den Avada Forms und dem Elementor Forms neue Einstellungen zur Verfügung.

Konfigurieren von Contact Form 7 Formularen #

Um deine Contact Form 7 Formulare zu konfigurieren, wechselst du zunächst zu Formulare > Kontaktformulare > [beliebiges_formular] bearbeiten. Anschließend wählst du den Reiter Double-Opt-In aus.

Dort kannst du alle relevanten Einstellungen für das Double-Opt-in-Verfahren festlegen. Hier ein Beispiel, für die Konfiguration des Opt-Ins:

Konfigurieren von Avada Formularen #

Um das Double-Opt-in für deine Avada Formulare zu aktivieren, wechselst du zunächst Avada > Forms > [beliebiges_formular] bearbeiten.

In den Formularoptionen findest du einen neuen Reiter mit der Beschriftung Double-Opt-in mit allen Konfigurationsoptionen.

Durch das Speichern wird das Double-Opt-in für das Formular aktiviert. Nun muss der Besucher zunächst die E-Mail verifizieren.

Wichtig: Damit das Double-Opt-in greift, musst du sicherstellen, dass im Tab Submission der Submission Type auf Save to Database geändert wurde, andernfalls wird keine E-Mail versendet.

Hinweis: Den „Field Name“ für die E-Mail-Adresse findest du durch das Bearbeiten des Felds heraus.

Konfigurieren von Elementor Formularen #

Wechsel auf die Seite, die dein Formular beinhaltet und öffne diese in Elementor. Anschließend wählst du das Formular zum Bearbeiten aus.

Um das Double-Opt-in zu verwenden. Wechselst du auf den Reiter Aktionen nach dem Versenden. Wähle als Optionen Collect Submissions, Forge12 Double-Opt-in und E-Mail aus. Falls du darüber hinaus auch eine E-Mail an den Besucher senden möchtest, nachdem dieser das Double-Opt-in abgeschlossen hat, kannst du hier noch die E-Mail 2 hinzufügen.

Nach der Aktivierung erscheint der Reiter „Forge12 Double-Opt-in“ für die Einstellungen des Double-Opt-ins.

Wähle den Reiter aus und konfiguriere die Parameter nach Bedarf.

E-Mail / Opt-in Template Parameter und Konfiguration #

Sowohl für Contact Form 7, Avada als auch Elementor stehen diverse Vorlagen für die Opt-in E-Mail zur Verfügung. Diese können nach Belieben bearbeitet werden. Damit das Opt-in jedoch funktioniert, ist es erforderlich, dass immer der Parameter [doubleoptinlink] eingebunden wird. Dieser Begriff steht als Platzhalter und wird bei der E-Mail Generierung durch den Opt-In Link ersetzt.

<a href="[doubleoptinlink]">Bestätigen Sie das Opt-In</a>

Es stehen noch weitere Parameter zur Verfügung, die in die Opt-in Mail eingebaut werden können:

So funktioniert das Double-Opt-in System #

Mit dem Aktivieren des Double-Opt-in Systems verändert sich auch das Verhalten des Formulars.

Benutzer bestätigt Double-Opt-in #

Diese Schritte werden ausgeführt, im Fall, dass der Benutzer das Double-Opt-in bestätigt:

1. Double-Opt-in Mail wird versendet
2. Besucher bestätigt den Double-Opt-in Link
3. Double-Opt-in Informationen werden gespeichert
4. Normale E-Mail (1) wird verschickt
5. Normale E-Mail (2) wird verschickt – falls diese aktiviert wurde.

Benutzer bestätigt Double-Opt-in nicht #

Diese Schritte werden ausgeführt, im Fall, dass der Benutzer das Double-Opt-in nicht bestätigt:

1. Double-Opt-in Mail wird versendet
2. Besucher bestätigt den Link nicht innerhalb der vordefinierten Zeit
3. Daten werden gelöscht

Alte Daten werden durch einen WPCron automatisch nach der von dir gewählten Zeit gelöscht. Du kannst die Daten frei konfigurieren. Die Einstellungen findest du im Reiter Forge12 Double-Opt-in > Settings.

Welche Daten werden gespeichert #

Ein Double-Opt-in muss protokolliert werden. Dadurch wird sichergestellt, dass die E-Mail auch wirklich dem Empfänger zugeordnet werden kann.

Hierfür speichert unser Plugin einige Informationen ab. Die Informationen können jederzeit über Forge12 Double-Opt-in > Dashboard eingesehen werden.

Alle Daten werden für die von dir eingestellte Dauer gespeichert, um nachweisen zu können, dass sich ein Besucher über das Double-Opt-in angemeldet hat und dieses bestätigt wurde. Auch nach einem Opt-out werden die Daten noch für 30 Tage aufbewahrt.

Double-Opt-in Daten Exportieren #

Alle durchgeführten Opt-in können jederzeit als CSV-Datei exportiert werden. Es können sowohl einzelne als auch alle Opt-in exportiert werden. Falls Kategorien verwendet werden, können ebenfalls nur Opt-in Informationen einer bestimmten Kategorie exportiert werden.

Exportieren aller Opt-in Daten #

Um alle Daten zu exportieren, wechselst du auf im WordPress Backend zu Forge12 Double Opt-In > Dashboard. Dort findest du nun eine Übersicht über die zuletzt durchgeführten Opt-Ins. Am Ende der Tabelle findest du die Schaltfläche zum Exportieren aller Einträge als CSV.

Exportieren einzelner Opt-In Daten #

Es ist auch möglich, nur einzelne Informationen zu exportieren. Hierfür wechselst du im WordPress Backend zu Forge12 Double Opt-In > Dashboard. Fahre anschließend mit der Maus über das gewünschte Opt-In, um den Link zur Detail-Seite angezeigt zu bekommen. Auf der Detail-Seite findest du die Schaltfläche zum Exportieren der Daten (Export as CSV).

Exportieren aller Opt-In Daten einer Kategorie #

Um alle Opt-In einer Kategorie zu exportieren, wechselst du im WordPress Backend zu Forge12 Double Opt-In > Categories > [Name der Kategorie]. Dort findest du alle Opt-Ins, die der jeweiligen Kategorie zugeordnet wurden. Die Option zum Exportieren der Opt-Ins findest du am Ende der Tabelle (Export as CSV).

So verwendest du das Opt-out System #

Mit Version 2 des Opt-in Systems wurde die Möglichkeit integriert, den Besuchern die Option zu geben, sich von durchgeführten Opt-in abzumelden.

Die Opt-out Seite für den Besucher #

Als Erstes benötigst du eine neue Seite, auf der später für den Besucher alles Weitere angezeigt wird. Hierzu erstellst du im Backend von WordPress einfach eine neue Seite und fügst den folgenden Shortcode ein.

[f12-cf7-doubleoptin-optout-list]

Natürlich kannst du die Seite weiter gestalten und zusätzliche Inhalte einfügen. Wichtig ist lediglich, dass der Shortcode auf der Seite platziert wurde.

Konfigurieren des Opt-out #

Als Nächstes wechselst du im Backend von WordPress zu Forge12 Double Opt-in > Opt-out. Dort können nun alle weiteren Einstellungen für das Opt-out vorgenommen werden.

Das Opt-out Formular #

Als Letztes muss nur noch das Opt-out Formular integriert werden. Hierfür verwendest du den folgenden Shortcode.

[f12-cf7-doubleoptin-optout-form]

Der Shortcode erzeugt ein einfaches Formular, über den der Besucher auf den Opt-out Prozess zugreifen kann.

Sobald das Formular abgesendet wurde, wird ein Einmal-Link erzeugt und an die gewählte E-Mail-Adresse versendet. Der Link ist nur temporär gültig und wird anschließend wieder gelöscht.

Der Shortcode für das Formular kann beliebig auf der Seite platziert werden. Die Darstellung kann dann über den WordPress Customizer erfolgen oder aber durch separate CSS Dateien.

Die Opt-Out Liste #

Sobald der Besucher auf den Opt-out Link klickt, wird dieser an die zuvor angelegte Seite weitergeleitet und erhält dort eine Übersicht aller durchgeführten und ausstehenden Opt-ins. Diese kann zum Beispiel wie folgt aussehen:

Der Besucher sieht dann, ob und wann das Opt-In durchgeführt wurde und wie lange die Daten gespeichert werden. Über Opt-Out now! kann er sich von durchgeführten Opt-ins auch wieder abmelden. Die Spalte „valid until“ ergibt sich aus den konfigurierten Einstellungen.

Verfügbare Filter und Hooks für die Erweiterung #

Für Entwickler bieten wir die Möglichkeit an, auf integrierte WordPress Hooks zuzugreifen, um das System an externe Schnittstellen anzubinden.

Doppelte Opt-Ins #

Erlaubt es, Opt-Ins zu verarbeiten, die doppelte durchgeführt wurden. (z.B. wenn der Opt-In Link doppelt geklickt wird).

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

Vor der Opt-In Bestätigung #

Erlaubt es, ein Opt-in zu bearbeiten, bevor dieses gespeichert wird.

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

Nach der Opt-In Bestätigung #

Erlaubt das Modifizieren des Opt-In nach der Bestätigung. Erlaubt es auch, das Opt-In nach der Bestätigung an Schnittstellen zu überreichen.

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

Nach dem Senden der Opt-In Mail #

Erlaubt das Durchführen weiterer Schritte nach dem Versenden der 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);

Advanced CF7 DB – Mail vom Tracking ausschließen #

Falls du das Plugin Advanced CF7 DB verwendest und zum Beispiel die Opt-in Mail nicht erfassen möchtest, kannst du einfach den folgenden Code verwenden:

/**
 * Remove Advanced CF7 DB Hook for Opt-in Mails.
 */
add_action('f12_cf7_doubleoptin_sent', function($form, $form_id){
    remove_action('wpcf7_before_send_mail','vsz_cf7_before_send_email');
}, 10, 2);

Fazit #

Das Verwenden des Forge12 Double-Opt-in Plugins für Contact Form 7 ist dank seiner Integration schnell und unkompliziert realisierbar. Dank der Protokollierung der Daten kann jederzeit ein Nachweis für das Double-Opt-In erbracht werden.

Habt Ihr Ideen, wie man das Plugin erweitern könnte oder hättet Ihr gerne noch zusätzliche Funktionen? Dann schreibt uns doch einfach einen Kommentar.