Logincode

Die E-Mail-Vorlage Logincode sendet den sechsstelligen Code fuer den Kundenkonto-Login, wenn die Zwei-Faktor-Anmeldung im Shop aktiv ist.

Ausloeser und Zweck

Die Vorlage gehoert zum Login in ein Kundenkonto. Nach erfolgreicher Pruefung von E-Mail-Adresse und Passwort erzeugt der Shop einen sechsstelligen Code und schickt ihn an die im Kundenkonto gespeicherte E-Mail-Adresse.

• Interner Vorlagenname: logincode.
• Ausloesende Einstellung: login_2fa am Shop. Ohne diese Einstellung wird der Kundenlogin nach der Passwortpruefung direkt abgeschlossen.
• Voraussetzungen: Das Kundenkonto muss existieren, das Passwort muss stimmen und das Konto muss aktiv sein. Erst danach wird der Code erzeugt.
• Code-Erzeugung: Der Code wird als Zufallszahl zwischen 100000 und 999999 erzeugt und im laufenden Loginzustand gespeichert.
• Empfaenger: Die Nachricht geht an die gespeicherte E-Mail-Adresse des Kundenkontos.
• Abgrenzung: Diese Vorlage ist fuer Kundenkonto-Logins vorgesehen. Login-Codes fuer den Administrationsbereich verwenden eine eigene Versandlogik und nicht diese E-Mail-Vorlage.

Versandlogik

Beim Versand laedt der Shop die Vorlage logincode in der Kundensprache und fuer den aktuellen Multishop. Wenn dort keine passende Vorlage existiert, kann die Standardvorlage aus Multishop 1 verwendet werden. Der Mailer und die Shopvariablen stammen aus dem Multishop des Kundenkontos.

• subject wird als Betreff gerendert und darf Variablen enthalten.
• value_html wird als HTML-Inhalt gerendert.
• value wird als Text-Alternative gerendert; HTML-Zeilenumbrueche werden in Textumbrueche umgewandelt und Tags entfernt.
• LOGINCODE wird direkt vor dem Versand mit dem aktuell erzeugten Code befuellt.
• Kundendaten aus dem Kundenkonto und Shopdaten aus dem Multishop stehen zusaetzlich als Templatevariablen bereit.
• Individuelle Absenderdaten, Antwortadresse und optionale BCC-Adressen aus der Vorlage werden vor dem Versand auf die Mail angewendet.
• Wenn E-Mail-Kopien im Shop aktiv sind, werden BCC-Adressen vor dem Versand geleert und der gesendete MIME-Inhalt wird als Systemmail mit Kundenbezug gespeichert.
• Mailfehler erzeugen eine Systemmeldung; fuer Logincode-Mails gibt es keinen eigenen Versandstatus in der Vorlage.

Bearbeitbare Felder der Vorlage

Die Vorlage nutzt die Standardfelder der E-Mail-Vorlagenverwaltung. Fuer den Logincode sind vor allem Inhalt, Betreff und Absenderdaten relevant.

• subject: Betreff der E-Mail, zum Beispiel ein kurzer Hinweis auf den Login-Code.
• value_html: HTML-Version der Nachricht. Hier muss {LOGINCODE} gut sichtbar und eindeutig platziert sein.
• value: Textversion der Nachricht. Der Code muss hier ebenfalls vorhanden sein, damit Mailprogramme ohne HTML den Login abschliessen koennen.
• 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.

Code-Eingabe im Login

Nach dem Versand zeigt der Shop das Logincode-Formular statt des normalen Loginabschlusses. Der eingegebene Code wird gegen den gespeicherten Code der laufenden Anmeldung geprueft.

• Feld: Im Frontend wird der eingegebene Wert als code verarbeitet.
• Erfolgsfall: Bei korrektem Code wird der Kundenlogin abgeschlossen, Kundengruppe und Kundendaten werden geladen und passende Warenkorbeintraege werden der Kundensession zugeordnet.
• Fehlerfall: Ein leerer oder falscher Code zeigt die Login-Fehlermeldung fuer ungueltige Logincodes und laesst das Codeformular sichtbar.
• Redirect: Nach erfolgreicher Codepruefung wird der vorherige Redirect, der Checkout-Schritt oder die Kundenstartseite verwendet.

Verfuegbare Variablen

Die wichtigste Variable ist {LOGINCODE}. Zusaetzlich stehen Kunden- und Shopvariablen bereit, damit Anrede, Kundennummer, Shopname, Logo und Signatur passend eingesetzt werden koennen.

Shopvariablen

Kundenvariablen

Sicher pruefen

1. Aktiviere login_2fa fuer den betroffenen Shop.
2. Melde dich mit einem aktiven Kundenkonto an und warte auf die Logincode-E-Mail.
3. Pruefe, ob Betreff, HTML-Version und Textversion den gleichen Code enthalten.
4. Gib den Code im Loginformular ein und kontrolliere, ob der Login danach abgeschlossen wird.
5. Teste einen falschen Code, damit die Fehlermeldung und das sichtbare Codeformular geprueft sind.
6. Teste bei Aenderungen am Absender, ob Zustellung, Antwortadresse und optionale Kopien wie erwartet funktionieren.