Créer un formulaire

Pour créer un formulaire dans Yeswiki, il faudra vous rendre dans la roue crantée / base de donnée.
Avant de vous lancer, pensez bien à ce que vous souhaitez récolter et surtout pourquoi vous souhaitez ces infos. Faites aussi attention au RGPD.

Que se passe-t-il lorsque j'utilise le constructeur graphique de formulaire bazar ?

Lorsqu’on crée ou modifie un formulaire bazar, deux méthodes nous sont offertes. La méthode par défaut dans doryphore est le constructeur graphique.

image dcfhabjikckbbnbi.png (9.7kB)
Celui-ci permet de construire son formulaire de manière relativement intuitive sans avoir recours à du code puisque son rôle est justement d’écrire le code pour vous.

Il est cependant parfois utile de comprendre ce qui se passe derrière. Nous allons donc l’illustrer avec deux exemples, le cas d’un champ texte, et celui d’un groupe de cases à cocher.

Tout d’abord, quelques petites règles simples :
  • à chaque champ placé dans le constructeur graphique, correspond une ligne dans l’onglet « code » ;
  • l’ordre est le même dans les deux onglets (les champs dans le constructeur graphique sont dans le même ordre que les lignes correspondantes dans l’onglet « code » ;
  • chaque ligne de code est composée de plusieurs paramètres et ces différents paramètres sont séparés par des groupes de trois astérisques (***) ;
  • le premier de ces paramètres indique toujours le type de champ.

Voyons maintenant ce qui se passe dans le cas d’un champ texte.

L’image ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un champ texte se retrouve dans la ligne correspondante du code.

image alpdkgehbbnibiem.png (0.3MB)


Si on regarde la ligne de code (on se rappelle que les différents paramètres sont délimités par ***) on constate, par exemple, que :
  • le 1er paramètre contient bien le type de champ,
  • dans le 2e on retrouve le nom du champ,
  • le libellé du champ est dans le 3e paramètre,
  • les 4e et 5e paramètres contiennent les nombres de caractères affichés et maximum respectivement,
  • le 9e paramètre indique que le champ est obligatoire (« 1 »),
  • le 11e paramètre contient le texte d’aide,
  • le 12e paramètre indique que le champ peut être lu par tout le monde (« * »).

Tous ces détails et bien d’autres encore se trouvent sur la page https://yeswiki.net/?ChampsPossibles

Regardons à présent les différences dans le cas d’un champ de type groupe de cases à cocher.

L’image ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un groupe de cases à cocher se retrouve dans la ligne correspondante du code.

image oeimcnmcfckahabb.png (0.1MB)

Le comportement est identique à celui que l’on a vu pour un champ de type texte à la différence de :
  • le 1er champ dans le constructeur graphique (intitulé «nom») est vide et n’a pas de correspondance dans la ligne de code ;
  • le 2e paramètre de la ligne de code contient le nom de la liste utilisée pour ce groupe de cases à cocher ;

La page de référence pour retrouver le rôle de chacun des paramètres des codes de champ bazar est : https://yeswiki.net/?ChampsPossibles
Présentation dans le constructeur graphique
Ca fait quoi ?
Où chercher dans yeswiki.net/?ChampsPossibles
et (type de champ) dans l'onglet « code »

image 1textecourt.png (3.7kB)
Une question à laquelle on répond en tapant un texte court (une ligne)
"Texte court"
(texte)

image 2zonedetexte.png (4.6kB)
Une question à laquelle on répond en tapant un texte long (plusieurs lignes)
"Texte long"
(textelong)

image 3image.png (3.0kB)
Une question à laquelle on répond en téléchargeant une image
"Image jointe"
(image)

image 4uploadfichier.png (5.3kB)
Une question à laquelle on répond en téléchargeant un fichier
"Upload de fichier"
(fichier)

image 5email.png (2.4kB)
Une question à laquelle on répond en tapant une adresse mail
"Adresse mail"
(champs_mail)

image 6motscls.png (4.4kB)
Une question à laquelle on répond en tapant un ou plusieurs mots-clés
"Mots-clés / tags"
(tags)

image 8champdetypehidden.png (7.2kB)
Une indication invisible qui permet d'entrer des variables sans que le contributeur ne le fasse.
Exemple : champ hidden bf_pays=france ce qui permet que toutes les adresses saisies soient cherchées en france
"Champ caché"
(champs_cache)

image 9Selectionner.png (4.7kB)
Une question à laquelle on répond en sélectionnant une réponse parmi plusieurs pré-écrites
"Liste déroulante"
(liste)

image 91groupedecasesacocher.png (7.8kB)
Une question à laquelle on répond en cochant une ou plusieurs réponses parmi plusieurs pré-écrites
"Checkbox / cases à cocher"
(checkbox)

image 92groupedeboutonsradio.png (7.4kB)
Une question à laquelle on répond en cochant une seule réponse parmi plusieurs pré-écrites et visibles
"Radio"
(radio)

image 93champdate.png (4.9kB)
Une question à laquelle on répond en saisissant une date (voire une heure)
"Date et heure"
(listedatedeb)

image 94geolocalisation.png (7.9kB)
Une carte avec un bouton invitant à positionner le point à partir d'une adresse et/ou ville et/ou pays saisi(s) par ailleurs
"Cartographie permettant de positionner automatiquement l'adresse "
(carte_google)

image 95inscriptionlistediffusion.png (6.8kB)
Une case à cocher pour accepter l'inscription d'une adresse mail saisie par ailleurs à une mailing-liste
"Proposer l'inscription à une liste de discussion / diffusion"
(inscriptionliste)

image 96customhtml.png (4.8kB)
Du texte (titre ou pas) visible dans le formulaire et/ou les fiches
"Mettre un titre ou du texte au sein d'un formulaire"
(labelhtml)

image 97crerunutilisateur.png (8.9kB)
Demande la saisie d'un mot de passe et crée un compte utilisateur, à partir d'un nom et d'une adresse mail saisis par ailleurs
"Créer un utilisateur wiki dès la création d'une fiche"
(utilisateur_wikini)


image 98configdroitsdacces.png (8.0kB)
Configure les droits d'accès des fiches
"Gérer les droits dès la création de la fiche"
(acls)


image 99configtheme.png (7.6kB)
Configure le thème graphique des fiches
"Associer un thème dès la création de la fiche"
(metadatas)

image 911bookmarklet.png (4.4kB)
Permet de générer un bouton à glisser dans la barre de menu de son navigateur pour saisir directement cette fiche bazar depuis celui-ci sans avoir à aller sur le wiki.
"Bookmarklet"
(bookmarklet)

image 912listedesfichesliees.png (5.5kB)
Génère une liste de toutes les fiches bazar qui pointent vers cette fiche.
Exemple : on a des fiches produit et des fiches producteurs, on peut ici pointer tous les producteurs qui vendent ce produit. Dans ce cas, il faut que les checkbox ou listes pointent vers un autre formulaire bazar et non vers des listes.
"Afficher les fiches qui pointent vers une fiche"
(listefichesliees)

image 913titreautomatique.png (5.6kB)
Genère un titre de fiche à partir de réponses saisies par ailleurs
Exemple : on a un bf_nom, bf_prenom et bf_structure, avec titre automatique, on peut faire un bf_titre qui soit la concaténation de tous ces éléments
encadré « pour aller plus loin » dans « Titre : texte court qui donnera le nom à la fiche »
(titre)

image 914custom.png (3.9kB)
Un code sur mesure pour les développeurs
Nulle part, c'est nouveau !

Gatien Bataille Sylvain Boyer