Formulärskapande
Automatiskt skapande av filer på din webbplats - diplom, certifikat eller något annat. Besökaren på din webbplats behöver bara fylla i ett formulär och få filen.
För att skapa filer behöver du skapa ett HTML-formulär på din webbplats. Om det inte är möjligt, använd då bara skapelse-widgeten.
Skapa ett formulär
För att skicka begäran om att skapa filer i DiMaker behöver du skapa ett formulär på din webbplats. Detta formulär kan placeras både i den offentliga och stängda delen av din webbplats. Skapa en sida och ett formulär på sidan med hjälp av ditt CMS.
Formulärets action
https://dimaker.app/api/v1/webform-create/Formulärfält
Du behöver skapa några dolda fält med följande värden:
-
secure*
Token (sträng, 36 tecken)
-
doc_id*
ID för dokumentet (sträng, 36 tecken) som kommer att användas för att skapa filen. ID kan erhållas i adressfältet när dokumentet är öppet. Dokumentet får inte vara i papperskorgen, men kan ligga i vilken mapp som helst för Dokument.
-
mail_id
ID för e-postmall (sträng, 36 tecken) för att skicka via e-post. ID kan erhållas i adressfältet när mallen är öppen. Om variabeln inte anges, kommer inget e-postmeddelande att skickas.
-
email_send
Tidpunkt för när e-postmeddelandet med filen ska skickas. Kan ta följande värden:
onfinish - Skicka alla e-postmeddelanden efter att alla filer har skapats (standardvärde)
oncreate - Skicka e-post omedelbart efter att filen har skapats. Vid skapande av en fil är onfinish och oncreate identiska.
timeout - Skicka e-postmeddelanden efter en viss tidsperiod. I detta fall måste ytterligare två parametrar skickas:
email_timeout_value - numeriskt värde för intervallet, efter vilket e-postmeddelanden ska skickas, heltalsvärde
email_timeout_unit - enhet för tidsintervall. Kan ta värdet "m" (minuter), "h" (timmar), "d" (dagar).
Alternativt, för att specificera exakt tid för utskick, ange tiden i unix time-format i email_timeout_timestamp. Om timeout och email_timeout_timestamp skickas, har det senare prioritet. -
storage_period
Filernas lagringstid på Disken. Om parametern inte anges, lagras filerna på obestämd tid, tills dess de tas bort manuellt. För att ta bort efter en viss period bör det ta värdet:
timeout. I detta fall måste ytterligare två parametrar skickas:
storage_period_timeout_value - numeriskt värde för intervallet, efter vilket filer ska tas bort, heltalsvärde
storage_period_timeout_unit - enhet för tidsintervall. Kan ta värdet "m" (minuter), "h" (timmar), "d" (dagar).
Alternativt, för att specificera exakt tid för borttagning, ange tiden i unix time-format i storage_period_timeout_timestamp. Om storage_period_timeout_value och email_timeout_timestamp är skickade, har det senare prioritet. -
folder_id
ID för mappen i Disken (sträng, 36 tecken) där filerna sparas. Om mappen inte finns, skapas den automatiskt när den första filen skapas.
-
page_id
Ordningstal för bladet (nummer eller sträng), om dokumentet har flera blad. Du kan skicka ett nummer (första bladet - 0), eller nummer (separerade med kommatecken) av bladen som ska användas för att skapa filen.
Skicka filen till dig själv efter skapande
Filen kommer att skickas till kontots e-post direkt efter att den har skapats. I fältet "E-postmall" kan du välja vilken mall som ska användas för utskicket. Förbered en separat mall i E-postmallar för att skicka e-postmeddelanden till kontots e-post. Om du skriver in %data i e-postmeddelandets text kommer alla filens data att läggas till på den platsen i form av en tabell.
Script och stilar
På integrationssidan behöver du ta koden och sätta in den i HEAD eller någon annan plats på sidan. Du behöver inte sätta in denna kod på alla sidor på webbplatsen. Det är nödvändigt att endast infoga den på sidan där formuläret finns.
Du behöver också skapa två block med id:na result-success och result-danger. Båda blocken är dolda med stil display:none; I det första blocket kan du skriva text med ett lyckat skapande av filen. Detta block kommer att visas vid en framgångsrik begäran. Om ett fel inträffar kommer blocket med id:et result-danger att visas. Felmeddelandet kommer att läggas till i blocket automatiskt.
Insättning i dokumentet
I dokumentet ska du ha åtminstone en variabel för utbyte, till exempel %name eller %course. Lägg till ett fält i formuläret där variablens namn börjar med mask_, till exempel mask_name eller mask_course. Uppgifterna som besökaren anger i dessa fält kommer att ersättas med motsvarande variabler i texten i dokumentet. För att ange en e-postadress använd variabeln mask_email. För att skicka e-post till flera adresser, ange dem skilda med komma eller mellanslag. I detta fall kommer utskickets status på Disken att visas utifrån den första adressen.
Formulärets arbete
Efter att ha skapat formuläret kan du öppna den publicerade sidan och kontrollera formulärets funktion. En fil skapas och visas i ett popup-fönster för nedladdning.
Ett dokument = en inlämning
Om du vill kan du begränsa antalet inlämningar i formuläret. Om det redan har skapats en fil med doc_id för den angivna e-posten, kommer ett varningsmeddelande visas om att endast en fil kan skapas.
Mina dokument
Du kan visa en persons dokument i den skyddade delen av din webbplats. För detta, skapa ett formulär som anges ovan. Lägg sedan till dolda fält för email, secure och doc_id. I det första - besökarens e-postadress och i det sista fältet ange värdet all. När besökaren öppnar denna sida kommer de att se en lista över alla dokument på formulärens plats, med möjlighet att ladda ner dem. Om du vill att om besökaren redan har fyllt i formuläret, att deras fil istället för formuläret visas, bör e-postfältet i formuläret vara dolt och automatiskt fyllt i av ditt CMS.