Anmeldung zum Newsletter

Die E-Mail-Vorlage Anmeldung zum Newsletter verschickt den Double-Opt-In-Link fuer neue Newsletterempfaenger.

Ausloeser und Zweck

Die Vorlage gehoert zur Newsletter-Anmeldung im Shop. Wird Double-Opt-In verwendet, speichert der Shop den neuen Empfaenger zunaechst inaktiv und versendet diese Bestaetigungs-E-Mail.

• Interner Vorlagenname: newsletter_doubleoptin.
• Ausloesende Einstellung: nl_doubleoptin aktiviert den Bestaetigungsversand.
• Newsletter-Anzeige: nl_show steuert, ob die Newsletter-Anmeldung im Shop erreichbar ist.
• Empfaengerstatus: Bei Double-Opt-In startet der Empfaenger mit aktiv=0 und wird erst nach Klick auf den Link aktiv. Ohne Double-Opt-In wird direkt aktiv=1 gespeichert und diese Vorlage wird nicht versendet.
• Empfaenger: Die Nachricht geht an die E-Mail-Adresse aus dem Newsletterformular.

Anmeldung und Validierung

Das Newsletterformular verarbeitet Vorname, Nachname, E-Mail-Adresse und optional Captcha. Sprache und Shop werden aus der aktuellen Shop-Sitzung gesetzt.

• vname und nname sind optionale Namensfelder. Die Werte werden auf 64 Zeichen gekuerzt.
• email ist das Pflichtfeld fuer die Empfaengeradresse und wird auf ein gueltiges E-Mail-Format geprueft.
• captcha wird geprueft, wenn reCAPTCHA im Shop aktiv ist und das Theme keine Legacy-Ausnahme nutzt.
• Bereits aktive Empfaenger mit gleicher E-Mail-Adresse im gleichen Shop werden abgewiesen.
• Nach erfolgreicher Speicherung wird str aus der Empfaenger-ID erzeugt und der Newsletter-Recipient-Webhook fuer create gesendet.

Double-Opt-In-Link

Der Link wird fuer den jeweiligen Shop erzeugt und mit einer Pruefsumme versehen. Beim Aufruf muessen Empfaenger-ID und Pruefsumme zusammenpassen, sonst wird der Link abgelehnt.

• DOUBLEOPTIN_LINK ist der komplette Bestaetigungslink.
• Der Link enthaelt die Newsletter-Bestaetigungsaktion, die Empfaenger-ID und eine Signatur.
• Eine zeitliche Ablaufpruefung ist in dieser Linkart nicht vorhanden.
• Bei erfolgreicher Pruefung setzt der Shop aktiv=1, speichert datum_doptin und leitet auf die Erfolgsmeldung der Newsletterseite weiter.
• Wenn die Empfaenger-ID nicht gefunden wird, leitet der Shop auf die Fehlermeldung der Newsletterseite weiter.

Versandlogik

Die Vorlage wird anhand von Sprache und Shop des Newsletterempfaengers geladen. Betreff, HTML-Inhalt und Text-Alternative werden mit Empfaenger-, Link- und Shopvariablen gerendert und danach ueber den Shop-Mailer versendet.

• subject wird als Betreff der Bestaetigungs-E-Mail gerendert.
• value_html wird als HTML-Inhalt verwendet.
• value wird als Text-Alternative verwendet; HTML-Zeilenumbrueche werden vor dem Versand in Textumbrueche umgewandelt.
• Individuelle Absenderdaten, Antwortadresse und optionale BCC-Adressen der Vorlage werden vor dem Versand auf die E-Mail angewendet.
• Bei aktiven E-Mail-Kopien werden BCC-Adressen vor dem Versand geleert und der gesendete MIME-Inhalt wird als Systemmail gespeichert.
• Mailfehler setzen nur den Rueckgabestatus des Versands auf Fehler; die Vorlage fuehrt keinen eigenen Versandstatus.

Bearbeitbare Felder der Vorlage

Die Vorlage nutzt die Standardfelder der E-Mail-Vorlagenverwaltung. Entscheidend ist, dass die Bestaetigung in HTML und Text eindeutig moeglich ist.

• subject: Betreff der Double-Opt-In-Mail.
• value_html: HTML-Version der Nachricht. Die Variable {DOUBLEOPTIN_LINK} sollte als klarer Bestaetigungslink eingebunden sein.
• value: Textversion der Nachricht. Die gleiche Linkvariable muss auch hier enthalten sein.
• sender_name: Optionaler Absendername fuer diese Vorlage.
• sender_email: Optionale Absenderadresse fuer diese Vorlage.
• replay_to: Optionale Antwortadresse der Vorlage. Der Backend-Feldname lautet replay_to.
• bcc_emails: Optionale BCC-Adressen; mehrere Adressen werden mit Semikolon getrennt.

Verfuegbare Variablen

Neben dem Double-Opt-In-Link stehen Empfaenger- und Shopvariablen bereit. Damit kann die E-Mail personalisiert und dem richtigen Shop zugeordnet werden.

Shopvariablen

Sicher pruefen

1. Aktiviere nl_show und nl_doubleoptin.
2. Melde eine neue E-Mail-Adresse ueber das Newsletterformular an.
3. Pruefe, ob der Empfaenger vor dem Klick mit aktiv=0 gespeichert ist.
4. Kontrolliere, ob HTML- und Textversion {DOUBLEOPTIN_LINK} enthalten.
5. Klicke den Bestaetigungslink und pruefe, ob danach aktiv=1 und datum_doptin gesetzt sind.
6. Teste eine bereits aktive E-Mail-Adresse im gleichen Shop, damit die Duplikatmeldung sichtbar wird.