Die einfachste Möglichkeit Anmeldeformulare von Drupal mit Maileon zu verknüpfen, ist über WebForms einen Handler zu definieren, welcher die Daten an die Maileon Webhook-API übergibt. Leider ist der direkte Weg aktuell nicht möglich, denn für die namen der Felder in WebForms dürfen nur Kleinbuchstaben verwendet werden und die Handler erlauben keine Angabe eines Mappings. Für die Webhook-API ist jedoch die exakte Groß-/ und Kleinschreibung wichtig, somit wird eine MIddleware als Übersetzer benötigtConnecting subscription forms in Drupal to Maileon can be done by setting up a WebForms Handler.

However, since field names in WebForms Handlers may only contain lowercase letters, a middleware to convert the field names is required.

Subscribe

Endpoint

POST https://integrations.maileon.com/xsic/ext/drupal/subscribe.php

...

Parameter

Folgende Parameter können oder müssen dabei übergeben werden:

• „email“: Es ist zwingend erforderlich, dass es einen Parameter „email“ gibt. In einem Formular muss das Feld also auch genau diesen Schlüssel aufweisen.

• „account_id“: Wenn es möglich sein soll mehr als nur eienn Account zu verwenden, etwa wenn verschiedene Formulare auf verschiedene Accounts verweisen, so wird pro Account eine neue Konfiguration im Skript hinzugefügt. Diese Account-Konfiguration kann man über die Variable „account_id” spezifizieren. Wird keine ID angegeben, so wird ein fest definierter Fallback verwendet. Dieses Feld sollte am besten als verstecktes Feld im Formular hinzugefügt werden.

• „doi_key“: Wenn ein Wert für „doi_key“ angegeben wird, so wird das entsprechende DOI ausgelöst. Wird das Attribut gar nicht oder mit leerem Wert übergeben, so wird das Default-DOI-Mailing des Kontos übergeben. Hinweis: wird ein DOI-Schlüssel angegeben der im Maileon-Konto nicht existiert, so wird die Anmeldung fehlschlagen. Genau so verhält es sich, wenn ein DOI-Mailing durch ein neues DOI-Mailing in Maileon ersetzt wird.
  Hier ist darauf zu achten wieder den gleichen DOI-Schlüssel in den Basiseinstellungen des neuen Mailings einzustellen.

• „webform_id“: Dieser Parameter kann optional angegeben werden. Wenn hier die ID des Formulares übergeben wird, so wird dies als „Subscription Source“ beim Registrieren des Kontaktes eingetragen und es ist möglich Kontakte über die Kontaktfilter in Maileon zu unterscheiden.

Weiterhin werden per Default einige Standard-Felder übernommen: „salutation“, „fullname“, „firstname“ und „lastname“. Diese müssen im Formular genau so benannt werden, da der Name des Feldes direkt vom WebForm-Handler weitergeleitet wird. Existieren die Felder nicht, so wird dieser Default ignoriert und hat keine weiteren Auswirkungen. Werden weitere Felder benötigt kann einerseits das Skript entsprechend erweitert werden, andererseits benötigt möglicherweise nicht jedes Formular die gleichen Felder und es ist natürlich nicht immer möglich ein Formular entsprechend aufzubauen. Hierzu wird ein dynamisches Feldmapping verwendet, welches über zwei Felder gesteuert werden kann. Auch hier empfiehlt es sich diese Konfigurationen als versteckte Felder im Formular unterzubringen.

• mapping_standard_fields

• mapping_custom_fields

Die Werte der Felder sind als JSON-Objekte zu befüllen und folgen der Konvention, dass der Attribut-Name dem Namen des Feldes im Formular und der Wert dem Namen des Feldes in Maileon entspricht. Ein JSON-Objekt ist wie folgt definiert:

{"FeldnameImFormular ": "FeldnameInMaileon"}

Bei mehr als einem Eintrag werden diese Kommasepariert:

{"FeldnameImFormular1 ": "FeldnameInMaileon1", "FeldnameImFormular2 ": "FeldnameInMaileon2"}

Es ist notwendig die korrekte Schreibweise der Maileon-Variablen einzuhalten. Für Standardfelder wie Vor- und Nachname sind die korrekten Bezeichnungen in der Dokumentation zu finden.

Bei den Custom-Feldern ist es lediglich notwendig, die genaue Groß- und Kleinschreibung der in Maileon erzeugten Felder einzuhalten.

Beispiel:

<input type="hidden" name="mapping_standard_fields" value='{"fname": "FIRSTNAME", "lname":"LASTNAME"}' />
<input type="hidden" name="mapping_custom_fields" value='{"customer_dep":"Department"}' />

Mit obigen Mappings würde also nun das Formularfeld mit dem Schlüssel/Namen “fname“ in das Standardfeld „FIRSTNAME“ (=Vorname) eingetragen und „lname“ würde entsprechend in das Maileon-Feld LASTNAME (=Nachname) eingetragen werden. Zusätzlich würde der Wert des Formular-Feldes „customer_dep“ in das Custom-Feld „Department“ eingetragen.

Somit können beliebige Felder aus dem Formular in Maileon eingebunden werden, einzig das Feld „email“ ist fest vorgegeben.

Konfiguration des WebForms Handlers

Zunächst muss das Formular angelegt werden. Ein Hinweis dazu: beim Erstellen eines Elementes kann über den Link „Bearbeiten“ der Schlüssel (=Name im Datenmodell) des Elementes angepasst werden, siehe Abbildung 1.

...

Abbildung 2 zeigt ein Beispiel mit der E-Mail-Adresse, einem Vor- und einem Nachnamen. Weiterhin wird das Mapping für Standard-Felder aus dem Beispiel verwendet, siehe Abbildung 3.

...

Anschließend wird unter „Einstellungen“ -> „E-Mails / Handlers“ ein neuer Handler vom Typ „Remote Post“ hinzugefügt (Abbildung 4).

...

Parameter

WebForm configuration

First, the form needs to be created and elements need to be added

...

Figure 2 displays an example with an email address, a first name and a last name. Additional fields are being converted by using the parameter “mapping_standard_fields”.

...

The mapping is being defined by a JSON object, in which the object’s attribute name maps the field's name in the WebForm and it’s value maps the field's name in Maileon.

Example:

{
  "fname": "FIRSTNAME",
  "lname": "LASTNAME",
  "street": "ADDRESS",
  "zip": "ZIP",
  "city": "CITY"
}

...

WebForm handler configuration

Finally add a “Remote Post” handler to send submitted form data to the middleware.

...