Newsletter

    Technisch gesehen ist ein Bakehouse-Newsletter eine normale Unterseite mit einem tabellenbasierten Template. Alle Newsletter relevanten Funktionen kommen automatisch dazu, indem die Seite als Unterseite der Newsletter-Rootpage erkannt wird. Die Funktionen zeigen sich in der rechten Hauptbearbeitungsleiste, in der veränderten Menüleiste rechts oben, sowie in der veränderten Elementauswahl.

    Um das Newsletter-Modul verwenden zu können, muss die Erweiterung im Bakehouse installiert sein. Bitte kontaktieren Sie uns: support@bakehouse.at

    Installation

    Bei der Installation des Bakehouse-Newsletter-Systems werden dem Integrator einige Schritte automatisiert abgenommen:

    • Die notwendige Newsletter-Root-Seite wird angelegt und als solche definiert. Auch die nötigen TypoScript-Konfigurationen für diese und alle späteren Unterseiten werden der Root-Seite zugewiesen. 
    • Ein vordefiniertes Template Index.html wird lokal unter fileadmin/templates/ext/bh_newsletter/ abgelegt und standardmäßig als Haupttemplate verwendet.
    • tt_address dient als Speichertabelle von Adressen und wird ggf. mitinstalliert.
    • Plugins für An- und Abmeldung werden verfügbar gemacht und können über das TYPO3-Element eingebunden werden. In den Plugin-Einstellungen können für das An- und Abmelden Seiten hinterlegt werden. Dann wird der Benutzer nach erfolgreicher Aktion dorthin weitergeleitet. 
    • Die Standard-Versandgruppe "Website" wird erstellt und erhält automatisch jede Adresse, welche über das Front-End der Webseite angemeldet wurde. Die Gruppe hat einen Sonderstatus und kann weder gelöscht noch mit Import-Adressen vermischt werden. Dadurch wird sichergestellt, dass die Gruppe immer genau jene Adressen repräsentiert, die über die Webseite dazugekommen sind.

    ViewHelper

    Es gibt spezielle ViewHelper für Newsletter, um Spalten und Hintergrundbilder zu rechnen. 

    Invalide-Emails

    Ungültige E-Mail-Adressen können sich über einen CSV-Import einschleichen. Dies ist gewollt, um Adressen wie z. B. "max[a]mustermann.com" nicht gänzlich zu verwerfen.

    Um Versandgruppen sauber zu halten, werden direkt nach einem CSV-Import alle gefundenen ungültigen E-Mail-Adressen aufgelistet und können direkt korrigiert oder gelöscht werden.

    Will man nachträglich invalide Mails einer Versandgruppe bearbeiten, kann man diese über die Suche mit dem Schlüsselwort "invalid" finden.

    Beim Versand werden ungültige E-Mail-Adressen ignoriert und übersprungen.

    Abgemeldete Empfänger

    Um Empfänger, die sich abgemeldet haben, in einer Liste anzuzeigen, kann man nach dem Schlüsselwort "dropouts" suchen.

    Merge-CSS mit HTML 

    Es gibt die Möglichkeit HTML und CSS beim verschicken zu mergen. Das erhöht die Darstellungsqualität bei schlechteren Mail-Clients. Dabei werden alle CSS-Dateien ausgelesen. CSS, das direkt in der HTML-Datei angegeben ist, wird nicht berücksichtigt und normal ausgegeben. 

    Achtung: CSS-Dateien von externen Quellen werden nicht berücksichtigt!

    Typoscript
    plugin.tx_bhnewsletter.settings.mergeCSSandHTML = 1

    Beim Versand werden an alle Links automatisch Tracking Parameter angehängt. Diese können in den Newsletter-Einstellungen definiert werden. 

    Soll ein Link nicht getrackt werden, kann das über tracking="exclude" direkt am <a>-Tag gelöst werden.

    Wenn bei den konfigurierten Tracking Parametern der letzte Value leer bleibt, wird dort automatisch der Betreff des Newsletters zum Tracking angehängt. Alternativ kann auch der Platzhalter ###subject### verwendet werden.
    ?google=###subject###&pk_campaign=newsletter&pk_kwd= ergibt zum Beispiel
    ?google=Headline&pk_campaign=newsletter&pk_kwd=Headline

    Test-Aussendung und Download

    Das Bakehouse kann auch die Browserausgabe des Newsletters wie beim Versand rendern. In diesem Fall werden Parameter wie etwa merge CSS berücksichtigt. 
    Der fertig kompilierte Code des Newsletters kann über den Download-Button in der Box "Testversand und Download" heruntergeladen werden.

    Newsletter Formulare & Spam Schutz

    Seit dem Oktober 2020 können die Newsletter Formulare nun auch über einen extra dafür angefertigten ViewHelper gebaut werden. Die Vorteile:

    • Einfacher zum Integrieren: Es braucht kein Plugin dafür und man kann die Formulare ohne Content Bereich auch im Page Template statisch einbauen.
    • Vielseitig einsetzbar: Egal ob Page Template, Element oder Plugin, das Formular wirkt eigenständig.
    • Integrierter Spam-Schutz:  Der ViewHelper kümmert sich automatisch um den Spam-Schutz.
    • Abwärts kompatibel: Bei älteren Projekten kann man es auch direkt in den Plugins integrieren (templates/ext/bh_newsletter/Form/Templates) und es ist in kurzer Zeit für den Spam Schutz gerüstet.

    Formular-Felder

    Folgende Felder können für die Newsletter-Anmeldung verwendet werden:

    • email - E-Mail-Adresse
    • name - Vorname und Nachname
    • firstName - Vorname
    • lastName - Nachname
    Hinweis

    Newsletter-Anmeldung beim Anfrage-Formular

    Auch bei Anfrage-Formularen kann eine Newsletter-Anmeldung (z. B. durch eine Checkbox) durchgeführt werden. Details zur Implementierung sind bei der Formular-Erweiterung beschrieben. 

    Beispiel

    Früher sah die HTML-Datei folgendermaßen aus:

    HTML
    <div class="bhnl-register-form"> <f:flashMessages /> <f:form action="register" name="data" noCache="1" noCacheHash="true" fieldNamePrefix="tx_bhnewsletter_newsletterregister[data]" > <div class="bhnl-form-field"> <f:form.textfield name="name" placeholder="{f:translate(key: 'form-field-name')}" /> </div> <div class="bhnl-form-field"> <f:form.textfield name="email" required="true" type="email" placeholder="{f:translate(key: 'form-field-email')}*" /> </div> <f:form.submit value="{f:translate(key: 'form-field-subscribe')}" /> </f:form> </div>

    Die Datei musste dann unter templates/ext/bh_newsletter/Form/ abgelegt werden und für die Einbettung benötigte man das Newsletter-Plugin inklusive Content Bereich.

    Mit dem neuen ViewHelper sieht dasselbe Beispiel so aus:

    HTML
    {namespace newsletter=TYPO3\BhNewsletter\ViewHelpers} <newsletter:form class="bhnl-form" action="register" receiverlists="{settings.receiverlists}" redirect="{settings.thanks}"> <newsletter:flashMessages /> <div class="form__field"> <label class="form__field-label">Name*</label> <f:form.textfield name="name" class="form__field-input" /> </div> <div class="form__field"> <label class="form__field-label">Email*</label> <f:form.textfield name="email" class="form__field-input" required="true" placeholder="Email" /> </div> <div class="form__button form__button--submit"> <f:form.submit value="Anmelden" /> </div> </newsletter:form>

    Die ViewHelper benötigen den newsletter namespace.

    Der newsletter:form-ViewHelper hat zwei Actions (register/unregister) und mit redirect kann eine interne Seite (Page UID) oder auch eine externe URL angegeben werden. Bei erfolgreichem Abschluss wird dann auf die entsprechende Seite weitergeleitet.


    Der Newsletter Flash-Messages-ViewHelper wird benötigt, um die back-end-seitigen Hinweise auszugeben (erfolgreich, fehlgeschlagen, ...).