English Version

Zurück zur Übersicht

Newsletter Management: Konfiguration

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Alle Einstellungen, die den Betrieb im Shop betreffen, pflegst du im Admin und pro Channel (im Admin heißt er „Kanal“). Nur die Farben der Buttons in den Mails liegen in einer Konfigurationsdatei. Diese Seite beschreibt die Einstellungen, die Newsletter-Kategorien, die Admin-Listen und den CSV-Export der Abonnenten.

Überblick: Wo finde ich was?

Das Plugin hat genau einen Eintrag in der Admin-Seitenleiste: MMKreativ Plugins → Newsletterverwaltung (englisch „Newsletter management“). Der Eintrag öffnet die Liste der Newsletter-Einstellungen. Alles andere erreichst du über Buttons in der Titelleiste dieser Seite und kommst über einen Button in der Titelleiste der jeweiligen Seite wieder zurück.

Die Kategorien stehen außerdem direkt unter der Einstellungsliste, samt Button zum Anlegen. Ohne Kategorie zeigt das Anmeldeformular keine Auswahl.

Solange für einen Channel keine Einstellungen angelegt sind oder „Newsletter aktiv“ aus ist, verhält sich dieser Channel, als wäre das Plugin nicht installiert: Die Seite /newsletter liefert 404, das Footer-Formular fehlt, und die Newsletter-Checkbox von Sylius wird nicht angefasst. Abmelde- und Verwaltungslinks bereits versendeter Mails funktionieren weiter.

Einstellungen pro Channel

Die Einstellungen sind keine Bundle-Konfiguration, sondern Datensätze in der Datenbank. Pro Channel gibt es höchstens einen Datensatz. Lege ihn mit „Erstellen“ in der Liste der Newsletter-Einstellungen an und wähle dort den Channel.

Wann die beiden Löschbefehle laufen müssen und wie du sie als Cronjob einrichtest, steht auf der Seite Installation und Betrieb. Die Aufbewahrungsfristen wirken erst, wenn die Befehle regelmäßig laufen.

Absender

Das Plugin kennt zwei Mailwege, die beide den Absender des Channels verwenden:

• Bestätigungs-, Willkommens- und „Bereits angemeldet“-Mail laufen über den Mailer von Sylius. Der Absendername ist die Einstellung „Absendername“, sonst der Channel-Name. Die Absenderadresse ist die Einstellung „Absender-E-Mail“, sonst die Kontakt-E-Mail des Channels, zuletzt der Standard-Absender aus sylius_mailer.
• Newsletter laufen über den Symfony Mailer. Absendername ist „Absendername“, sonst der Channel-Name. Die Absenderadresse ist „Absender-E-Mail“, sonst die Kontakt-E-Mail des Channels. Fehlt beides, lässt sich der Newsletter weder senden noch als Test senden, und der Admin weist darauf hin.

Link zur Datenschutzerklärung

Die Einwilligungs-Checkbox des Anmeldeformulars verlinkt auf die Datenschutzerklärung, sobald „Seite der Datenschutzerklärung“ gesetzt ist. Der Link öffnet in einem neuen Tab, damit ein halb ausgefülltes Formular erhalten bleibt. Drei Schreibweisen sind erlaubt:

Ein Routenname, den es nicht gibt (umbenannt, Tippfehler) oder der weitere Parameter braucht, ergibt keinen Link. Die Anmeldeseite funktioniert trotzdem, der Einwilligungstext erscheint dann ohne Link. Eine Eingabe in einer anderen Form lehnt das Formular beim Speichern mit einer Fehlermeldung ab.

Eigener Mailer-Transport

Mit „Mailer-Transport für Newsletter“ trennst du Newsletter vom Versand der Shop-Mails, zum Beispiel über einen eigenen Versanddienstleister. Trage den Namen eines Transports aus framework.mailer.transports ein. Das Plugin setzt beim Versand jedes Newsletters den Header X-Transport, den Symfony Mailer auswertet und vor dem Versand entfernt.

# config/packages/mailer.yaml
framework:
    mailer:
        transports:
            main: '%env(MAILER_DSN)%'
            newsletter: '%env(MAILER_NEWSLETTER_DSN)%'

Trage dann im Admin bei „Mailer-Transport für Newsletter“ den Wert newsletter ein. Ohne Eintrag nutzt der Newsletter den Standard-Transport.

Der Transport gilt nur für Newsletter. Bestätigungs-, Willkommens- und „Bereits angemeldet“-Mail laufen weiter über den Standard-Transport des Shops.

Konfigurationsdatei: Farben der Mail-Buttons

Der Button in den Mails des Plugins (Bestätigen, Anmeldung verwalten) verwendet standardmäßig ein Türkis. Passt das nicht zu deinem Theme, setzt du die Farben in einer Konfigurationsdatei. Das ist die einzige Bundle-Konfiguration des Plugins.

# config/packages/mmd_sylius_newsletter_management.yaml
mmd_sylius_newsletter_management:
    email:
        button_color: '#1663CC'
        button_text_color: '#ffffff'

Eine ungültige Farbe bricht den Container-Aufbau mit der Meldung Expected a hex color such as "#1663CC". ab. Das Plugin liest keine eigenen Umgebungsvariablen.

Newsletter-Kategorien

Mit Kategorien (zum Beispiel „Neue Produkte“ oder „Anleitungen“) können sich Abonnenten für Themen entscheiden. Du pflegst sie unter Kategorien oder direkt unter der Einstellungsliste.

So wirken die Kategorien:

• Das Anmeldeformular und die Seite zur Verwaltung der Anmeldung bieten nur aktive Kategorien des eigenen Channels an. Gibt es keine, erscheint keine Auswahl, und alle Abonnenten bekommen den allgemeinen Newsletter.
• Wählt ein Abonnent keine Kategorie, bekommt er alles. Beim Versand eines Newsletters, dem du Kategorien zugewiesen hast, erhalten ihn Abonnenten mit mindestens einer passenden Kategorie und Abonnenten ohne Kategorie. Ein Newsletter ohne Kategorien geht an alle bestätigten Abonnenten des Channels.
• Eine Kategorie, die für andere Channels beschränkt ist, lässt sich nicht wählen, auch nicht mit einer manipulierten Anfrage.

Admin-Listen

Die Detailseite eines Abonnenten zeigt unter anderem Quelle (Shop-Formular, API, Registrierung oder Admin), Sprache, Zeitpunkt und IP-Adresse von Anmeldung und Bestätigung sowie den Zeitpunkt der Abmeldung als Nachweis der Einwilligung. Die Liste der Newsletter beschreibt die Seite Newsletter schreiben und versenden.

CSV-Export der Abonnenten

In der Titelleiste der Abonnentenliste gibt es zwei Buttons: Bestätigte exportieren (CSV) und Alle exportieren (CSV). Die Datei heißt newsletter-subscribers-JJJJ-MM-TT.csv. Sie ist UTF-8 mit BOM kodiert, damit Excel Umlaute richtig anzeigt, und verwendet ; als Trennzeichen.

Der Export lässt sich über Parameter an der URL einschränken: /admin/newsletter-subscriptions/export?status=confirmed&channel=de_shop&category=neuheiten. status akzeptiert pending, confirmed und unsubscribed (jeder andere Wert ergibt Fehler 400), channel den Code eines Channels, category den Code einer Kategorie. Der Pfadanteil admin ist der konfigurierte Admin-Pfad deines Shops. Zellen, die mit =, +, - oder @ beginnen, bekommen ein vorangestelltes Hochkomma, damit Tabellenkalkulationen sie nicht als Formel ausführen.

Praxis-Beispiele

Deutscher Shop mit Double-Opt-in

Ein Shop mit einem Channel de_shop, der den Newsletter datenschutzkonform betreibt:

Legt der Shop den Link zur Datenschutzerklärung stattdessen als Route an (zum Beispiel shop_legal_datenschutz), trägst du den Routennamen ein, und die Sprache wird automatisch berücksichtigt.

Mehrere Channels mit getrennten Absendern

Ein Shop betreibt de_shop und en_shop. Lege für jeden Channel eigene Einstellungen an, weil Absender, Datenschutzseite und Transport pro Channel gelten:

Legst du die Kategorie „Neue Produkte“ ohne Channel-Auswahl an, erscheint sie in beiden Channels. Wählst du bei der Kategorie „Nur für Deutschland“ nur de_shop, bietet sie nur dieser Channel an. Ein Abonnent gehört immer zu genau einem Channel; dieselbe E-Mail-Adresse kann in beiden Channels separat angemeldet sein.

Personenbezogenes Tracking mit Einwilligung

Du willst wissen, wer deinen Newsletter öffnet und klickt, aber nur mit Einwilligung:

Im Anmeldeformular erscheint dann zusätzlich eine eigene, freiwillige Checkbox mit diesem Text, getrennt von der Einwilligung zum Newsletter. Der Text wird bei jeder Einwilligung mitgespeichert. Wer die Checkbox nicht ankreuzt, bekommt den Newsletter trotzdem, wird aber nur anonym gezählt.

Jedes Tracking musst du in deiner Datenschutzerklärung nennen.