Formulaire de création

Création automatique de fichiers sur votre site - diplômes, certificats ou autres. Il suffit que le visiteur de votre site remplisse le formulaire pour obtenir le fichier.

Pour créer les fichiers, vous devez créer un formulaire HTML sur votre site. Si cela n'est pas possible, veuillez simplement utiliser le widget de création.

Création du formulaire

Pour envoyer des requêtes de création de fichiers dans DiMaker, vous devez créer un formulaire sur votre site. Ce formulaire peut être situé dans la partie publique ou fermée de votre site. Grâce à votre CMS, créez une page et un formulaire sur la page.

Action du formulaire

Champs du formulaire

Vous devez créer plusieurs champs cachés avec les valeurs suivantes :

• secure*

  Token (chaîne, 36 caractères)

• doc_id*

  ID du document (chaîne, 36 caractères) à utiliser pour créer le fichier. Vous pouvez obtenir l'ID dans la barre d'adresse lorsque le document est ouvert. Le document ne doit pas être dans la corbeille, mais peut être dans n'importe quel dossier de Documents.

• mail_id

  ID du modèle d'email (chaîne, 36 caractères) pour l'envoi par email. Vous pouvez obtenir l'ID dans la barre d'adresse lorsque le modèle est ouvert. Si la variable n'est pas fournie, l'email ne sera pas envoyé.

• email_send

  Heure d'envoi de l'email avec le fichier. Peut prendre les valeurs suivantes :
  onfinish - Envoyer tous les e-mails après la création de tous les fichiers (par défaut)
  oncreate - Envoyer les e-mails immédiatement après la création du fichier. Lors de la création d'un seul fichier, onfinish et oncreate sont identiques.
  timeout - Envoyer les e-mails après un intervalle de temps. Dans ce cas, vous devez encore fournir deux paramètres :
  email_timeout_value - valeur numérique de l'intervalle après lequel envoyer les e-mails, valeur entière
  email_timeout_unit - unité de mesure de l'intervalle. Peut prendre la valeur "m" (minutes), "h" (heures), "d" (jours).
  Ou, pour spécifier une heure d'envoi exacte, vous devez fournir l'heure au format unix time dans email_timeout_timestamp. Si timeout et email_timeout_timestamp sont fournis, le dernier a la priorité.

• storage_period

  Durée de conservation des fichiers sur le Disque. Si le paramètre n'est pas renseigné, les fichiers sont conservés indéfiniment jusqu'à suppression manuelle. Pour une suppression après un certain temps, doit prendre la valeur :
  timeout. Dans ce cas, vous devez également fournir deux paramètres :
     storage_period_timeout_value - valeur numérique de l'intervalle après lequel supprimer les fichiers, valeur entière
     storage_period_timeout_unit - unité de mesure de l'intervalle. Peut prendre la valeur "m" (minutes), "h" (heures), "d" (jours).
  Ou, pour spécifier une heure de suppression exacte, vous devez fournir l'heure au format unix time dans storage_period_timeout_timestamp. Si storage_period_timeout_value et email_timeout_timestamp sont fournis, le dernier a la priorité.

• folder_id

  ID du dossier sur le Disque (chaîne, 36 caractères) pour sauvegarder les fichiers. Si le dossier n'existe pas, il sera créé automatiquement lors de la création du premier fichier.

• page_id

  Numéro de page (nombre ou chaîne) si le document comporte plusieurs pages. Vous pouvez fournir un seul numéro (la première page - 0) ou plusieurs numéros (séparés par une virgule) des pages à utiliser pour créer le fichier.

S'envoyer le fichier après création

Le fichier sera envoyé à l'adresse email du compte immédiatement après sa création. Dans le champ « Modèle d'email », vous pouvez choisir quel modèle utiliser pour l'envoi. Au préalable, dans Modèles de mails, vous pouvez créer un modèle séparé pour l'envoi de mails à l'adresse email du compte. Si vous écrivez la variable %data dans le texte du mail, toutes les données du fichier seront ajoutées à cet endroit sous forme de tableau.

Script et styles

Sur la page d'intégration, vous devez prendre le code et l'insérer dans HEAD ou à tout autre endroit de la page. Il n'est pas nécessaire d'insérer ce code sur toutes les pages du site. Il faut insérer ce code uniquement sur la page avec le formulaire.

De plus, vous devez créer deux blocs avec les identifiants result-success et result-danger. Les deux blocs sont cachés, avec le style display:none; Dans le premier bloc, vous pouvez écrire un texte pour la création réussie du fichier. Ce bloc sera affiché en cas de requête réussie. Si une erreur s'est produite, le bloc avec l'identifiant result-danger s'affichera. Le texte de l'erreur sera automatiquement inséré dans le bloc.

Substitution dans le document

Dans le document, vous devez avoir au moins une variable à remplacer, par exemple %name ou %course. Ajoutez dans le formulaire un champ où le nom de la variable doit commencer par mask_, par exemple mask_name ou mask_course. Les données saisies par le visiteur dans ces champs seront remplacées par les variables correspondantes dans le texte du document. Pour spécifier l'adresse email, utilisez la variable mask_email. Pour envoyer des emails à plusieurs adresses, indiquez-les en les séparant par des virgules ou des espaces. Dans ce cas, le statut d'envoi dans le Disque s'affichera avec la première adresse.

Fonctionnement du formulaire

Après avoir créé le formulaire, vous pouvez ouvrir la page publiée et vérifier le fonctionnement du formulaire. Un fichier sera créé et affiché dans une fenêtre contextuelle pour téléchargement.

Un document = un remplissage

Si vous le souhaitez, vous pouvez limiter le nombre de remplissages du formulaire. Si un fichier a déjà été créé avec le doc_id pour l'email indiqué, un avertissement s'affichera indiquant qu'un seul fichier peut être créé.

Mes documents

Vous pouvez afficher les documents d'une personne dans la partie fermée de votre site. Pour cela, créez un formulaire comme indiqué ci-dessus. Ensuite, ajoutez des champs cachés email, secure et doc_id. Dans le premier champ - l'adresse email du visiteur, et dans le dernier champ indiquez la valeur all. En ouvrant cette page, le visiteur verra à la place du formulaire la liste de tous les documents avec la possibilité de les télécharger. Si vous souhaitez que si le visiteur a déjà rempli le formulaire, alors à la place du formulaire, son fichier lui soit affiché, le champ email du formulaire doit être caché et automatiquement fourni par votre CMS.

Autres intégrations