Formulaire de création
Création automatique de fichiers sur votre site – diplômes, certificats ou autres documents. Vos visiteurs n'auront qu'à remplir un formulaire pour obtenir leur fichier.
Pour générer les fichiers, il est nécessaire de créer un formulaire HTML sur votre site. Si cela n'est pas possible, utilisez simplement le widget de création.
Création du formulaire
Pour envoyer des requêtes de création de fichiers à DiMaker, vous devez configurer un formulaire sur votre site. Ce formulaire peut être placé dans une section publique ou privée de votre site. À l'aide de votre CMS, créez une page et insérez-y le formulaire.
Action du formulaire
https://dimaker.app/api/v1/webform-create/
Champs du formulaire
Vous devez créer plusieurs champs cachés avec les valeurs suivantes :
-
secure*
Jeton (chaîne de caractères, 36 caractères)
-
doc_id*
ID du document (chaîne, 36 caractères) utilisé pour créer le fichier. Vous pouvez trouver cet ID dans la barre d'adresse lorsque le document est ouvert. Le document ne doit pas être dans la corbeille, mais il peut se trouver dans n'importe quel dossier Documents.
-
mail_id
ID du modèle d'e-mail (chaîne, 36 caractères) utilisé pour les envois. Cet ID se trouve dans la barre d'adresse lors de l'ouverture du modèle. Si ce paramètre n'est pas transmis, aucun email ne sera envoyé.
-
email_send
Le moment d'envoi de l’email avec le fichier. Les options possibles sont les suivantes :
onfinish – Envoyer tous les emails après la création de tous les fichiers (par défaut)
oncreate – Envoyer les emails immédiatement après la création de chaque fichier. Dans le cas d’un seul fichier, onfinish et oncreate agissent de manière identique.
timeout – Envoyer les emails après un certain délai. Dans ce cas, deux autres paramètres doivent être ajoutés :
email_timeout_value – Une valeur numérique représentant l'intervalle de temps avant l'envoi (nombre entier)
email_timeout_unit – L’unité de mesure de l'intervalle : "m" (minutes), "h" (heures), "d" (jours).
Ou, pour spécifier un horaire précis, utilisez le format UNIX pour indiquer le temps dans email_timeout_timestamp. Si à la fois timeout et email_timeout_timestamp sont présents, le dernier aura priorité. -
folder_id
ID du dossier sur le Cloud où seront enregistrés les fichiers (36 caractères). Si le dossier n'existe pas, il sera créé automatiquement lors de la création du premier fichier.
-
page_id
Numéro de la page (nombre ou chaîne) si le document contient plusieurs pages. Vous pouvez indiquer un seul numéro de page (première page – 0) ou plusieurs numéros, séparés par une virgule, pour les pages à utiliser pour générer le fichier.
Recevoir le fichier par email après sa création
Le fichier sera envoyé à l'adresse email de votre compte immédiatement après sa création. Dans le champ « Modèle d'e-mail », vous pouvez spécifier le modèle d’email à utiliser pour l'envoi. Vous pouvez créer un modèle spécifique dans la section Modèles d’emails à cet effet. Insérez la variable %data dans le texte de l'e-mail pour y intégrer toutes les informations du fichier sous forme de tableau.
Script et styles
Rendez-vous sur la page d'intégration, copiez le code proposé et insérez-le dans le HEAD ou tout autre emplacement de votre page. Ce code ne doit pas être inclus dans toutes les pages de votre site, mais exclusivement sur la page contenant le formulaire.
En outre, il est nécessaire de créer deux blocs avec les IDs result-success et result-danger. Ces blocs doivent rester masqués avec un style display:none. Le bloc result-success affichera un message de succès lorsque le fichier sera créé avec succès. Si une erreur survient, le bloc result-danger sera affiché avec le message d’erreur automatiquement inséré.
Remplacement de variables dans le document
Votre document doit contenir au moins une variable pour remplacement, comme %name ou %course. Ajoutez des champs dans le formulaire avec des noms commençant par mask_, par exemple mask_name ou mask_course. Les données saisies par vos visiteurs seront substituées aux variables correspondantes dans le contenu du document. Pour l'adresse e-mail, utilisez la variable mask_email. Pour envoyer des emails à plusieurs adresses, séparez-les par une virgule ou un espace. Le suivi des envois dans le Cloud affichera l'état en fonction de la première adresse.
Fonctionnement du formulaire
Après avoir créé le formulaire, ouvrez la page publiée et testez son fonctionnement. Un fichier sera généré et une fenêtre contextuelle de téléchargement s’affichera.
Un fichier par formulaire
Vous pouvez restreindre les soumissions à un seul fichier par e-mail. Si un fichier avec le même doc_id a déjà été généré pour l’email indiqué, un message d'avertissement sera affiché précisant que seule une copie peut être créée.
Mes documents
Vous pouvez afficher les documents d'un utilisateur dans une section protégée de votre site. Pour cela, configurez le formulaire comme décrit précédemment. Ajoutez ensuite des champs cachés pour email, secure et doc_id. Configurez email avec l’adresse électronique du visiteur, et doc_id avec la valeur all. Lors de l’ouverture de cette page, le visiteur verra une liste de tous ses documents à télécharger, à la place du formulaire. Si le visiteur a déjà rempli le formulaire, le document correspondant sera affiché directement à la place du formulaire. L’adresse email devra être automatiquement renseignée par votre CMS.