Obligatoire, le nom que vous souhaitez donner à votre formulaire
Catégorie
PLUS NECESSAIRE / Optionnel / Il est dorénavant possible de rassembler dans un même rendu les fiches en provenance de deux (ou plusieurs) formulaires différents simplement en mettant id="1,2" (par exemple)
Ancienne doc=> catégorie à laquelle appartient le formulaire, texte libre. (ex: dans une catégorie annuaire, on peut avoir un formulaire personne physique et un autre personne morale. Le fait d'utiliser les catégories permettra ensuite par exemple d'afficher dans une carte toutes les fiches de cette catégorie)
Description
Optionnel, permet de décrire le formulaire à la personne qui va le remplir, texte libre.
Condition de saisie
Optionnel, affiche un message du type "Vous devez accepter les conditions suivantes ..." avant saisie ou modification d'une fiche.
Nom de la classe CSS
Optionnel, pour les webdesigners, ajoute une classe CSS pour personnaliser le graphisme de ce type de formulaire
Template
Obligatoire, c'est la partie la plus importante, et la plus bizarre : c'est là que vous collez le code des champs souhaités et qui sont listés ci dessous : Vous pouvez choisir pour chaque élément du formulaire, les valeurs que vous souhaitez. En particulier vous pourrez placer dans Template la description de chaque champ : voir le détail ci-dessous
Types de champs possibles
Comment ajouter des champs dans vos formulaires ?
L'espace Template de votre formulaire permet de décrire l'ensemble des champs dont vous avez besoin, à raison d'un champ par ligne.
Exemple d'une ligne de code permettant de créer un champ "texte".
Nous allons détailler la description d'un champ typique. Vous pourrez par la suite la modifier pour l'adapter à vos besoins en comprenant comment elle fonctionne :
Pour comprendre cette ligne cabalistique, observez qu'elle propose 13 zones paramétrables séparées par trois étoiles comptez la position de la zone et lisez ci-dessous sa description
Chaque zone sert-elle toujours à la même chose ?
Certaines des zones sont :
génériques : elles servent toujours à la même chose (par exemple la première zone sert toujours à indiquer le type de champ) ;
quasi-génériques : la zone sert pratiquement toujours à la même chose pour tous les types de champs à quelques exceptions près ;
spécifiques : la zone sert à donner des informations différentes suivant le type de champ (texte, bouton, etc.) ;
L'utilisation de chacune des treize zones (cliquez pour voir)
Type de champ (générique) : texte (chaque type de champ possède sa description) attention, une "fote", une majuscule provoquera une erreur au niveau de ce champ
Identifiant du champ (quasi générique) : bf_contact (sans accents, tout attaché)
Nous vous conseillons de garder les intitulés proposés. Si vous les changez, cela pourra poser des problèmes dans les modes de restitutions
Si vous utilisez un autre champ de ce type dans le même formulaire, l'identifiant du champ devra être différent
Si vous modifiez cet identifiant alors que certaines fiches ont été saisies, vous perdrez les données de ce champ des précédentes fiches)
Intitulé affiché (quasi générique) : Contact
Cette zone indique ce que vos utilisateurs verront à l'écran, suivi de deux point ":"
vous pouvez changer cet intitulé au cours de la vie de votre site sans incidences
Taille à l'écran (spécifique) : 15 (caractères)
Nombre de caractère max (spécifique) : 15
Valeur par défaut (spécifique) : non renseigné
ici Non-utilisé : dans certains types de champs, toutes les zones ne sont pas utilisées, dans ce cas, les laisser vide
ici Non-utilisé
Saisie obligatoire (quasi générique) : 1 (champ obligatoire) 0 ou vide (pas d'obligation)
Présence dans le moteur de recherche (quasi générique) : 1 (utilisé dans les recherches) 0 ou vide (pas utilisé)
Texte d'aide à la saisie (quasi générique) : ce qui est écrit dans cette zone deviendra une bulle d'aide visible lorsque l'utilisateur cliquera sur un petit point d'interrogation bleu
Droits d'accès au contenu du champ. (NON FONCTIONNEL avant Doryphore) Même fonctionnement que pour les droits d'accès aux pages : le contenu de ce champ permet de réserver en lecture l'accès à son contenu : * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins). Ici le champ indique un accès au groupe des administrateurs uniquement (@admins). Il est possible de combiner plusieurs groupes en les séparant par des espaces.
Droits d'accès à la saisie du champ. (quasi générique) Même fonctionnement que pour les droits d'accès aux pages : le contenu de ce champ permet de réserver l'écriture dans ce champ du formulaire : * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins). Ici le champ indique un accès au groupe des administrateurs uniquement (@admins). Il est possible de combiner plusieurs groupes en les séparant par des espaces.
nb : si vous voyez le code suivant dans votre template de formulaire, les champs manquant seront proposés avec leurs valeurs par défaut
texte***bf_contact***Contact
Pour les retrouver, il suffira d'ajouter les zones paramétrables grâces aux petites étoiles
texte***bf_titre***Titre de l'événement***255***255*** *** *** ***1***0***
Affichage dans le formulaire de saisie :
Une entrée contenant le champ bf_titre est obligatoire!!
Pour aller plus loin
Il est possible de générer ce champ bf_titre de manière automatique en concaténant 2, 3 ou plus de champs dans ce cas, il ne faut pas qu'un champs avec l'identifiant bf_titre soit déjà présent Syntaxe :
dans ce cas : le titre généré est le nom puis le prénom séparé d'un tiret. Si vous souhaitez mettre des listes, indiquez s'il s'agit de liste ou checkbox comme dans l'exemple.
champs_mail***bf_mail***Email***40***255*** *** *** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension
Le champ en 7ème position s'il est rempli avec form rendra invisible le mail et le remplacera par un petit formulaire de contact direct.
champs_mail***bf_mail***Email***40***255*** ***form*** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension
Le champs en 10ème position permet s'il vaut 1 d'envoyer par mail le contenu du formulaire à l'adresse mail renseignée dans ce champ / cela permet donc d'envoyer aux gens une copie mail du formulaire qu'ils viennent de remplir par ex)
champs_mail***bf_mail***Email***40***255*** ***form*** ***0***1***l'adresse mail doit être de la forme quelquechose@domaine.extension
Le champs en 12ième position permet de réserver la lecture de l'adresse au groupe des admins
champs_mail***bf_mail***Email***40***255*** *** *** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension***@admins
Attention, ces mails peuvent tomber dans les spam !!
Cartographie permettant de positionner automatiquement l'adresse
Attention Il faut obligatoirement un champ adresse contenant bf_adresse1 (ou bf_adresse2) et/ou bf_ville et/ou bf_pays disponible pour effectuer la géolocalisation
Affichage dans le formulaire de saisie :
Pour changer le centre et le niveau de zoom par défaut de la carte dans le formulaire (c' est à dire la carte que les gens voient lorsqu'ils veulent valider/déplacer le marker) => DocumentationFichierDeConfiguration
Date et heure
Exemple de syntaxe à copier/coller :
jour***bf_date_debut_evenement***Début de l'événement***1*** *** *** *** ***1***0
jour***bf_date_fin_evenement***Fin de l'événement***1*** *** *** *** ***1***0
Type de champ : jour
Identifiant du champ : bf_date_debut_evenement
Intitulé affiché : Début de l'événement
Non-utilisé
Non-utilisé
indiquer today ici permet d'afficher par défaut la date du jour
Non-utilisé
Non-utilisé
Saisie obligatoire : 1 (oui)
Non-utilisé
Syntaxe :
Affichage dans le formulaire de saisie :
Image jointe (avec redimensionnement automatique)
image***bf_image***Image de présentation (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png
Type de champ : image
Identifiant du champ : bf_image (sans accents, tout attaché)
Intitulé affiché : image de présentation (facultatif)
Hauteur de la vignette : 140 (en px)
Largeur de la vignette : 140 (en px)
Hauteur de l'image redimensionnée : 600 (en px)
Largeur de l'image redimensionnée : 600 (en px)
Classe css associée à l'image : right (ou center ou left)
Saisie obligatoire : 0 (non)
Présence dans le moteur de recherche : non renseigné (non).
Texte d'aide à la saisie : Votre image doit être au format .jpg ou .gif ou .png, ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Affichage dans le formulaire de saisie :
Lien internet (pourra être cliqué dans la fiche)
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0***Le lien doit être valide
Affichage dans le formulaire de saisie :
Checkbox / cases à cocher (plusieurs choix parmi des propositions)
Exemple de syntaxe à copier/coller :
checkbox***ListeFormations***Type de formation*** ***1*** *** *** ***1***1***
Type de champ : checkbox
Identifiant du champ : ListeFormations Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
Intitulé affiché : Type de formation
Non-utilisé
Valeur par défaut : l'élément dont l'identifiant est 1.
Non-utilisé
Identifiant de la liste (si la même liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
Choix du mode auto-complétion : vide (cases à cocher), tags (auto-complétion)
Saisie obligatoire : 0 (non).
Présence dans le moteur de recherche : 0 (non).
Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)
Affichage dans le formulaire de saisie :
Pour aller plus loin Si vous souhaitez que votre checkbox soit alimentée non pas par une liste mais par le contenu d'un autre formulaire bazar c'est possible via cette syntaxe :
checkboxfiche***id formulaire concerné***libellé qui doit apparaître*** *** *** *** *** ***1***0***
Identifiant du champ : ListeDepartementsFrancais Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
Intitulé affiché : Département
Non-utilisé
Non-utilisé
Valeur par défaut : l'élément dont l'identifiant est 1. si vous laissez ce champ vide, sera affiché "choisir"
Identifiant de la liste (si la même liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
Non-utilisé
Saisie obligatoire : 0 (non).
Présence dans le moteur de recherche : 0 (non).
Texte d'aide à la saisie : Lister les formations ici. ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)
radio***ListeFormations***Type de formation*** ***1*** *** *** ***1***1***
Type de champ : radio
Identifiant du champ : ListeFormations Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
Intitulé affiché : Type de formation
Non-utilisé
Valeur par défaut : l'élément dont l'identifiant est 1.
Non-utilisé
Identifiant de la liste (si la liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
Non-utilisé
Saisie obligatoire : 0 (non).
Présence dans le moteur de recherche : 0 (non).
Texte d'aide à la saisie : non renseigné.
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)
Identifiant du champ : bf_contact (sans accents, tout attaché)
Intitulé affiché : Contact
Taille à l'écran : 15 caractères
Nombre de caractère max : 15 caractères
Valeur par défaut : ici non renseigné, si texte alors il sera proposé par défaut
Non-utilisé
Non-utilisé
Saisie obligatoire : 1 (oui) 0 ou vide (non)
Présence dans le moteur de recherche : 0 (non)
Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Identifiant du champ : bf_description (sans accents, tout attaché)
Intitulé affiché : Formations proposées
Largeur de la zone de saisie : 80 caractères
Nombre de lignes de la zone de saisie : 5 lignes (attention au delà la case commence à être trop haute)
Valeur par défaut : non renseigné
Non-utilisé
Format d'écriture : wiki (par défaut, syntaxe wiki) html (propose un éditeur wyzywig), ou nohtml (html non interprété)
Saisie obligatoire : 0 (non).
Présence dans le moteur de recherche : non renseigné (non).
Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Upload de fichier (envoi de fichier)
Permet de joindre un fichier à une fiche.
Exemple de syntaxe à copier/coller :
fichier***bf_fichierstage***Documents produits lors du stage***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
Explication :
Type de champ : fichier
Identifiant du champ : bf_fichierstage (sans accents, tout attaché)
Intitulé affiché : Documents produits lors du stage
Taille maximum du fichier : 2000000 (20 mega, c'est beaucoup !).
Non-utilisé
Non-utilisé
Non-utilisé
Non-utilisé
Saisie obligatoire : 0 (non)
Présence dans le moteur de recherche : non renseigné (non).
Texte d'aide à la saisie : ne pas dépasser 20 Mo, ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Mot-clés / tags
Permet d'entrer des mots-clés dans le champ.
Chaque mot-clé est validé par la touche "entrée"
Exemple de syntaxe à adapter :
tags***bf_tags***Trois mots-clés que Yeswiki vous inspire***150***1*** *** *** ***0***1***Appuyer sur la touche "Entrée" pour séparer les mots-clés
En image
Pour complexifier
Proposer l'inscription à une liste de discussion / diffusion
inscriptionliste***info@gcn-quinoa.org***Je souhaite m'inscrire à la liste pour recevoir des informations sur le réseau***bf_mail***ezmlm***
Explication des zones
Type de champ : inscriptionliste
adresse de la liste : l'adresse de la mailing liste que vous avez précédemment crée (via votre hébergement, via framaliste...)
Intitulé affiché : Je souhaite m'inscrire à la liste pour recevoir des informations sur le réseau
Mail à inscrire : indique le champ utilisé dans le formulaire pour inscrire l'adresse mail. Pr défaut bf_mail
gestionnaire de liste : indique quel logiciel est utilisé pour la liste. par exemple : ezmlm (pour des listes crées chez OVH), sympa (pour des framalistes)
Affichage dans le formulaire de saisie :
Mettre un titre ou du texte au sein d'un formulaire (en mode saisie ou vue)
On peut écrire ce que l'on veut en langage HTML! (par exemple, pour mettre un titre : <h3>nom du titre</h3>)
On écrit 2 fois le titre : la première fois c'est pour apparaître dans la saisie, la deuxième fois c'est pour la visualisation de la fiche
Cacher des champs en mode vue (mais pas lors de l'encodage)
Il s'agit d'une utilisation détournée de labelhtml
d'abord on ouvre un label html de ce type
labelhtml***<div style="display:none">*** *** ***
Ensuite on place les champs qui doivent être encodés mais pas vus ensuite / par ex :
jour*bf_date_debut_publication*Date de publication*1* * * * *1*0
jour*bf_date_fin_publication*Date de déplubication*1* * * * *1*0
on ferme le labelhtml
labelhtml***</div> *** *** ***
Créer un utilisateur wiki dès la création d'une fiche de type inscription
utilisateur_wikini***bf_titre***bf_mail***
Attention, veiller à bien utiliser en complément cet autre champ (pour gérer les droits de la fiche-utilisateur créée) dans votre formulaire, écrit de la sorte
acls*** * ***user***user***
Question conditionnelle
Une question s'affiche seulement si un choix précis a été fait dans une liste ou un checkbox ou un radio précédent.
Dans ces 3 exemples (avec une liste et un checkbox et un radio), une première question propose de choisir parmi des compétences, et une seconde question s'affiche seulement si on choisit "autre" (écrit exactement comme ça comme clé dans la ListeCompetences).
Exemple 1 :
La liste propose une option "autre" qui, si elle est sélectionnée, fait apparaître une question texte pour préciser :
liste***listeListeCompetences***Compétences*** ***1*** *** *** ***1***1***
labelhtml***<div id="ListeCompetences_autre" style="display:none;">*** ***
textelong***bf_autrecompetence***Autre(s) compétence(s)***80***5*** *** ***wiki***0*** *** ***
labelhtml***</div> <!-- fin de la condition -->*** ***
Exemple 2 :
Le checkbox propose une option "autre" qui, si elle est cochée, fait apparaître une question texte pour préciser :
checkbox***ListeCompetences***Compétences*** ***1*** *** *** ***1***1***
labelhtml***<div id="checkboxListeCompetences_autre" style="display:none;">*** ***
textelong***bf_autrecompetence***Autre(s) compétence(s)***80***5*** *** ***wiki***0*** *** ***
labelhtml***</div> <!-- fin de la condition -->*** ***
Exemple 3 : (uniquement disponible à partir de doryphore 2021-10-25-3)
Le radio propose une option "autre" qui, si elle est choisie, fait apparaître une question texte pour préciser :
radio***ListeCompetences***Compétences*** ***1*** *** *** ***1***1***
labelhtml***<div id="radioListeCompetences_autre" style="display:none;">*** ***
textelong***bf_autrecompetence***Autre(s) compétence(s)***80***5*** *** ***wiki***0*** *** ***
labelhtml***</div> <!-- fin de la condition -->*** ***
Comment trouver le nom à placer dans le champ _id_ ?
1. identifier le champ qui va permettre de déclencher l'affichage
2. afficher une fiche du formulaire concerné (donc après création du formulaire) en ajoutant
/raw
à la fin de l'url de cette fiche
3. dans le texte ainsi affiché, reperer le champ concerné (exemple : checkboxListeCompetences, checkboxfiche4, checkboxfiche5bf_form, listeListeCompetence...) et bien le noter
4. Trouver la clé associée à l'entrée voulue :
pour les listes ou les checkbox : dans la page BazaR concernant les listes, consulter la liste concernée et noter la clé associée à la valeur retenue
pour les formulaires : noter le nom de la fiche associée (id_fiche)
5. revenir dans la modification du formulaire, onglet code et mettre :
Afficher un formulaire de saisie un peu long sur plusieurs onglets
Il faut intégrer plusieurs éléments dans la constitution du formulaire comme le montre l'exemple ci-dessous pour 3 onglets : NB : Les noms des onglets (Onglet 1, Onglet 2, Onglet 3) peuvent être modifiés dans les différentes occurrences ci-dessous, l'exemple est également transposable pour seulement 2 onglets ou plus de 3.
Affiche un bouton pour revenir à l'onglet 2 et un bouton pour enregistrer la fiche :
labelhtml***<a class="btn btn-lg btn-primary pull-left" href="#menu2" role="tab" data-toggle="tab"> <i class="glyphicon glyphicon-chevron-left"></i>Onglet 2</a><button class="pull-right btn btn-lg btn-success bouton_sauver" name="valider" type="submit">Enregistrer</button><!--Affiche un bouton pour revenir à l'onglet 2 et un bouton pour enregistrer la fiche-->*** ***
Ferme l'ensemble des onglets et efface les boutons Valider/Annuler en bas de chaque onglet :
labelhtml***<div class="clearfix"></div></div><!-- ferme l'onglet 3 --> </div><!-- ferme l'ensemble des onglets --><style>#formulaire .form-actions { display:none; }</style><!--Efface les boutons Valider/Annuler en bas de chaque onglet-->*** ***
Attention Si un des onglets comprend un champ carto et qu'à l'affichage il manque des tuiles à la carte, il faut ajouter le code suivant (à tous les liens qui mènent à l'onglet dans tab et boutons précédent suivant )
Pour insérer plusieurs accordions :
Si vous voulez une 3ème, 4ème... accordion, pensez à personnaliser les parties écrites en majuscules dans le code (par ex COLLAPSE3 ou ACCORDION3...)
Pour comprendre : Un champs mail permanent est intégré, c'est un champs "adresse mail" dont le contenu est pré-remplis avec notre propre adresse mail ... mais il est rendue invisible lors de la saisie grâce à l'action "cacher des champs en mode vue".
Il est également invisible pour l'utilisateur qui reçoit sa fiche grâce au paramètre de confidentialité définis sur"@admins"
Mot de passe
mot_de_passe***bf_cache***mot de passe***
Bookmarklet
bookmarklet***Veille cooperative***Copier ce bookmark***bf_url***
Afficher les fiches qui pointent vers une fiche
Type de champ : listefichesliees
id du formulaire lié :
query : peut rester vide
param de l'action : champs="bf_nom" ordre="desc"
nombre de fiche : nombre maximum de fiche à afficher - peut rester vide
template de restitution : liste_liens.tpl.html par exemple
type de fiche liee : checkbox pour checkboxfiche , rien pour listefiche
