Sidebar Newsletter

Sidebar Newsletter verwalten

Der Sidebar-Block Newsletter zeigt ein kompaktes Anmeldeformular für den Newsletter. Er erscheint nur, wenn die Newsletter-Anmeldung global aktiv ist, und übernimmt Hinweistext, Sprachtexte und Sicherheitsprüfung aus der Newsletter-Konfiguration des Shops.

Wofür der Block da ist

Der Block stellt die Newsletter-Anmeldung direkt in der Sidebar bereit. Er ist kein Versandwerkzeug und keine Empfängerverwaltung, sondern ein Frontend-Einstieg für neue Newsletter-Empfängerinnen und -Empfänger.

  • Der Block zeigt ein Formular mit Vorname, Nachname und E-Mail-Adresse.
  • Die Formularaktion führt zur Newsletter-Anmeldung des Shops.
  • Der Hinweistext kommt aus der globalen Newsletter-Konfiguration.
  • Bei aktivem reCAPTCHA wird die Sicherheitsprüfung an das Formular angebunden.
  • Die tatsächliche Speicherung und Double-Opt-In-Logik erfolgen in der Newsletter-Anmeldung.

Position und Sichtbarkeit

Der Block heißt im Backend Newsletter. In der Grundkonfiguration sind die Standardpositionen deaktiviert; sichtbar wird der Block erst durch eine aktive Platzierung in einer Sidebar-Ansicht.

  • Der Block rendert nur, wenn die globale Einstellung nl_show aktiv ist.
  • Wenn nl_show deaktiviert ist, gibt der Block keine Newsletter-Box aus.
  • Die Überschrift verwendet den Sprachtext für Newsletter.
  • Das aktive Theme bestimmt Layout, Formularbreite und Button-Darstellung.
Wenn der Block in der Sidebar fehlt, zuerst die Sidebar-Position und danach die globale Einstellung nl_show prüfen. Beides muss zur Ausgabe passen.

Formularfelder im Frontend

Das moderne Block-Template zeigt drei Eingabefelder und einen Absende-Button. Die Feldbeschriftungen kommen aus den Sprachtexten.

  • vname: Vorname. Das Feld wird angezeigt und gespeichert, ist in der aktuellen Validierung aber nicht mehr als Pflichtfeld erzwungen.
  • nname: Nachname. Das Feld wird angezeigt und gespeichert, ist in der aktuellen Validierung ebenfalls nicht mehr verpflichtend.
  • email: E-Mail-Adresse. Dieses Feld ist fachlich Pflicht, wird auf ein gültiges Format geprüft und darf für denselben Shop nicht bereits als aktive Newsletter-Adresse vorhanden sein.
  • Absenden: startet die Anmeldung mit den eingegebenen Daten.

Der Block zeigt zusätzlich den Hinweistext aus nl_hinweis. Dadurch können Datenschutz-, Einwilligungs- oder Erwartungshinweise im Formularbereich erscheinen, ohne den Sidebar-Block selbst zu verändern.

Globale Newsletter-Einstellungen

Die wichtigsten Regeln für den Block liegen nicht in der Sidebar-Blockmaske, sondern in den Newsletter-Einstellungen des Shops.

  • nl_show: aktiviert oder deaktiviert die Newsletter-Anmeldung. Diese Einstellung entscheidet auch, ob der Sidebar-Block überhaupt ausgegeben wird.
  • nl_doubleoptin: steuert, ob neue Anmeldungen erst nach Bestätigung aktiv werden. Bei aktivem Double-Opt-In wird ein neuer Empfänger zunächst inaktiv gespeichert und erhält eine Bestätigungsnachricht.
  • nl_appendUnsubscribeLink: betrifft den späteren Newsletter-Versand und sorgt dafür, dass ein Abmeldelink angehängt wird.
  • nl_absenderName und nl_absenderEmail: definieren Absenderdaten für Newsletter-Funktionen und Bestätigungsnachrichten.
  • nl_hinweis: liefert den Hinweistext, der im Sidebarformular ausgegeben wird.
Der Sidebar-Block hat keine eigene Option, um Double-Opt-In, Abmeldelink oder Absenderdaten zu überschreiben. Diese Werte gelten zentral für die Newsletter-Funktion.

Sicherheits- und Validierungslogik

Bei einer Anmeldung bereinigt die Newsletter-Verarbeitung die übergebenen Formulardaten, erstellt einen Newsletter-Empfänger und prüft die Eingaben vor dem Speichern.

  • Die E-Mail-Adresse darf nicht leer sein.
  • Die E-Mail-Adresse muss ein gültiges Format haben.
  • Eine bereits aktive Adresse desselben Shops wird abgelehnt.
  • Bei aktivem reCAPTCHA muss die Prüfung erfolgreich sein.
  • Vorname und Nachname werden gekürzt gespeichert, sind aber nicht mehr als Pflichtfelder aktiv.
  • Sprache und Shop-Zuordnung werden aus dem aktuellen Frontend-Kontext gesetzt.

Nach erfolgreicher Validierung wird der Empfänger gespeichert. Bei aktivem Double-Opt-In bleibt der Datensatz zunächst wartend und wird erst nach Bestätigung aktiv.

Abgrenzung zu Tabellen und Optionen

Der Newsletter-Sidebarblock besitzt keine Backend-Tabelle und keine Optionsspalte. Die sichtbare Funktion ist ein Frontendformular; die Verwaltung von Empfängern, Vorlagen und Versand liegt in den Newsletter-Bereichen des Backends.

  • Keine Such- oder Filterleiste in der Sidebar-Blockmaske.
  • Keine konfigurierbaren Tabellenspalten.
  • Keine Zeilenaktionen wie Bearbeiten, Kopieren oder Löschen innerhalb dieses Blocks.
  • Keine eigene Blockmaske für Pflichtfelder oder Versandregeln.

Sichere Prüfung im Frontend

  1. Newsletter-Anmeldung global aktivieren.
  2. Block in der gewünschten Sidebar-Ansicht platzieren.
  3. Frontend ohne bestehende Anmeldung öffnen und prüfen, ob Vorname, Nachname, E-Mail, Hinweistext und Button sichtbar sind.
  4. Eine ungültige E-Mail testen und die Fehlermeldung prüfen.
  5. Eine bereits aktive E-Mail testen und die Dublettenprüfung kontrollieren.
  6. Bei aktivem reCAPTCHA die Sicherheitsprüfung im Formularfluss mitprüfen.
  7. Bei aktivem Double-Opt-In kontrollieren, ob die Bestätigungsmail verschickt und der Empfänger erst nach Bestätigung aktiv wird.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.