Integratie met Tilda
Automatisch bestanden aanmaken via een formulier op uw website in Tilda. Bezoekers van uw site kunnen hun naam en andere gegevens invoeren en een kant-en-klaar bestand ontvangen. Indien nodig kan het bestand via e-mail naar de ontvanger gestuurd worden.
Formulier aanmaken in Tilda
Om verzoeken voor het aanmaken van bestanden te versturen, is het nodig om een formulier op de website te maken. Dit formulier kan zich bevinden in het persoonlijke dashboard of op het publieke deel van de website. U kunt elk formulier toevoegen uit de blokkenbibliotheek van Tilda.
Formulierinstellingen
Klik op de knop "Content" in de linkerhoek van het formulier. Klik daarna tweemaal op de kop "Data uit het formulier verwerken". Er verschijnt een extra schakelaar "Eigen script voor gegevensverwerking", selecteer deze.
Vul in het invoerveld het volgende adres in:
https://dimaker.app/api/v1/tilda-create/
Formulierinstellingen - gegevensverwerking
Houd er rekening mee dat de gegevens zonder paginavernieuwing (AJAX) moeten worden verzonden.
Invoervelden
In een DiMaker-document moet minstens één variabele aanwezig zijn, bijvoorbeeld %name of %course. De variabele moet in latijnse letters geschreven zijn. Variabelen in Cyrillisch, zoals %name of %класс, zijn niet toegestaan. Het e-mailadres wordt aangeduid met %email.
In de inhoud van een formulier in Tilda moet u "Eenregelig veld" toevoegen (bijvoorbeeld "Naam", "Email"). In het veld "Veldtitel" beschrijft u welke gegevens worden opgevraagd, zoals "Volledige naam". In het veld "Variabelenaam" voegt u de naam van de variabele zonder het %-teken uit het document toe, voorafgegaan door het voorvoegsel mask_. Bijvoorbeeld, als de variabele in het document %name is, dan moet de variabelenaam in Tilda mask_name zijn. Als de variabele in het document %course is, dan moet de variabelenaam mask_course zijn. De gegevens ingevuld door de bezoeker in deze velden worden vervangen door de corresponderende variabelen in de inhoud van het document.
Mask_name toevoegen, wat overeenkomt met %name in het document
Als het noodzakelijk is om de kant-en-klare bestanden per mail te versturen en het formulier zich op het publieke deel van de website bevindt (niet in het persoonlijke dashboard), moet u een e-mailadresveld toevoegen. In dit geval moet de variabelenaam "mask_email" zijn.
Mask_email toevoegen, wat overeenkomt met %email in het document
Het aantal invoervelden en variabelen in een document is onbeperkt. U kunt bezoekers om gegevens vragen om deze vervolgens op een kant-en-klaar bestand te plaatsen.
Als u gegevens zoals de huidige datum of een willekeurig nummer wilt invoegen, moet u gebruik maken van functies.
Verborgen velden in het formulier
Daarna dient u enkele verborgen velden aan te maken. Deze velden identificeren het formulier en bepalen welk document moet worden gebruikt, waar het bestand in de Opslag moet worden opgeslagen, enzovoorts.
Het formulier moet ten minste twee verplichte velden bevatten en, indien nodig, aanvullende optionele velden.
Verplichte velden worden aangeduid met een sterretje.
secure *
Toegangstoken. Dit kan worden gevonden in de integratie-instellingen van Tilda, in het veld "Token".
-
doc_id *
Het document-ID kan worden gevonden in de adresbalk wanneer het document geopend is. Het ID bestaat uit 36 tekens, zonder schuine strepen. Het document mag niet in de prullenbak staan, maar kan zich in elke map van Documenten bevinden.
-
mail_id
Het ID van de e-mailsjabloon kan worden gevonden in de adresbalk wanneer de e-mailsjabloon geopend is. Het ID bestaat uit 36 tekens, zonder schuine strepen. Als deze variabele niet is opgegeven, wordt er geen e-mail verzonden.
-
email_send
Het tijdstip waarop de e-mail met het bestand moet worden verzonden. Het kan de volgende waarden hebben:
onfinish - Stuur alle e-mails na het aanmaken van alle bestanden in de groep (standaardwaarde).
oncreate - Verstuur de e-mails direct na het aanmaken van een bestand. Voor een enkel bestand zijn onfinish en oncreate identiek.
timeout - Verstuur e-mails na een tijdsinterval. In dat geval moeten ook de volgende parameters worden opgegeven:
email_timeout_value - een getal dat het interval weergeeft (bijvoorbeeld een geheel getal voor minuten, uren of dagen).
email_timeout_value_unit - de eenheid van het interval. Kan de waarde "m" (minuten), "h" (uren), "d" (dagen) hebben.Voor specifieke tijdstippen kunt u een UNIX-timestamp doorgeven in email_timeout_timestamp. Als beide parameters opgegeven zijn, heeft timestamp prioriteit. -
folder_id
De map waarin de bestanden in de Opslag worden geplaatst. Als de map niet bestaat, wordt deze automatisch aangemaakt bij het aanmaken van het eerste bestand. Het map-ID kan worden gevonden in de adresbalk wanneer de map geopend is. Het ID bestaat uit 36 tekens, zonder schuine strepen.
-
page_id
Indien een document meerdere pagina's bevat, kunt u in het veld page_id de paginanummers (vanaf 0) of een lijst van paginanummers (gescheiden door komma's) opgeven die gebruikt moeten worden voor het aanmaken van bestanden.
Bijgevolg moeten minstens twee verplichte verborgen velden aanwezig zijn: het veld Secure en het veld doc_id.
Verborgen veld Secure. De waarde van het veld moet worden opgehaald in de instellingen.
En het veld doc_id.
Verborgen veld doc_id. De waarde is het document-ID uit de adresbalk.