Modulo di Creazione
Creazione automatica di file sul tuo sito - diplomi, certificati o altro. Ai visitatori del tuo sito basterà compilare un modulo per ricevere il file.
Per generare i file è necessario creare un modulo HTML sul tuo sito. Se ciò non è possibile, può essere utilizzato il widget di creazione.
Creare un modulo
Per inviare richieste a DiMaker per la creazione di file, è necessario creare un modulo sul tuo sito. Questo modulo può essere posizionato sia nella parte pubblica che privata del tuo sito. Con l'aiuto del tuo CMS, crea una pagina e inserisci il modulo in essa.
Action del modulo
https://dimaker.app/api/v1/webform-create/Campi obbligatori
Devi creare alcuni campi nascosti con i seguenti valori:
-
secure*
Token (stringa di 36 caratteri)
-
doc_id*
ID del documento (stringa di 36 caratteri) che verrà utilizzato per generare il file. L'ID può essere ottenuto dall'URL quando il documento è aperto. Il documento non deve trovarsi nel cestino, ma può essere in qualsiasi cartella dei Documenti.
-
mail_id
ID del template email (stringa di 36 caratteri) per inviare il file via email. Questa variabile è opzionale, e se non viene fornita, l'email non verrà inviata.
-
email_send
Orario in cui inviare l'email con il file. Può assumere i seguenti valori:
onfinish - Invia tutte le email dopo la creazione di tutti i file (impostazione predefinita).
oncreate - Invia l'email immediatamente dopo la creazione del file. Se si crea un solo file, onfinish e oncreate sono equivalenti.
timeout - Invia le email dopo un certo lasso di tempo. In questo caso, è necessario specificare altri due parametri:
email_timeout_value - Valore numerico del lasso di tempo dopo il quale inviare le email, intero.
email_timeout_unit - Unità del lasso di tempo. Può essere "m" (minuti), "h" (ore), "d" (giorni).
Oppure, per indicare un orario preciso, specificare il timestamp in formato unix in email_timeout_timestamp. Se vengono forniti sia timeout che email_timeout_timestamp, quest'ultimo avrà la precedenza. -
folder_id
ID della cartella sul Disco (stringa di 36 caratteri) dove salvare i file. Se la cartella non esiste, sarà creata automaticamente al momento della generazione del primo file.
-
page_id
Numero del foglio (numero o stringa), se il documento ha più fogli. Puoi specificare un numero (il primo foglio è 0) oppure un elenco di numeri separati da virgola per indicare i fogli da utilizzare nella generazione del file.
Inviare il file al tuo indirizzo email
Il file sarà inviato all'indirizzo email del tuo account immediatamente dopo la creazione. Nel campo "Template email" puoi scegliere quale modello utilizzare per l'invio. In Template Email, puoi creare in anticipo un modello personalizzato per questi invii. Se nel corpo del messaggio inserisci la variabile %data, in quel punto verranno aggiunti i dati del file sotto forma di tabella.
Script e stili
Vai alla pagina di integrazione per ottenere il codice da inserire nell'HEAD o in un'altra posizione della pagina. Non è necessario inserire questo codice in tutte le pagine del sito, ma solo sulla pagina che ospita il modulo.
Inoltre, è necessario creare due blocchi con id result-success e result-danger. Entrambi i blocchi devono essere nascosti, con lo stile display:none; Nel primo blocco puoi scrivere un messaggio di successo che verrà mostrato quando la creazione del file avrà esito positivo. In caso di errore, verrà mostrato il blocco con id result-danger e il messaggio di errore sarà inserito automaticamente in questo blocco.
Sostituzione nel documento
Il documento deve contenere almeno una variabile per la sostituzione, ad esempio %name o %course. Aggiungi nei campi del modulo nomi come mask_name o mask_course. I dati inseriti dai visitatori in questi campi sostituiranno le variabili corrispondenti nel testo del documento. Per specificare un indirizzo email, usa la variabile mask_email. Per inviare email a più destinatari, inserisci più indirizzi separati da una virgola o spazio. Lo stato dell'invio nel Disco verrà visualizzato in base al primo indirizzo specificato.
Funzionamento del modulo
Dopo aver creato il modulo, puoi aprire la pagina pubblicata e verificarne il funzionamento. Verrà generato un file che apparirà in una finestra pop-up per il download.
Un documento = una compilazione
Se desideri, puoi limitare il numero di compilazioni del modulo. Se per un determinato indirizzo email è stato già generato un file con doc_id, verrà visualizzato un avviso che segnalerà che è possibile creare un solo file.
I miei documenti
Puoi mostrare i documenti di un utente nella parte privata del tuo sito. Per farlo, crea un modulo come descritto in precedenza. Aggiungi poi i campi nascosti email, secure e doc_id. Nel campo "email", inserisci l'indirizzo dell'utente; nel campo "doc_id", specifica il valore "all". Quando l'utente aprirà questa pagina, vedrà un elenco di tutti i documenti disponibili per il download. Se desideri che, nel caso in cui un utente abbia già compilato il modulo, il file venga mostrato al posto del modulo, il campo "email" deve essere nascosto e completato automaticamente dal tuo CMS.