So gehen CRM-System und TYPO3 CMS eine fruchtbare Verbindung ein

Die Einrichtung der Schnittstellen selbst, ist denkbar einfach und erfolgt wie gewohnt über den TYPO3 Extension Manager.

Die Reihenfolge der zu installierenden Extensions muss eingehalten werden. Das bedeutet das zuerst der „v4_crm_agent“, dann die „v4_crm_library“ und zuletzt der „v4_crm_portal_user“ heruntergeladen und installiert werden muss.

Nachdem alle 3 Erweiterungen heruntergeladen und installiert wurden, können diese nun ebenfalls über den Extension Manager konfiguriert werden.

Folgende Einstellungen können im „v4_crm_agent“ vorgenommen werden, wobei manche davon zwingend vorgenommen werden müssen (mit einem * markiert):

Damit Änderungen an den Templates beim nächsten Update nicht überschrieben werden, sollten alle Template-Ordner mit Inhalt beispielsweise in den fileadmin kopiert werden. Die Originaldateien liegen im „typo3conf/ext/v4_crm_agent/Resources/Private/” Ordner.

Den Pfad können wir im TypoScript beeinflussen. Zusätzlich zu den Pfadangaben muss noch die Ordner ID angegeben werden, in welcher dann das TYPO3 Pedant des CRM Benutzers gespeichert wird, nämlich in der fe_users Tabelle.

Um dies zu erreichen, muss folgendes in die Typoscript Constants eingetragen werden, welche dann wiederrum im TypoScript-Setup der Extension verwendet werden:

plugin.tx_v4crmportaluser {
view {
templateRootPath = fileadmin/templates/www.domain.tld/html/Templates
partialRootPath = fileadmin/templates/www.domain.tld/html/Partials/
layoutRootPath   = fileadmin/templates/www.domain.tld/html/Layouts/

}
persistence {
storagePid = 99
}

}

Unter „typo3conf/ext/v4_crm_agent/Configuration/TypoScript/“ sind weitere Einstellungen.

Folgende Templates werden von der Extension verwendet:

Wie bereits erwähnt, bietet die CRM-Extension sogenannte PHP Unit Tests. Mit diesen war es mir es schnell möglich, eine fehlerhafte Anbindung zu analysieren.

In meinem ersten Versuch scheiterte ich bereits daran, dass ich vergessen hatte, das statische Extension Template meinem Root Template hinzuzufügen. Dies wurde mir sofort beim Frontendaufruf per TYPO3 Fehlermeldung Extension template in root template not found! kenntlich gemacht.

Der nächste Fehler in welchen ich beim Testen reingestolpert war, bezog sich auf eine falsche Pfadangabe zur JSON URL. Die Nutzung der „Passwort vergessen“ Funktion lieferte ständig das Ergebnis Kein Benutzer gefunden obwohl dieser im CRM System definitiv vorhanden war.
Auch wenn man als Administrator das Passwort des jeweiligen Testbenutzers kennen sollte und man versucht sich direkt einzuloggen, kann dies wegen der fehlerhaften URL nicht klappen. Leider wird dies bei diesem Vorgang durch die nicht ganz treffende TYPO3 Fehlermeldung Required argument „email“ is not set kenntlich gemacht. Der Extension Entwickler ist informiert, dieser wird den Fall mit einer mehr entsprechenden Fehlermeldung noch abfangen.

Nachdem alle Extension-Konfigurations-Einstellungen von mir richtig vorgenommen wurden, liefen die Tests auch allesamt anstandslos durch.

Die Extension bietet in Ihrer jetzigen Form bereits eine hervorragende Basis, um die Grundfunktionalität, nämlich die Kommunikation der Extension mit einem CRM-System, dahin gehend zu erweitern, sodass weitere CRM-Funktionalitäten im CMS-System zur Verfügung gestellt werden können.

So habe ich bereits eine individuelle Erweiterung der Extension vorgenommen. Diese Erweiterung sorgt auf der einen Seite für die Darstellung, Kategorisierung und Buchung der Veranstaltung über eine Listen- und Detailansicht. Auf der anderen Seite können sich angemeldete Teilnehmer einloggen, Ihre Stammdaten ändern und zusätzlich die Veranstaltungen einsehen, an welchen Sie bereits teilgenommen haben oder werden. Zusätzlich werden hier auch die Fotokolle und weiterführende Informationen zu der Veranstaltung veröffentlicht. Dadurch kann mit der integrierten CRM-CMS Lösung ein professionelles Online-Veranstaltungsmanagement abgebildet werden.

Auf diese Art kann jedes CRM-Modul angesprochen werden. Die Kommunikation per JSON ist dabei so flexibel gewählt, das die Felder welche im CRM-System angesprochen werden sollen, einfach per Typoscript fieldList definiert werden, so dass diese dann wiederum von JSON herangenommen werden können, um die Abfragen dynamisch aufzubauen und starten zu können.

Als „best practice“ hat sich bewährt, für jedes CRM-Modul, das angesprochen werden soll, eine individuelle weitere Extension zu erstellen. Dies garantiert ein einfaches Debugging des jeweiligen Moduls sowie das schreiben Modulspezifischer PHP Unit Tests.

Prinzipiell müssten dabei 2 Extensions geschrieben werden. Eine in welcher die gemeinsamen CMS-Funktionen bereitgestellt werden und eine welche für die Darstellung des angesprochenen CRM-Moduls im Frontend zuständig ist.

Am Beispiel Veranstaltungen würde ich somit folgende zwei Zusatz-Extensions erstellen:

• v4_crm_library_events
• v4_crm_portal_user_events (hier wird per Typoscript die fieldList mit den anzusprechenden CRM Modul Feldnamen definiert)

Zusammenfassend lässt sich sagen, dass es mit dieser CRM-Schnittstelle für TYPO3 richtig Spaß macht, CRM-Informationen auf der CMS-Seite darzustellen. Mittels weniger Klicks und Konfigurationseinstellungen ist die Basiskommunikation sehr leicht und schnell eingerichtet.

Und wer gezielt bestimmte CRM-Module in seinem CMS nutzen möchte, kann dies genauso leicht in einer weiteren Extension programmieren. So konnte bei Firma.de der Online-Shop an das CRM-System nahtlos angebunden werden, über den die Startups und Gründer direkt alle Bausteine für eine erfolgreiche Firmengründung erwerben können. Dadurch können zeitaufwendige Prozesse automatisiert und wertvolle Ressourcen eingespart werden.

Für Anregungen und Verbesserungsvorschläge freuen wir uns über jeden Kommentar auf unserem Blog.