Formulář pro vytváření
Automatické generování souborů na vašem webu - diplomů, certifikátů či jiných dokumentů. Vašim uživatelům stačí vyplnit formulář a získat soubor.
Pro generování souborů je nutné na webových stránkách vytvořit HTML formulář. Pokud to není možné, doporučujeme použít widget pro vytváření.
Vytvoření formuláře
Pro odeslání požadavků na generování souborů prostřednictvím DiMaker je potřeba vytvořit formulář na vašem webu. Formulář může být umístěn jak v veřejné, tak i uzavřené části webu. Pomocí CMS vytvořte stránku s formulářem.
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ý se použije pro generování souboru. ID lze získat z adresního řádku při otevření dokumentu. Dokument nesmí být v koši, ale může se nacházet v libovolné složce Dokumentů.
-
mail_id
ID šablony e-mailu (řetězec, 36 znaků), který bude použit pro zaslání e-mailem. ID lze zjistit z adresního řádku při otevření šablony. Pokud není proměnná předána, žádný e-mail nebude odeslán.
-
email_send
Čas odeslání e-mailu se souborem. Možné hodnoty:
onfinish – Odeslat všechny e-maily po vygenerování všech souborů (výchozí nastavení)
oncreate – Odesílat e-maily ihned po vytvoření souboru. Pokud se vytváří jen jeden soubor, onfinish a oncreate jsou stejné.
timeout – Odeslat e-maily s časovým odstupem. V tomto případě je třeba zadat další dvě proměnné:
email_timeout_value – celé číslo představující časový interval,
email_timeout_unit – jednotka času: "m" (minuty), "h" (hodiny) nebo "d" (dny).
Pro přesný čas odeslání použijte formát unix time v proměnné email_timeout_timestamp. Při přítomnosti timeout i email_timeout_timestamp má vyšší prioritu timestamp. -
folder_id
ID složky na Disku (řetězec, 36 znaků), kam se budou ukládat soubory. Pokud složka neexistuje, bude automaticky vytvořena při prvním generování souboru.
-
page_id
Pořadové číslo stránky (číslo nebo řetězec), pokud dokument obsahuje více stránek. Lze zadat jediné číslo (první stránka - 0) nebo čísla oddělená čárkou, která budou použita pro generování souboru.
Odeslání výsledného souboru na váš e-mail
Soubor bude automaticky odeslán na e-mail vašeho účtu ihned po jeho vytvoření. V poli „Šablona e-mailu“ lze vybrat, jakou šablonu použít pro odesílání. Nejprve můžete v sekci Šablony e-mailů vytvořit šablonu speciálně pro toto použití. Pokud v textu e-mailu použijete proměnnou %data, na toto místo budou vloženy všechny údaje o souboru ve formě tabulky.
Skript a styly
Získaný kód na stránce integrace vložte do sekce HEAD nebo jiného místa na stránce. Tento kód by měl být přidán pouze na stránku obsahující formulář, ne na všechny stránky webu.
Dále je třeba vytvořit dva bloky s id result-success a result-danger. Oba bloky by měly být skryté pomocí stylu display:none; Do bloku result-success můžete napsat text, který se zobrazí při úspěšném vytvoření souboru. V případě chyby se zobrazí blok result-danger a text chyby bude automaticky vložen do tohoto bloku.
Proměnné v dokumentu
Pro nahrazení proměnných v dokumentu musíte mít v textu dokumentu alespoň jednu proměnnou, například %name nebo %course. Do formuláře přidejte pole, jehož název začíná mask_, například mask_name nebo mask_course. Hodnoty vyplněné uživatelem se nahradí příslušnými proměnnými v textu dokumentu. Pro e-mailovou adresu použijte proměnnou mask_email. Pro odeslání na více e-mailových adres použijte čárku nebo mezeru mezi adresami. Stav odeslání se však zobrazí pouze pro první adresu.
Funkčnost formuláře
Po vytvoření formuláře otevřete publikovanou stránku a otestujte jeho funkčnost. Vygenerovaný soubor se zobrazí ve vyskakovacím okně a bude připraven ke stažení.
Jeden dokument = jedno vyplnění
Chcete-li omezit počet vyplnění formuláře, můžete nastavit pravidlo, že na zadaný e-mail může být vygenerován pouze jeden soubor s určitou doc_id. Pokud už soubor s tímto nastavením existuje, zobrazí se upozornění.
Moje dokumenty
Na uzavřených stránkách vašeho webu můžete uživatelům zobrazit jejich vytvořené dokumenty. Vytvořte formulář podle výše uvedených pokynů a přidejte skrytá pole email, secure a doc_id. Do pole email vložte e-mailovou adresu uživatele a do pole doc_id hodnotu all. Po otevření stránky uvidí seznam všech svých dokumentů s možností jejich stažení. Pokud uživatel již formulář vyplnil, místo formuláře se zobrazí jeho dokument. Pole email by mělo být skryté a automaticky vyplněné vaší CMS.