Mailchimp für TYPO3

Die mailchimp-Extension bringt Anmeldungen samt Interessengruppen direkt in Mailchimp-Listen

Wie koning_mailchimp_signup ist die mailchimp-Extension ein Anmeldeformular: Besucher tragen sich auf der Website in eine bestimmte Mailchimp-Liste ein. Sie reicht aber weiter als die ältere Extension, die bei TYPO3 8 endet: Redakteure wählen im Inhaltselement die Liste und auf Wunsch eine Interessengruppe, das Formular ist ein frei anpassbares Fluid-Template, und seit Version 3.0.0 bedient eine TYPO3-Installation mehrere Mailchimp-Konten. Einen Abgleich ganzer Listen, Kampagnenzahlen im Backend oder Newsletter-Vorlagen aus TYPO3-Inhalten bietet die Extension nicht; jede Anmeldung geht direkt an die Mailchimp-API, Sync-Jobs braucht es dafür nicht.

Der DSGVO-Aspekt bleibt trotzdem zentral: Mit jeder Anmeldung gehen E-Mail-Adresse, Vor- und Nachname, die gewählten Interessengruppen und auf Wunsch bis zu zehn weitere Felder an Mailchimp. Ohne Auftragsverarbeitungsvertrag mit Mailchimp und dokumentierten US-Transfer-Mechanismus ist das datenschutzrechtlich nicht zulässig.

Typische Einsatzszenarien sind Newsletter-Anmeldung, Themenwahl und mehrere Marken

Das Hauptszenario ist die Newsletter-Anmeldung auf der Website. Besucher tragen E-Mail-Adresse und Namen ein, die Extension legt sie in der gewählten Liste mit dem Status „pending“ an, und Mailchimp verschickt die Bestätigungsmail für das Double-Opt-In. Erst mit dem Klick auf den Bestätigungslink ist die Adresse aktiv. Liste, Abmeldungen und Bounces verwaltet Mailchimp; eigene Tabellen legt die Extension in TYPO3 nicht an.

Zweites Szenario: Themenwahl über Interessengruppen. Wer mehrere Newsletter oder Themen anbietet, legt in Mailchimp eine Interessengruppe an, und das Formular zeigt die Themen als Checkboxen, Radiobuttons oder Auswahlliste, je nach Typ der Gruppe. Die Anmeldung landet mit den gewählten Themen in der Liste, sodass Marketing in Mailchimp gezielt an einzelne Gruppen versenden kann.

Drittes Szenario: mehrere Marken oder Länder in einer TYPO3-Installation. Seit Version 3.0.0 hinterlegt man mehrere API-Keys mit Bezeichnung, und Redakteure wählen im Inhaltselement, an welches Mailchimp-Konto und welche Liste ein Formular geht. Im Seitenmodul zeigt die Extension zu jedem Formular Konto, Liste, Interessengruppe und die aktuelle Zahl der Abonnenten. Öffnungs- und Klickraten sieht dagegen nur, wer Zugang zum Mailchimp-Dashboard hat.

Technische Architektur ruft die Mailchimp-API v3 direkt beim Absenden auf

Die Extension kommuniziert über die Mailchimp Marketing API v3, angesprochen über eine mitgelieferte PHP-Bibliothek. Die Authentifizierung erfolgt über einen API-Key, der im TYPO3-Extension-Manager hinterlegt wird. Einen Scheduler-Task gibt es nicht: Jede Anmeldung geht beim Absenden des Formulars direkt an Mailchimp.

Beim Absenden legt die Extension das Mitglied in der gewählten Liste an, mit Double-Opt-In im Status „pending“, sonst direkt als „subscribed“. Steht die Adresse schon in der Liste, ist aber nicht angemeldet, aktualisiert sie den Eintrag; die Mitglieds-ID ist dabei der MD5-Hash der E-Mail-Adresse. Ist die Adresse bereits angemeldet, zeigt das Formular einen Hinweis.

Das Formular ist ein Fluid-Template, das sich im eigenen Sitepackage überschreiben lässt. Mit der Extension typoscript_rendering sendet es per Ajax, ohne die Seite neu zu laden. Eine E-Mail-Adresse lässt sich per GET- oder POST-Parameter vorbelegen, etwa wenn ein anderes Formular auf die Anmeldung verweist.

Weitere Felder bindet ein Entwickler über einen Hook an: Das Formular kennt bis zu zehn zusätzliche Felder, deren Zuordnung zu den Feldern in Mailchimp der Hook festlegt. Ein eigenes Backend-Modul oder Kampagnen-Kennzahlen gibt es in der Extension nicht.

Häufige Probleme sind Pflichtfelder, bestehende Adressen und abgeschaltetes Double-Opt-In

Problem eins: Pflichtfelder. Markiert man in Mailchimp Felder als Pflicht, kann die Extension das laut Dokumentation serverseitig nicht prüfen; fehlt ein solches Feld, meldet das Formular nur einen allgemeinen Fehler. Die Lösung: dieselben Felder im Fluid-Template als Pflichtfelder kennzeichnen und vor dem Absenden prüfen.

Problem zwei: Adressen, die schon in der Liste stehen. Ist eine Adresse bereits angemeldet, lehnt Mailchimp die zweite Anmeldung ab, und das Formular meldet, dass die Adresse schon registriert ist. Früher abgemeldete Adressen trägt die Extension dagegen neu ein. Die Lösung: die Meldung über die Sprachdatei verständlich formulieren, damit niemand glaubt, die Anmeldung sei gescheitert.

Problem drei: Double-Opt-In abschalten. Die Extension fordert standardmäßig die Bestätigung per E-Mail an. Nur wer das Double-Opt-In in Mailchimp abgeschaltet hat, schaltet es mit der Einstellung skipDoubleOptIn auch in der Extension ab; die Dokumentation rät, es immer zu nutzen. In der EU ist es zudem der übliche Weg, die Einwilligung nach Art. 7 Abs. 1 DSGVO nachzuweisen.

Ein viertes Problem betrifft Server hinter einem Proxy. Die Extension erreicht die Mailchimp-API nur, wenn Proxy und Port in der Extension-Konfiguration eingetragen sind; dazu gibt es eine Option, die Verbindung auf IPv4 zu zwingen. Fehlen diese Einstellungen, erreicht keine Anmeldung Mailchimp, und TYPO3 hält die Adressen auch nicht vor.

Die Extension endet bei TYPO3 v10, für aktuelle Versionen empfiehlt sich eine direkte API-Integration

Die mailchimp-Extension im TER ist zuletzt im Januar 2021 erschienen (Version 3.2.0) und unterstützt TYPO3 v9 und v10; für neuere TYPO3-Versionen gibt es kein Release. Da die Mailchimp-API v3 stabil und gut dokumentiert ist, empfiehlt Gosign für aktuelle TYPO3-Projekte eine direkte API-Integration ohne Extension-Abhängigkeit. Eine Custom-Service-Klasse in einem eigenen TYPO3-Package, die die Mailchimp-API direkt anspricht, ist wartungsärmer als eine Community-Extension und lässt sich exakt auf die Projektanforderungen zuschneiden. Sollen Newsletter-Inhalte aus TYPO3 kommen, gehört das ebenfalls in diese Integration; Gosign pflegt dafür ein E-Mail-Template-Set, das die häufigsten Content-Elemente E-Mail-kompatibel rendert.

Unternehmen, die langfristig bei Mailchimp bleiben wollen, sollten zusätzlich die Mailchimp-Webhook-Funktion evaluieren: Statt regelmäßig Daten abzufragen, sendet Mailchimp Events (Anmeldung, Abmeldung, Bounce) aktiv an einen TYPO3-Endpoint. Das reduziert die Sync-Latenz von Minuten auf Sekunden und eliminiert die Belastung durch periodische API-Abfragen.