Integration mit Tilda
Automatisierte Dateierstellung über ein Formular auf Ihrer Tilda-Webseite. Besucher Ihrer Webseite können ihren Namen und weitere Daten eingeben, um eine fertige Datei zu erhalten. Bei Bedarf kann die Datei direkt an die E-Mail-Adresse des Empfängers gesendet werden.
Erstellung eines Formulars in Tilda
Um Anfragen zur Dateierstellung zu stellen, müssen Sie ein Formular auf Ihrer Webseite erstellen. Dieses Formular kann sowohl im Benutzerkonto als auch im öffentlichen Bereich der Webseite platziert werden. Sie können beliebige Formulare aus dem Tilda-Blockkatalog hinzufügen.
Formulareinstellungen
Klicken Sie auf die Schaltfläche "Inhalt" in der linken Ecke des Formulars. Danach, doppelklicken Sie auf den Titel "Daten aus Formular empfangen".
Ein zusätzlicher Umschalter "Eigenes Skript zur Datenverarbeitung" erscheint, den Sie auswählen müssen. Geben Sie in das Eingabefeld folgende Adresse ein:
https://dimaker.app/api/v1/tilda-create/
Einstellungsfenster des Formulars - Datenempfang
Bitte beachten Sie, dass die Daten ohne Seitenneuladung (AJAX) gesendet werden sollten.
Eingabefelder
In Ihrem DiMaker-Dokument sollte mindestens eine Variable für die Ersetzung vorhanden sein, beispielsweise %name oder %course. Die Variable muss in lateinischen Buchstaben geschrieben sein. Kyrillische Variablen wie %фио oder %класс dürfen nicht verwendet werden. Die E-Mail-Adresse entspricht %email.
In den Formularinhalten bei Tilda können Sie das Element "Einzeiliges Eingabefeld" hinzufügen (z.B. für "Name" oder "E-Mail"). Schreiben Sie im Feld "Titel des Eingabefeldes" die entsprechenden Informationen, z.B. "Vollständiger Name", und geben Sie im Feld "Variablenname" den Variablennamen ohne das %-Zeichen aus dem Dokument an, jedoch mit dem Präfix mask_. Beispielsweise wird aus %name die Variable mask_name, und aus %course wird mask_course. Die von Besuchern eingegebenen Daten in diesen Feldern ersetzen die entsprechenden Variablen im Text des Dokuments.
Hinzufügen des Feldes mask_name, welches %name im Dokument entspricht
Falls die fertige Datei per E-Mail versendet werden soll und das Formular öffentlich zugänglich ist (nicht im Benutzerkonto), muss ein E-Mail-Feld hinzugefügt werden, um die E-Mail-Adresse einzugeben. In diesem Fall lautet der Variablenname "mask_email".
Hinzufügen des Feldes mask_email, welches %email im Dokument entspricht
Die Anzahl der Eingabefelder und Variablen im Dokument kann beliebig sein. Sie können Besucherdaten anfordern und automatisch in die fertige Datei einfügen.
Falls Sie ein Datum, eine Zufallsnummer oder andere Informationen einfügen möchten, verwenden Sie bitte die Funktionen.
Versteckte Formularfelder
Erstellen Sie einige versteckte Felder, die das Formular identifizieren, angeben, welches Dokument verwendet werden soll, in welchen Ordner auf dem Laufwerk die Dateien gespeichert werden sollen usw.
Das Formular muss mindestens zwei obligatorische und, falls erforderlich, einige nicht obligatorische Felder haben.
Obligatorische Felder werden mit einem Sternchen markiert.
secure *
Zugangstoken. Diesen finden Sie in der benötigten Integration mit Tilda, im Feld "Token".
-
doc_id *
Dokumenten-ID erhalten Sie aus der Adressleiste, wenn das Dokument geöffnet ist. Diese ID ist 36 Zeichen lang und enthält keine Schrägstriche. Das Dokument darf nicht im Papierkorb liegen, kann jedoch in jedem Ordner gespeichert sein.
-
mail_id
ID der E-Mail-Vorlage. Diese ID erhalten Sie aus der Adressleiste, wenn die E-Mail-Vorlage geöffnet ist. Falls keine Variable übergeben wird, wird keine E-Mail versendet.
-
email_send
Zeitraum für den Versand der Datei per E-Mail. Optionen:
onfinish - Versand der Mails, nachdem alle Dateien in der Gruppe erstellt wurden (Standard).
oncreate - Sofortversand nach der Dateierstellung. Bei einer Einzeldateierstellung sind onfinish und oncreate identisch.
timeout - Versand nach einem festgelegten Intervall. In diesem Fall müssen zusätzlich zwei Parameter angegeben werden:
email_timeout_value - Zahlenwert des Intervalls (Ganzzahl).
email_timeout_value - Einheit des Intervalls, z.B. "m" (Minuten), "h" (Stunden), "d" (Tage).Alternativ kann ein spezifischer Zeitpunkt im Unix-Format über email_timeout_timestamp übergeben werden. Diese Variable hat Vorrang, falls beide übergeben werden. -
folder_id
Ordner-ID, in dem die Dateien gespeichert werden sollen. Fehlt der Ordner, wird er bei der ersten Dateierstellung automatisch erstellt.
-
page_id
Wenn das Dokument mehrere Seiten hat, können Sie die Seiten-IDs (ab 0) oder die IDs der zu erstellenden Seiten (kommagetrennt) angeben.
Zusammengefasst: Das Formular muss zwei obligatorische Felder enthalten: "Secure" sowie "doc_id".
Verstecktes Feld Secure. Den Wert finden Sie in den Einstellungen.
Ebenso wie das Feld "doc_id".
Verstecktes Feld doc_id. Der Wert ist die 36-stellige Dokumenten-ID aus der Adresszeile.
Falls eine Datei per E-Mail versandt werden soll, muss zudem eine E-Mail-Vorlage-ID angegeben werden.
Verstecktes Feld mail_id. Der Wert ist die 36-stellige E-Mail-Vorlage-ID.
Falls die Datei in einem bestimmten Ordner auf dem Laufwerk gespeichert werden soll, muss eine Ordner-ID angegeben werden.
Verstecktes Feld folder_id. Der Wert ist die 36-stellige Ordner-ID.