Erstellen von Vorlagen für Kampagnen

Owned by Paul Maul
Last updated: März 11, 2024 by Sebastian Schulz
3 min read

Brandbox bietet die Möglichkeit, personalisierte E-Mails an eine Vielzahl an Empfängern zu versenden. Hierzu wird von Kampagnen und E-Mail-Templates Gebrauch gemacht. In einem E-Mail-Template wird der gewünschte Inhalt mit Platzhaltern definiert. Die Platzhalter werden beim Ausführen der Kampagne durch die entsprechenden Werte der E-Mail-Empfänger ersetzt.

Aufbau der Plugins

Um Templates zu erstellen und zu bearbeiten weden zwei Plugins benötigt: "campaign/template" & "campaign/uiTemplate".
Die Entitäten und Konfigurationen werden von "campaign/template" bereitgestellt. Dieses Plugin verwaltet zudem die Datenbankoperationen bezüglich der E-Mail-Templates.
Der Editor für E-Mail-Templates wird mit "campaign/uiTemplate" ausgeliefert.

Verwendung

Um den E-Mail-Template Editor nutzen zu können, wird zunächst ein E-Mail-Template benötigt. Dieses kann wie ein regulärer Datensatz in der Tabelle "E-Mail-Templates" erstellt werden. Mehr Informationen zur Konfiguration gibt es MailTemplateLink. Wurde der Datensatz erstellt, kann man das Template über einen Klick auf den ersten Kontextbutton im Editor öffnen.

Der Editor sieht folgendermaßen aus:

Der Editor ist in mehrere Bereiche unterteilt:

  1. Dieser Bereich zeigt die Optionen für die aktuell gewählte Aktion. Wird eine Ansicht bearbeitet, werden hier Einstellungsmöglichkeiten dargestellt.

    1. Einstellungen: Einstellungen, die in der entsprechenden View definiert werden. In diesem Beispiel sind es Eingabefelder für die verschiedenen H-Elemente.

    2. Rollen: Den einzelnen Feldern, welche in den Einstellungen konfiguriert werden können, können auch Rollen zugewiesen werden. Somit lässt sich einschränken, wer diese Felder bearbeiten kann.

    3. Feld-Zuordnung: Die Feldzuordnung lässt eine Zuordnung von E-Mail-Empfänger-Feldern auf die Felder der aktuellen Ansicht zu. Bspw. kann so das Feld "H1" auf das Feld "Vorname" eines E-Mail-Empfängers gemappt werden. Beim Versenden der E-Mail in einer Kampagne wird der Vorname des E-Mail-Empfängers in das "H1"-Feld gesetzt.

  2. Hier werden die Ansichten des Templates dargestellt. Durch einen Rechtsklick öffnet sich ein Kontextmenü, in dem verschiedene Optionen gelistet werden (Ansichten anlegen, löschen etc.). Durch einen Linksklick auf eine Ansicht kann diese bearbeitet werden.

  3. In diesem Bereich wird der Inhalt des E-Mail-Templates dargestellt. Diese Oberfläche ist interaktiv. Auch hier können über Mausklicks Templates angelegt, bearbeitet oder gelöscht werden. Durch drag'n'drop kann die Positionierung der Ansichten eingestellt werden.

Hinweis zur Nutzung des Template-Editors im Shop

Ist es gewünscht ein Template durch Anwender im Shop bearbeiten zu lassen, muss in der Konfigurationstabelle für E-Mail-Templates eine Rolle ausgewählt werden, die Anwender im Shop auch besitzen.

Konfiguration eines E-Mail-Templates

Bereich

Beschreibung

Bereich

Beschreibung

mailTemplateName

Name des Templates.

mailTemplateStyleGuide

StyleGuide des Templates. Der StyleGuide gibt das Styling des Haupttemplates vor. Hier werden auch Elemente definiert, die von view-Plugins als Partials aufgerufen werden können.

mailTemplateHtml

HTML des Templates. Hier sollte min. der folgende Feature Call platziert werden: {{{mailSection "main"}}}.