Maak formulier
Automatisch bestanden maken op uw site - diploma's, certificaten of iets anders. Bezoekers van uw site hoeven alleen maar het formulier in te vullen en het bestand te ontvangen.
Om bestanden te maken, moet u een HTML-formulier op uw site maken. Als dat niet mogelijk is, gebruik dan gewoon de creatiewidget.
Het maken van een formulier
Om aanvragen naar DiMaker te sturen voor bestandscreatie, moet u een formulier op uw site maken. Dit formulier kan zich zowel in het openbare als in het private gedeelte van uw site bevinden. Maak een pagina en formulier binnen uw CMS.
Formulieractie
https://dimaker.app/api/v1/webform-create/Formulier velden
U moet een aantal verborgen velden maken met de volgende waarden:
-
secure*
Token (tekenreeks, 36 tekens)
-
doc_id*
Document-ID (tekenreeks, 36 tekens) die wordt gebruikt voor het maken van het bestand. De ID kan worden verkregen uit de adresbalk wanneer het document is geopend. Het document mag niet in de prullenbak liggen, maar kan in elke map met documenten liggen.
-
mail_id
ID van het sjabloon voor e-mailberichten (tekenreeks, 36 tekens). ID kan worden verkregen uit de adresbalk wanneer het sjabloon is geopend. Als de variabele niet wordt meegegeven, wordt het bericht niet verzonden.
-
email_send
Tijdstip waarop de e-mail met het bestand moet worden verzonden. Kan de volgende waarden aannemen:
onfinish - Alle berichten verzenden nadat alle bestanden zijn aangemaakt (standaard)
oncreate - Berichten meteen verzenden na het maken van een bestand. Bij het maken van één bestand zijn onfinish en oncreate identiek.
timeout - Berichten verzenden na een bepaalde tijdsperiode. In dit geval moeten nog twee parameters meegegeven worden:
email_timeout_value - numerieke waarde van de periode waarna berichten moeten worden verzonden, geheel getal
email_timeout_unit - eenheid van de periode. Kan de waarde "m" (minuten), "h" (uren), "d" (dagen) aannemen.
Of om de exacte tijd voor verzending aan te geven, moet de tijd in unix-tijd worden meegegeven in email_timeout_timestamp. Als zowel timeout als email_timeout_timestamp zijn meegegeven, dan heeft de laatste voorrang. -
storage_period
Opslagtijd van bestanden op de Schijf. Als de parameter niet is opgegeven, worden de bestanden voor onbepaalde tijd opgeslagen, totdat ze handmatig worden verwijderd. Voor verwijdering na een periode moet worden opgegeven:
timeout. In dit geval moeten nog twee parameters worden meegegeven:
storage_period_timeout_value - numerieke waarde van de periode waarna bestanden moeten worden verwijderd, geheel getal
storage_period_timeout_unit - eenheid van de periode. Kan de waarde "m" (minuten), "h" (uren), "d" (dagen) aannemen.
Of om de exacte tijd voor verwijdering aan te geven, moet de tijd in unix-tijd worden meegegeven in storage_period_timeout_timestamp. Als zowel storage_period_timeout_value als email_timeout_timestamp zijn meegegeven, dan heeft de laatste voorrang. -
folder_id
ID van de map op de Schijf (tekenreeks, 36 tekens) waar bestanden worden opgeslagen. Als de map niet bestaat, wordt deze automatisch aangemaakt bij het maken van het eerste bestand.
-
page_id
Paginanummer (nummer of tekenreeks), als het document meerdere pagina's bevat. U kunt een nummer doorgeven (eerste pagina - 0), of de nummers (gescheiden door komma's) van de pagina's die moeten worden gebruikt voor het maken van het bestand.
Stuur een bestand naar uzelf na creatie
Het bestand wordt direct na creatie naar het e-mailadres van uw account gestuurd. In het veld "E-mailsjabloon" kunt u selecteren welk sjabloon u wilt gebruiken voor het verzenden. U kunt vooraf een apart sjabloon aanmaken voor het verzenden van e-mails naar het e-mailaccount in E-mailsjablonen. Als u in de tekst van de e-mail de variabele %data vermeldt, worden op die plek alle gegevens van het bestand in tabelvorm toegevoegd.
Script en stijlen
Op de integratiepagina moet u de code ophalen en deze in de HEAD of een andere plek op de pagina plaatsen. U hoeft deze code niet op alle pagina's van de site te plaatsen. Deze code moet alleen op de pagina met het formulier worden geplaatst.
Bovendien moet u twee blokken maken met id result-success en result-danger. Beide blokken zijn verborgen, met stijl display:none; In het eerste blok kunt u tekst plaatsen voor succesvol aangemaakte bestanden. Dit blok wordt weergegeven bij een succesvolle aanvraag. Als zich een fout heeft voorgedaan, wordt het blok met id result-danger weergegeven. De foutmelding wordt automatisch in het blok geplaatst.
Vervanging in het document
In het document moet u ten minste één variabele voor vervanging hebben, zoals %name of %course. Voeg in het formulier een veld toe waarin de naam van de variabele moet beginnen met mask_, zoals mask_name of mask_course. Gegevens die door de bezoeker in deze velden zijn ingevoerd, worden vervangen door de overeenkomstige variabelen in de tekst van het document. Om het e-mailadres aan te geven, gebruikt u de variabele mask_email. Om berichten naar meerdere adressen te verzenden, geeft u deze gescheiden door komma's of spaties op. De verzendstatus op de Schijf wordt weergegeven voor het eerste adres.
Werking van het formulier
Na het maken van het formulier kunt u de gepubliceerde pagina openen en de werking van het formulier testen. Er wordt een bestand aangemaakt en weergegeven in een pop-upvenster om te downloaden.
Eén document = één invulling
Indien gewenst, kunt u het aantal invullingen van het formulier beperken. Als voor het opgegeven e-mailadres al een bestand met het doc_id is aangemaakt, wordt er een waarschuwing weergegeven dat er slechts één bestand kan worden aangemaakt.
Mijn documenten
U kunt de documenten van een persoon in het private gedeelte van uw site weergeven. Maak hiervoor een formulier zoals hierboven aangegeven. Voeg vervolgens de verborgen velden email, secure en doc_id toe. In het eerste - het e-mailadres van de bezoeker, en in het laatste veld geeft u de waarde all aan. Bij toegang tot deze pagina ziet de bezoeker op de plaats van het formulier een lijst met alle documenten die zij kunnen downloaden. Als u wilt dat bezoekers die het formulier al hebben ingevuld in plaats daarvan hun bestand zien, moet het e-mailadres van het formulier verborgen zijn en automatisch door uw CMS worden ingevuld.