Contao mit KlickTipp verbinden

[fenepedia/contao-klicktipp-gateway]

Mit dieser Erweiterung für Contao kannst du deine Kontakte von KlickTipp aktualisieren. Die Extension stellt dazu einen eigenen Gateway für das Notification Center bereit.

Voraussetzungen

Aktueller Funktionsumfang

  • Aktualisierung bestehender Kontakte in KlickTipp
  • Hinzufügen von Tags an bestehende Kontakte

Weitere Funktionen, wie z. B. das Anlegen neuer Kontakte sind für zukünftige Versionen geplant. Du kannst die Weiterentwicklung gerne unterstützen. Hier findest du die Erweiterung bei GitHub.

So setzt du die Erweiterung ein

1. Installation

Die Installation kann ganz bequem über den Contao Manager durchgeführt werden.

2. Neues Gateway anlegen

  1. Im Contao Backend anmelden
  2. Notification Center > Gateways > Neues Gateway
    • Titel: Name kann frei vergeben werden
    • Typ: KlickTipp API
    • Benutzername und Passwort von KlickTipp eintragen

Tipp: Bei KlickTipp Enterprise kannst du einen zusätzlichen Benutzer mit speziellen API-Rechten anlegen.

3. Neue Benachrichtigung erstellen

Notification Center > Benachrichtigungen > Neue Benachrichtigung

4. Daten-Update konfigurieren

Bei der soeben erzeugten Benachrichtigung muss nun eine "neue Nachricht" erstellt werden.
Hier findet die Zuordnung der Felder von Contao mit KlickTipp statt.

Subscriber Update:

  • Feld für E-Mail-Adresse festlegen
  • Zuordnung Contao Feldnamen mit KlickTipp Feldern
    • Contao Felder = ##form_fledname##
    • KlickTipp = API-Feldnamen

Tags

  • Feld für E-Mail-Adresse festlegen
  • Tag vergeben oder aus Formularfeld auslesen.
  • Unterstützt wird die eindeutige Tag-ID (empfohlen) und der Tag-Name

Es können auch mehrere Aktionen pro Nachricht durchgeführt werden. So kann z.B. ein Update der Daten und gleichzeitig auch ein zusätzlicher Tag vergeben werden.