Formulärskapande
Automatisk generering av filer på din webbsida – diplom, certifikat eller något annat. Besökaren behöver bara fylla i formuläret för att få filen.
För att skapa filerna behöver du lägga till ett HTML-formulär på din webbsida. Om det inte är möjligt, kan du använda en färdig integrationswidget.
Skapa ett formulär
För att skicka förfrågningar om filskapande till DiMaker måste du skapa ett formulär på din webbsida. Formuläret kan finnas på en offentlig eller endast tillgänglig del av webbplatsen. Skapa en sida och formulär med hjälp av ditt CMS.
Formulärets action
https://dimaker.app/api/v1/webform-create/Formulärfält
Du måste lägga till ett antal dolda fält med följande värden:
-
secure*
Token (en sträng på 36 tecken)
-
doc_id*
ID för dokumentet (en sträng på 36 tecken) som ska användas för att skapa filen. Du hittar dokument-ID i adressfältet när dokumentet är öppet. Dokumentet får inte ligga i papperskorgen, men kan finnas i vilken som helst av Dokument-mapparna.
-
mail_id
ID för e-postmall (en sträng på 36 tecken) för att mejla filen. Du hittar mail-ID i adressfältet när mallen är öppen. Om detta inte skickas med, skickas inget mejl.
-
email_send
Tid för att mejla filen. Kan ta följande värden:
onfinish - Mejla ut alla filer efter att alla skapats (standardinställning)
oncreate - Skicka mejlet direkt när filen skapats. För en enskild fil är onfinish och oncreate identiska.
timeout - Skicka mejlet med tidsfördröjning. Om du väljer detta måste du även ange två parameterar:
email_timeout_value - ett numeriskt värde som anger fördröjningens längd (heltal)
email_timeout_units - enhet för fördröjningens längd, med värden som "m" (minuter), "h" (timmar), "d" (dagar).
Eller sätt en exakt tid för utskick med email_timeout_timestamp i unix time-format. Om både timeout och email_timeout_timestamp anges, har den senare högre prioritet. -
folder_id
ID för Disk-mappen (en sträng på 36 tecken) där filerna ska sparas. Om mappen inte finns kommer den att skapas automatiskt när den första filen skapas.
-
page_id
Sida i dokumentet (nummer eller sträng), om dokumentet har flera sidor. Ange ett sidnummer (första sidan är 0) eller flera nummer åtskilda av kommatecken.
Skicka fil till dig själv efter skapande
Filen skickas automatiskt till kontots mejladress så snart den skapats. I fältet "E-postmall" kan du välja vilken mall som ska användas. Förbered en mall i förväg under E-postmallar. Om du i mejlet använder variabeln %data, kommer filens innehåll att visas i tabellformat på den platsen.
Script och stilar
På integrationssidan hittar du koden som du ska placera i HEAD eller annan del av sidan. Koden ska endast läggas till på sidan med formuläret, inte på alla sidor.
Du måste också skapa två dolda block med id:na result-success och result-danger, båda med display: none; I success-blocket kan du skriva en bekräftelse för lyckad filskapning, medan error-blocket automatiskt fylls med ett felmeddelande vid fel.
Placera data i dokumentet
I dokumentet ska det finnas minst en variabel som kan bytas ut, till exempel %name eller %course. Lägg till ett fält i formuläret där variabelnamnet börjar med mask_, exempelvis mask_name eller mask_course. Data som besökaren fyller i dessa fält ersätter de motsvarande variablerna i dokumentet. Använd variabeln mask_email för mejladresser. För flera mejladresser, separera dem med kommatecken eller mellanslag. Dokumentstatus i Disk visas efter den första adressen.
Tester och funktion
När formuläret är klart kan du öppna den publicerade sidan och testa funktionaliteten. En fil kommer att skapas och visas i ett popup-fönster för nedladdning.
En fil = en ifyllnad
Valfritt kan du begränsa antalet ifyllningar för formuläret. Om en fil redan skapats för en viss mejladress med doc_id, visas en varning om att endast en fil kan skapas.
Mina dokument
Du kan visa en lista över en användares dokument på en sluten del av din webbplats. För detta krävs ett formulär enligt ovan. Lägg dessutom till dolda fält för email, secure och doc_id. Ange besökarens mejladress i email-fältet och använd "all" som värde i doc_id-fältet. Vid visning av sidan ser besökaren en listning av sina dokument med möjlighet att ladda ner dem. Om besökaren redan fyllt i formuläret tidigare, kan filen visas direkt istället för formuläret genom att göra email-fältet dolt och förifyllt via ditt CMS.