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
Link Tracking
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, ...).