Slide background;

Contao Modulentwicklung

der Opensource-Gedanke lebt.

Contao Modulentwicklung

Im Rahmen unserer Kundenprojekte haben wir in den letzten Jahren eine Vielzahl von Contao-Modulen entweder komplett neu entwickelt oder bestehende Module angepasst. In aller Regel sind diese Module für ganz spezielle Kundenanforderungen konzipiert, so das eine Veröffentlichung im Sinne des Open-Source-Gedankens entweder nicht möglich oder nicht sinnvoll ist.

Wenn es aber zum Projekt passt, dann stellen wir natürlich gerne unsere Entwicklungen als Module zur Verfügung

Newsletter-Synchronisation mit cleverreach.de

Diese Erweiterung ermöglicht eine Synchronisation zwischen dem Contao-Newsletter-System und dem Newsletter-Dienstleister cleverreach.de . Dabei ist zu beachten, dass es sich bei der Synchronisation nur um eine "One-Way"-Synchronisation handelt. Es werden die Datensätze aus Contao (Verteiler, Abonnenten im Verteiler) jeweils zu cleverreach.de synchronisiert. Ein Austausch von Daten von cleverreach.de in das Contao-System ist nicht vorgesehen.

Installation & Voraussetzungen

Für die Installation laden Sie zuerst das aktuelle Repository aus Github herunter. Sie finden diese hier: https://github.com/47gn/contao_cleverreach_sync . Entpacken Sie das Verzeichnis lokal und laden Sie anschließend den kompletten Order 47_cleverreach in Ihre Contao-Installation in den Ordner /system/modules.

Nach erfolgter Installation führen Sie bitte noch folgende Schritte durch:

  • Update Datenbank
  • Interner Cache leeren und ggf. neu aufbauen

Bitte beachten Sie dabei, dass Sie für den Betrieb des Moduls den NameSpaceClassLoader benötigen. Diesen erhalten Sie ebenfalls auf Github unter https://github.com/terminal42/contao-NamespaceClassLoader . 

Das Modul ist für Contao ab der Version 3.4. vorgesehen.

Konfiguration

Nach der erfolgreichen Installation klicken Sie bitte im Backend ihrer Contao-Installation auf "Einstellungen". Dort finden Sie einen neuen Bereich "Synchronisation mit cleverreach.de" . Dort tragen Sie bitte die sogenannte WDSL-URL und den API-Key ein.

Bitte beachten Sie: Um das Modul zu konfigurieren, benötigen Sie einen aktiven Account bei cleverreach.de. Um einen solchen Account zu erstellen, melden Sie sich bitte kostenfrei unter http://www.cleverreach.de/signup an. 

Newsletter-Synchronisation Contao mit cleverreach.de

Nach erfolgter Registrierung bei cleverreach.de melden Sie sich dort im geschützten Bereich an. Dann klicken Sie bitte links in der Navigation auf "Account". Danach erscheint eine horizontale Navigation. Klicken Sie dort auf "Extras > API". Auf dieser Seite finden Sie rechts oben den Button "API-Key erstellen". Klicken SIe darauf und benennen Sie dann einen Verwendungszweck. Sie müssen dort auch auswählen, welche Rechte dieser Key besitzen darf. Zur Synchronisation mit Ihrem Contao-System wählen Sie bitte "Lese- und Schreibrechte".

Nach dem Speichern wird Ihnen gleich der neue API-Key angezeigt. Tragen Sie diesen Key dann wie oben beschrieben in Ihrer Contao-Installation ein.

Einen neuen Verteiler anlegen und synchronisieren

Klicken Sie dazu in Ihrer Contao-Installation im Backend auf "Inhalte > Newsletter". Danach klicken Sie oben rechts auf den Button "Neuer Verteiler". Im folgenden Dialog geben Sie zunächst die für Contao erforderlichen Angaben wie den Titel, optional eine  Weiterleitungsseite sowie möglicherweise Einstellungen für den SMTP-Versand ein.

In diesem Dialog finden Sie ebenfalls Einstellungen für die Synchronisation mit Ihrem Account bei cleverreach.de

Newsletter-Synchronisation Contao mit cleverreach.de

Um diesen neuen Verteiler mit cleverreach.de zu synchroniseren bzw. dort neu anzulegen, aktivieren Sie bitte die Checkbox "Diesen Verteiler mit cleverreach.de synchronisieren". Danach erscheint ein Feld mit der Bezeichnung "Listen-ID". Wichtig: Bitte lassen Sie dieses Feld leer! Die Listen-ID wird nach dem erfolgreichen Anlegen der Gruppe automatisch mit der von cleverreach.de vergebenen Listen-ID befüllt.

Nach dem Klick auf "Speichern" wird der Verteiler sowohl in Ihrem Contao-System als auch auf cleverreach.de angelegt. Sie können jetzt entweder manuell oder per Newsletteranmeldung den Verteiler mit Abonnenten befüllen.

Einen bereits bestehenden Verteiler synchronisieren

Sollten Sie in Ihrer Contao-Installation bereits über angelegte Newsletter-Verteiler mit Abonnenten verfügen, dann können Sie diese auch nachträglich mit ihrem Account bei cleverreach.de synchronisieren. Klicken Sie dazu bitte den entsprechenden Verteiler an und aktivieren wie oben beschrieben die Checkbox "Diesen Verteiler mit cleverreach.de synchronisieren". Klicken Sie anschließend auf "Speichern". Das Modul prüft nun ob der entsprechende Verteiler bereits angelegt ist oder nicht. Sofern der Verteiler noch nicht angelegt ist, wird dies durch das Modul erledigt. 

Danach prüft das Modul ob sich im betreffenden Verteiler bereits aktive Abonnenten befinden. Ist dies der Fall so werden alle als aktiv gekennzeichneten Abonnenten ebenfalls mit cleverreach.de synchronisiert.

Synchronisation über automatisierte Newsletter An- und Abmeldung

Das Contao-System verfügt über Möglichkeiten direkt auf der Webseite ein Anmeldeformular für das Eintragen in einen Newsletter-Verteiler anzuzeigen. Die Anmeldeprozedur wird dabei durch das notwendige Prüfsystem "Double-Opt-In" unterstützt. Dies bedeutet, dass Newsletter-Anmeldungen nur mit ausdrücklicher Zustimmung mittels Verifizierung durch den E-Mail-Inhaber abschließend vorgenommen werden dürfen.

Unser Modul klinkt sich direkt beim abschließenden Aktivieren eines Abonnenten ein und führt dann automatisch eine Synchronisation des Abonnenten mit cleverreach.de durch. Bitte beachten Sie dabei, dass hierfür der entsprechende Verteiler welcher die Abonnenten aufnehmen soll, vorher natürlich über den oben beschriebenen Vorgang mit cleverreach.de synchronisiert werden muss.

Trägt sich ein Abonnent aus einem Verteiler wieder aus, so wird auch das Löschen aus dem Verteiler bei cleverreach.de vorgenommen.

Manuelles Abgleichen von Verteilern und Abonnenten

Sofern notwendig, kann auch ein manueller Abgleich von Abonnenten bzw. von Verteilern mit cleverreach.de vorgenommen werden. 

Sollten Sie aus einem mit cleverreach.de synchronisierten Verteiler manuell einen Abonnenten über das Contao-Backend löschen wollen, so wird dieser auch aus der Liste der Abonnenten in der jeweiligen Gruppe bei cleverreach.de gelöscht. Auch das manuelle Aktivieren und Inaktivieren wird mit cleverreach.de synchronisiert.

Bei Löschen eines synchronisierten Verteilers im Contao-Backend wird dieser mit allen Abonnenten auf cleverreach.de ebenfalls gelöscht.

Support & Weiterentwicklung

Im Rahmen des Open-Source-Gedankens bieten wir für dieses Modul kostenfreien Support an. Bitte teilen Sie uns Fehler direkt auf Github unter https://github.com/47gn/contao_cleverreach_sync/issues mit. Um auf Github zu posten, benötigen Sie einen kostenfreien Account. Diesen können Sie unter https://github.com/join einrichten.

Sollten Sie keine Möglichkeit haben per Github Fehler zu melden, dann wenden Sie sich bitte per E-Mail an support@47gradnord.de .

Bitte beachten Sie, dass wir bemüht sind, zeitnah auf Ihre Fehlermeldungen zu reagieren. Bitte haben Sie aber dafür Verständnis, wenn wir aufgrund hoher Arbeitsauslastung nicht sofort das geschilderte Problem angehen und ggf. lösen können.

Sollten Sie für eines Ihrer Projekte eine angepasste Erweiterung der Schnittstelle benötigen, dann hinterlassen Sie uns bitte eine Nachricht.