Formulář vytváření
Automatické vytváření souborů na vašem webu - diplomů, certifikátů nebo něčeho jiného. Návštěvník vašeho webu jednoduše vyplní formulář a obdrží soubor.
Pro vytvoření souborů je třeba vytvořit HTML formulář na vašem webu. Pokud to není možné, jednoduše použijte widget pro vytváření.
Vytvoření formuláře
Abyste mohli odesílat požadavky na vytváření souborů v DiMaker, potřebujete vytvořit formulář na svém webu. Tento formulář může být umístěn jak ve veřejné, tak v uzavřené části vašeho webu. Pomocí vašeho CMS vytvořte stránku a formulář na stránce.
Action formuláře
https://dimaker.app/api/v1/webform-create/Pole formuláře
Je třeba vytvořit několik skrytých polí s následujícími hodnotami:
-
secure*
Token (řetězec, 36 znaků)
-
doc_id*
ID dokumentu (řetězec, 36 znaků), které bude použito pro vytváření souboru. ID lze získat v adresním řádku, když je dokument otevřen. Dokument nesmí být v koši, ale může ležet v jakékoliv složce Dokumentů.
-
mail_id
ID šablony e-mailu (řetězec, 36 znaků) pro odesílání e-mailem. ID lze získat v adresním řádku, když je šablona otevřena. Pokud proměnná není předána, e-mail odeslán nebude.
-
email_send
Čas, kdy odesílat e-mail se souborem. Může přijímat následující hodnoty:
onfinish - Odeslat všechny e-maily po vytvoření všech souborů (výchozí)
oncreate - Odeslat e-maily ihned po vytvoření souboru. Při vytváření jediného souboru jsou onfinish a oncreate totožné.
timeout - Odeslat e-maily po časové prodlevě. V tomto případě je třeba ještě zadat dva parametry:
email_timeout_value - číselná hodnota prodlevy, po které budou e-maily odeslány, celé číslo
email_timeout_unit - jednotka měření prodlevy. Může přijímat hodnoty "m" (minuty), "h" (hodiny), "d" (dny).
Nebo, pro zadání přesného času odeslání, je třeba poslat čas ve formátu unix time v email_timeout_timestamp. Pokud jsou předány timeout a email_timeout_timestamp, prioritu bude mít poslední. -
storage_period
Doba uložení souborů na Disku. Pokud není parametr uveden, soubory se ukládají neomezeně, dokud nejsou ručně odstraněny. K odstranění po časové prodlevě musí přejmout hodnotu:
timeout. V tomto případě je třeba ještě předat dva parametry:
storage_period_timeout_value - číselná hodnota prodlevy, po které budou soubory odstraněny, celé číslo
storage_period_timeout_unit - jednotka měření prodlevy. Může přijímat hodnoty "m" (minuty), "h" (hodiny), "d" (dny).
Nebo, pro zadání přesného času odstranění, je třeba poslat čas ve formátu unix time v storage_period_timeout_timestamp. Pokud jsou předány storage_period_timeout_value a email_timeout_timestamp, prioritu bude mít poslední. -
folder_id
ID složky na Disku (řetězec, 36 znaků) pro ukládání souborů. Pokud složka neexistuje, bude automaticky vytvořena při vytvoření prvního souboru.
-
page_id
Pořadové číslo listu (číslo nebo řetězec), pokud dokument obsahuje více listů. Můžete předat jedno číslo ( první list - 0), nebo čísla (oddělená čárkou) listů, které je třeba použít pro vytvoření souboru.
Odeslat sobě soubor po vytvoření
Soubor bude ihned po vytvoření odeslán na e-mail účtu. V poli „Šablona e-mailu“ můžete vybrat, kterou šablonu použít pro odeslání. Předem v Šablonách e-mailů můžete vytvořit samostatnou šablonu pro odesílání e-mailů na e-mail účtu. Pokud v textu e-mailu uvedete proměnnou %data, na toto místo budou přidány všechny údaje souboru ve formě tabulky.
Skript a styly
Na stránce integrace je třeba získat kód a vložit jej do sekce HEAD nebo jiného místa stránky. Tento kód není třeba vkládat na všechny stránky webu. Je nutné vložit tento kód pouze na stránku s formulářem.
Dále je třeba vytvořit dva bloky s id result-success a result-danger. Oba bloky skryté, se stylem display:none; Do prvního bloku můžete napsat text s úspěšným vytvořením souboru. Tento blok se zobrazí po úspěšném odeslání požadavku. Pokud dojde k nějaké chybě, bude zobrazen blok s id result-danger. Chybová zpráva bude automaticky vložena do bloku.
Dosazování do dokumentu
V dokumentu musí být alespoň jedna proměnná pro nahrazení, například %name nebo %course. Přidejte do formuláře pole, kde jméno proměnné začíná mask_, například mask_name nebo mask_course. Údaje zadané návštěvníkem do těchto polí budou nahrazeny odpovídajícími proměnnými v textu dokumentu. Pro zadání e-mailové adresy použijte proměnnou mask_email. Pro odesílání e-mailů na více adres uveďte je oddělené čárkou nebo mezerou. Stavy odeslání na Disku budou zobrazeny podle první adresy.
Funkce formuláře
Po vytvoření formuláře můžete otevřít publikovanou stránku a zkontrolovat funkci formuláře. Bude vytvořen soubor a zobrazen v rozbalovacím okně ke stažení.
Jeden dokument = jedno vyplnění
Dle přání můžete omezit počet vyplnění formuláře. Pokud již byl na uvedený e-mail vytvořen soubor s doc_id, zobrazí se varování, že lze vytvořit pouze jeden soubor.
Moje dokumenty
Dokumenty můžete zobrazit osobě v uzavřené části vašeho webu. To provedete vytvořením formuláře, jak bylo uvedeno výše. Poté přidejte skrytá pole email, secure a doc_id. Do prvního - e-mailová adresa návštěvníka a do posledního pole zadejte hodnotu all. Po otevření této stránky návštěvník uvidí místo formuláře seznam všech dokumentů s možností jejich stažení. Pokud si přejete, aby pokud návštěvník již formulář vyplnil, aby místo formuláře viděl svůj soubor, pole email formuláře musí být skryté a automaticky poskytované vaší CMS.