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) 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).
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).
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 d'autres champs dans ce cas, il ne faut pas qu'un champs avec l'identifiant bf_titre soit déjà présent Syntaxe :
titre***{{bf_nom}} - {{bf_prenom}}*** ***
dans ce cas : le titre généré est le nom puis le prénom séparé d'un tiret
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
Non-utilisé
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***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 précédent.
Dans ces 2 exemples (avec une liste et un checkbox), 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***ListeCompetences***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 -->*** ***
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-->*** ***
Insérer un accordéon pour cacher certains champs
Utile par exemple pour simplifier un formulaire long.
Voici le bout de code à insérer dans votre fomulaire Attention : si plusieurs accordion, vérifier les id
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***
affiche les fiches qui pointent vers cette fiche
Type de champ : listefichesliees
id de la fiche liée :
query :
param de l'action : champs="bf_nom" ordre="desc"
nombre de fiche : nb="x"
template de restitution : template="liste_liens.tpl.html"
type de fiche liee : checkbox pour checkboxfiche , rien pour listefiche
