Modulo di creazione
Creazione automatica di file sul tuo sito - diplomi, certificati o altro. Ai visitatori del tuo sito basterà compilare il modulo e ricevere il file.
Per la creazione di file è necessario creare un modulo HTML sul tuo sito. Se ciò non è possibile, basta utilizzare il widget di creazione.
Creazione del modulo
Per inviare richieste di creazione file a DiMaker, è necessario creare un modulo sul tuo sito. Questo modulo può essere collocato sia nella parte pubblica che in quella privata del tuo sito. Utilizzando il tuo CMS, crea una pagina e il modulo sulla pagina.
Action del modulo
https://dimaker.app/api/v1/webform-create/Campi del modulo
È necessario creare diversi campi nascosti con i seguenti valori:
-
secure*
Token (stringa, 36 caratteri)
-
doc_id*
ID del documento (stringa, 36 caratteri) utilizzata per la creazione del file. L'ID può essere ottenuto nella barra degli indirizzi quando il documento è aperto. Il documento non deve essere nel cestino, ma può essere in qualsiasi cartella Documenti.
-
mail_id
ID del template email (stringa, 36 caratteri) per l'invio tramite posta elettronica. L'ID può essere ottenuto nella barra degli indirizzi quando il template è aperto. Se la variabile non è trasmessa, l'email non verrà inviata.
-
email_send
Orario di invio dell'email con il file. Può assumere i seguenti valori:
onfinish - Inviare tutte le email dopo la creazione di tutti i file (predefinito)
oncreate - Inviare le email subito dopo la creazione del file. In caso di creazione di un solo file, onfinish e oncreate sono identici.
timeout - Inviare le email dopo un intervallo di tempo. In tal caso, è necessario fornire anche due parametri aggiuntivi:
email_timeout_value - valore numerico dell'intervallo, dopo il quale inviare le email, valore intero
email_timeout_unit - unità di misura dell'intervallo. Può assumere il valore "m" (minuti), "h" (ore), "d" (giorni).
Oppure, per indicare l'orario esatto di invio, è necessario fornire l'orario in formato unix time in email_timeout_timestamp. Se vengono forniti timeout e email_timeout_timestamp, la priorità sarà data a quest'ultimo. -
storage_period
Tempo di archiviazione dei file nel Disco. Se il parametro non è specificato, i file vengono conservati in modo permanente, fino alla cancellazione manuale. Per la cancellazione dopo un intervallo di tempo, deve assumere il valore:
timeout. In tal caso, è necessario fornire anche due parametri aggiuntivi:
storage_period_timeout_value - valore numerico dell'intervallo, dopo il quale eliminare i file, valore intero
storage_period_timeout_unit - unità di misura dell'intervallo. Può assumere il valore "m" (minuti), "h" (ore), "d" (giorni).
Oppure, per indicare l'orario esatto di eliminazione, è necessario fornire l'orario in formato unix time in storage_period_timeout_timestamp. Se vengono forniti storage_period_timeout_value e email_timeout_timestamp, la priorità sarà data a quest'ultimo. -
folder_id
ID della cartella nel Disco (stringa, 36 caratteri) per il salvataggio dei file. Se la cartella non esiste, sarà creata automaticamente al momento della creazione del primo file.
-
page_id
Numero d'ordine della pagina (numero o stringa), se nel documento ci sono più pagine. È possibile trasmettere un numero (la prima pagina è 0), o numeri (separati da una virgola) delle pagine che devono essere utilizzate per la creazione del file.
Inviare a se stesso il file dopo la creazione
Il file verrà inviato all'indirizzo email dell'account subito dopo essere stato creato. Nel campo "Template email" è possibile scegliere quale template utilizzare per l'invio. In precedenza è possibile creare un template separato per l'invio delle email all'account nella sezione Template email. Se nel testo dell'email si scrive la variabile %data, in quel punto saranno inseriti tutti i dati del file sotto forma di tabella.
Script e stili
Sulla pagina di integrazione è necessario prendere il codice e inserirlo nell'HEAD o in qualsiasi altra parte della pagina. Non è necessario inserire questo codice in tutte le pagine del sito. È necessario inserire questo codice solo nella pagina con il modulo.
Inoltre, è necessario creare due blocchi con id result-success e result-danger. Entrambi i blocchi sono nascosti, con stile display:none; Nel primo blocco puoi scrivere il testo per la creazione avvenuta con successo del file. Questo blocco verrà mostrato in caso di richiesta riuscita. Se si verifica un errore, verrà visualizzato il blocco con id result-danger. Il testo dell'errore verrà inserito automaticamente nel blocco.
Sostituzione nel documento
Nel documento deve esserci almeno una variabile da sostituire, ad esempio %name o %course. Aggiungi nel modulo un campo, dove il nome della variabile deve iniziare con mask_, ad esempio mask_name o mask_course. I dati inseriti dai visitatori in questi campi verranno sostituiti con le rispettive variabili nel testo del documento. Per indicare l'indirizzo email utilizza la variabile mask_email. Per l'invio di email a più indirizzi, inseriscili separati da una virgola o uno spazio. Tuttavia, lo stato di invio nel Disco sarà riportato sul primo indirizzo.
Funzionamento del modulo
Dopo aver creato il modulo, puoi aprire la pagina pubblicata e verificare il funzionamento del modulo. Verrà creato un file e mostrato in una finestra pop-up per il download.
Un documento = una compilazione
All'occorrenza, puoi limitare il numero di compilazioni del modulo. Se all'email indicata è già stato creato un file con doc_id, verrà visualizzato un avviso che è possibile creare solo un file.
I miei documenti
Puoi visualizzare i documenti di una persona nella parte privata del tuo sito. Per farlo, crea un modulo come indicato sopra. Poi aggiungi i campi nascosti email, secure e doc_id. Nel primo campo, inserisci l'indirizzo email del visitatore e nel campo doc_id inserisci il valore all. All'apertura di questa pagina, il visitatore vedrà al posto del modulo un elenco di tutti i documenti con la possibilità di scaricarli. Se vuoi che qualora il visitatore avesse già compilato il modulo, al posto del modulo venga mostrato il suo file, il campo email del modulo deve essere nascosto e inserito automaticamente dal tuo CMS.