diff --git a/docs/fr/bazar.md b/docs/fr/bazar.md index 8e58ae868..5a33428e2 100644 --- a/docs/fr/bazar.md +++ b/docs/fr/bazar.md @@ -447,7 +447,8 @@ NB : Dans l'exemple ci-dessus l'id du formulaire local est 5 et celui du formula 1. dupliquer le formulaire distant sur le ""YesWiki"" local en utilisant la fonctionnalité d'importation disponible en bas de la page ""BazaR"" 2. copier le fichier //fiche-x.tpl.html// dans le dossier local //custom/templates/bazar/// avec le nom //fiche-y.tpl.html// où y est le numéro du formulaire dupliqué en local 3. modifier le formulaire y en local en mode code en remplaçant, //z étant le numéro du formulaire distant// - ``` + +``` %%liste***...***...*** *** ***...%% par %%externalselectlistfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***liste***...%% %%listefiche***...***...*** *** ***...%% par %%externalselectentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***listefiche***...%% %%listefiches***...***...*** *** ***...%% par %%externallinkedentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***listefiches***...%% @@ -459,6 +460,7 @@ NB : Dans l'exemple ci-dessus l'id du formulaire local est 5 et celui du formula %%fichier***...***...*** *** ***...%% par %%externalfilefield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***fichier***...%% %%image***...***...*** *** ***...%% par %%externalimagefield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***image***...%% ``` + Dans l'exemple: - le formulaire concerné est *https://www.example.com|z* - la formule entrée *{{bazarliste id="https://www.example.com|z->y"}}* @@ -472,31 +474,58 @@ Dans l'exemple: ## Importer / exporter des données -Il est possible : -* d'importer des données externes (d'un tableur par exemple) dans un formulaire bazar -* d'exporter des données d'un formulaire bazar pour les utiliser ensuite dans un tableur classique +Afin de faciliter l'importation d'un certain nombre de fiches à la fois, il est possible d'importer dans un formulaire bazar des données organisés sous forme d'un tableur par exemple. +Ou encore d'exporter des données d'un formulaire bazar pour les utiliser ensuite dans un tableur. + +Prérequis : +* Disposer des accés administrateurs. +* Avoir accés à un logiciel de tableur tel que libre office calc. ### Étapes pour importer des données -* se connecter au wiki (il faut être parmi les administrateurs pour pouvoir importer des données) -* se rendre sur la page permettant la gestion des formulaires (elle contient l'action{{bazar}}) -* cliquer sur le bouton **importer** -* choisir parmi les formulaires celui dans lequel on souhaite importer des données + +* Se rendre sur la page permettant la gestion des formulaires (elle contient l'action{{bazar}}). Par défaut cette page se trouve en joignant "/?bazar" à l'URL de votre wiki tel que "https://monwiki.net/?Bazar" +* Cliquer sur l'onglet **importer** +* Choisir parmi les formulaires celui dans lequel on souhaite importer des données ![image importbazzar1.png (34.6kB)](images/BazarImportExport_importbazzar1_vignette_780_544_20160405102322_20160405102344.png) -* le wiki fournit alors diverses infos sur la structure du fichier nécessaire pour permettre un bonne importation -* le wiki fournit un fichier type vide au format CSV comme exemple (on peut le remplir et se servir de celui-ci ensuite) +* le wiki fournit alors diverses infos sur la structure du fichier nécessaire pour permettre une bonne importation +* le wiki fournit un fichier type vide au format CSV comme exemple. Il est possible de télécharger cette exemple puis de l'ouvrir au moyen d'un logiciel de tableur. Si le logiciel le demande, les virgules "," sont séparateurs de cellules et les guillemets encadrent les textes. ![image importbazarnext1.png (55.1kB)](images/BazarImportExport_importbazarnext1_vignette_780_544_20160405102909_20160405103228.png) -* une fois que l'on a préparé son fichier d'importation selon les consignes données -* on choisit son fichier à importer -* on clique sur le bouton **Importer le fichier\`** +Une fois que l'on a préparé son fichier d'importation selon les consignes données et que l'on a enregistré ce dernier en ".csv": +* Sélectionner le fichier à importer +* Cliquer sur le bouton **Importer le fichier\`** * une étape de contrôle / validation est proposée * si tout s'est bien passé on reçoit un message +### Importer plusieurs fichiers à la fois + +Pour lier des fiches de formulaire à des fichiers comme souvent des images, il est nécessaire d'importer les fiches via un tableur CSV comme détaillé à l'étape précédente. A la différence que le formulaire cible devra impérativement disposer d'un champ "image" ou "Upload de fichier". + +Lors de l'édition du tableur qui contiendra les données, renseigner la ou les colonne(s) correspondantes à "image" et/ou "fichier" avec l'url du fichier en question qui sera détaillé lors des étapes suivantes. + +Prérequis : +* Disposer des accés administrateurs. +* Avoir accés à un logiciel de tableur tel que libre office calc. +* Avoir accés au serveur sur lequel est placé le wiki par les protocoles FTP. +* Disposer d'un logiciel de transfert de fichiers FTP tel que [FileZilla](https://filezilla-project.org/). + +Etapes : +* Via le FTP, déposer sur le serveur dans le dossier "/files" les fichiers que l'on souhaitent voir lier avec les fiches que l'on va importer. +* Ouvrir un tableur ou le fichier ".csv" d'exemple importé précédemment. A chaque ligne de ce tableur correspondra une fiche importé. +* Dans la colonne "image" ou "fichier" renseigner l'URL où se trouve le fichier suivi du nom du fichier et de son extension. Exemple : "https://monwiki.net/files/image.jpg" +* Faire de même pour chaque fiche. +* Enregistrer puis importé le fichier csv comme détaillé dans la partie ci dessus : "Étapes pour importer des données". + +Astuces : +* Pour lister des fichiers contenu dans un dossier, il existe des outils tel que la commande linux : ```ls > filenames.txt``` qui va stocker dans un fichier du nom de "filenames.txt" la liste des noms de fichiers. Il sera alors facile de copier coller ces noms et des les intégrer au tableur. +* Afin de lier l'URL de base tel que "https://monwiki.net/files/" au nom de fichier on peut utiliser une fonction de jonction de textes comme sur libre office calc : ```=JOINDRE.TEXTE( ; ;cellule1;cellule2)```. Dans ce cas, nettoyer le tableur des colonnes non attendu par le formulaire ye wiki. + + ### Étapes pour exporter des données * se connecter au wiki (il faut être parmi les administrateurs pour pouvoir importer des données) diff --git a/docs/fr/bazar.md.backup b/docs/fr/bazar.md.backup new file mode 100644 index 000000000..db2b12670 --- /dev/null +++ b/docs/fr/bazar.md.backup @@ -0,0 +1,543 @@ +# Bazar : des bases de données coopératives dans YesWiki + +Bazar permet **la création et la gestion de bases de données** pour structurer des contenus et faciliter leur manipulation par les usagers. La page "bases de données" (BazaR) est accessible via la roue crantée en haut à droite du menu. + +## Introduction - Principe de fonctionnement +Bazar utilise des formulaires qui permettent deux choses : +* faciliter la **saisie** en offrant un cadre structuré de collecte d'informations, +* **visualiser** tout ou partie des informations saisies sous une forme qui vous semble pertinente (une carte, un trombinoscope, une liste, etc.). + +### Exemples d'utilisation +A l'installation de votre wiki, quelques formulaires sont présents dans votre [base de données](BazaR) à titre d'exemple : Agenda, Annuaire, Blog-Actu, Ressources. Vous pouvez les modifier pour qu'ils correspondent à vos besoins ou en créer de nouveaux. + +### Les trois phases de fabrication d'un formulaire +1. **Concevoir** le formulaire, +2. Mettre à disposition une page pour la **saisie** des fiches, +3. Mettre en œuvre une page d'**affichage** des résultats du formulaire. + +### Présentation de l'interface Bazar +!> Notez qu'il faut être connecté.e avec un compte administrateur du wiki pour pouvoir utiliser certaines fonctionnalités _Bazar_. + +L'écran qui se présente ressemble à ceci (voir ci dessous). +![image bazar.png (0.1MB)](images/DocBazarFormulaireGestion_formulaire_gestion_20220204173223_20220204163232.png) + +L'onglet **Formulaires** se présente sous la forme d'un tableau dans lequel chaque formulaire présent sur le wiki occupe une ligne. +Pour chaque ligne, et donc chaque formulaire, on a donc les informations suivantes (les nombres en rouge sur la capture d'écran correspondent aux numéros dans la liste ci-après). + +**1 –** Le nom du formulaire. C'est le nom sous lequel ce formulaire apparaîtra pour vous. +Parfois ce nom est suivi de quelques mots de description (dans l'exemple ci-contre c'est le cas des formulaires Convive et Ressources) +**2 –** Ce petit bouton en forme de loupe vous permet d'accéder à la recherche parmi les fiches de ce formulaire. Le comportement est alors similaire à celui qu'on aurait avec l'onglet « Rechercher » en haut de page. +**3 –** Ce petit bouton en forme de « + » vous permet d'accéder à la saisie de fiches pour ce formulaire. Le comportement est alors similaire à celui qu'on aurait avec l'onglet « Saisir » en haut de page. +**4 –** Chacune des icônes ou libellés dans ce groupe permet de déclencher l'export, la diffusion ou la publication selon le format indiqué. +**5 –** Il s'agit de l'identifiant (ou nom) du formulaire pour YesWiki. Vous n'aurez _a priori_ pas à utiliser ce nom. +**6 –** Ce petit bouton permet de dupliquer un formulaire afin de s'en inspirer pour en construire un autre en partie similaire sans avoir à tout refaire. +**7 –** Ce petit bouton en forme de crayon permet d'accéder à la modification du formulaire. +**8 –** Cette petite gomme permet de supprimer toutes les fiches du formulaire. Attention, il n'y a pas de moyen de récupérer des fiches supprimées. +**9 –** Cette petite poubelle permet de supprimer le formulaire. Attention, il n'y a pas de moyen de récupérer un formulaire supprimé. +**10 –** Ce bouton permet de créer un nouveau formulaire. +**11 –** Vous pouvez, si vous avez repéré sur un autre YesWiki un formulaire qui vous conviendrait, utiliser ce champ pour saisir l'adresse du wiki en question. Vous serez ensuite guidés pour récupérer le ou les formulaires qui vous intéressent sur ce wiki. + +**Création et modification d'un formulaire _Bazar_** +Pour modifier un formulaire on utilisera donc le petit bouton en forme de crayon (cf. 7 précédent). +Et, pour créer un nouveau formulaire, on utilisera le bouton « Saisir un nouveau formulaire ». +Les deux boutons envoient sur un écran similaire, vide dans le cas de la création et présentant les questions du formulaire dans le cas d'une modification. + + +### Concevoir le formulaire +Concevoir le formulaire revient à choisir et agencer les différentes questions que vous allez poser. +Si vous partez de zéro, cela peut être une excellente occasion de mettre en œuvre de la coopération en co-élaborant votre formulaire. + +Lors de la **conception** vous travaillerez dans la page _Base de données_ de votre wiki accessible _via_ le menu roue crantée en haut à droite du wiki. + +#### Nom du formulaire +Ce nom peut être composé de plusieurs mots, comportant éventuellement des caractères accentués. Il pourra être modifié par la suite. + +#### Description du formulaire +Cette zone permet de saisir des explications pour comprendre l'objectif du formulaire depuis l'écran de gestion des formulaires. + +#### Ajout, suppression et réorganisation des champs du formulaire +**Remarque concernant le vocabulaire –** Nous appellerons **« champ »** la mise en œuvre technique d'une question. +![image formulaire_constructeur.png (66.3kB)](images/DocBazarFormulaireModification_formulaire_constructeur_vignette_780_544_20220204190135_20220204180220.png) + +Ce constructeur graphique se présente en deux parties. Les numéros sur l'image renvoient aux explications ci-dessous. +**Dans la partie gauche de l'écran**, sont montrés les champs (ou questions) déjà présents avec : +* leur libellé (**1**), +* une représentation de leur aspect dans le formulaire final (**2**), +* un petit astérisque rouge si le champ est obligatoire (**3**). + +Lorsqu'on déplace le pointeur de la souris au dessus de la zone correspondant au champ, celui-ci devient une poignée (**4**) qui permet de déplacer le champ pour le positionner à un autre endroit dans le formulaire. +Apparaissent également au survol de la souris, +* un bouton de suppression du champ (**5**), +* un bouton de modification du champ (**6**), +* un bouton de duplication du champ (**7**). + +**Dans la partie de droite** se trouvent les différents types de champs possibles (**8**). +En saisissant, dans la partie droite, l'icône d'un type de champs et en la glissant dans la partie gauche, on va ajouter un champ de ce type au formulaire. + +![image formulaire_constructeur_grab.png (20.0kB)](images/DocBazarFormulaireModification_formulaire_constructeur_grab_20220204191328_20220204181700.png) + +Une zone noire apparaît alors à l'endroit où le champ sera inséré. Dans l'exemple montré, cette zone est placée en dessous du champ préexistant. + +![image formulaire_constructeur_drop_field.png (25.3kB)](images/DocBazarFormulaireModification_formulaire_constructeur_drop_field_20220204191854_20220204182701.png) + +En relâchant le bouton de la souris, le champ se crée. + +![image formulaire_constructeur_champ_creation.png (25.2kB)](images/DocBazarFormulaireModification_formulaire_constructeur_champ_creation_20220204193028_20220204183846.png) + +#### Modification d'un champ de formulaire + +En cliquant sur le petit crayon correspondant à un champ, on peut modifier ses différents paramètres. + +#### Enregistrer + +Lorsque vous avez fini de modifier votre formulaire, vous devez valider au moyen du bouton du même nom en bas de page. + + +## Paramétrer les champs (questions) +_Bazar_ propose de nombreux types de champs. Voici ceux auxquels vous aurez le plus souvent recours. +### Paramètres génériques +Certains paramètres sont génériques à tous ou pratiquement tous les types de champs. Ils sont repris ici. + - **Obligatoire** : Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée. + - **Identifiant unique** : Ce paramètre permet de définir le nom du champ pour YesWiki. Ce nom sera utilisé par YesWiki pour identifier le champ et doit donc impérativement être unique. Si un autre champ avait le même identifiant dans votre formulaire, vous observeriez des dysfonctionnements. +Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie. + - **Intitulé** : Il s'agit du texte de votre question. YesWiki préremplit ce paramètre avec le type de champ, charge à vous de remplacer cela par un libellé pertinent. + - **Texte d'aide** : Ce paramètre vous permet de saisir un texte d'aide afin d'aiguiller l'utilisateur si vous pensez qu'il peut en avoir besoin pour cette question. + - **Peut être lu par** : Par défaut, chaque champ peut être lu par toute personne ayant le droit de visualiser une fiche du formulaire. Ce paramètre permet de modifier ce comportement pour le champ en question. On peut ainsi masquer un champ à certains utilisateurs. + - **Peut être saisi par** : Par défaut, chaque champ peut être saisi par toute personne ayant le droit de saisir une fiche du formulaire. Ce paramètre permet de modifier ce comportement pour le champ en question. On peut ainsi masquer un champ à certains utilisateurs. + +### Le seul champ indispensable : le titre +* Il a l'aspect d'un titre (en haut, plus gros, en couleur). Mais on s'y attendait. +* Dans une liste de fiches par exemple, seul le titre sera visible pour toutes les fiches non « dépliées ». +* Le titre est le seul champ qui soit présenté sans rappel de la question posée lors de sa saisie. Par exemple, dans un formulaire dans lequel on utilise le prénom comme titre, on aura « Nadine » et non pas « Prénom : Nadine ». + +#### Particularités indispensables +Ce champ est un champ de type texte court. Cependant, il a trois particularités indispensables. +**1.** Il doit être présent dans tout formulaire. +**2.** Son paramètre identifiant unique doit nécessairement être « bf\_titre ». +**3.** Il doit nécessairement être obligatoire. +Vous êtes libres de définir le libellé qui vous convient. + +#### Qu'advient-il de ce titre ? +**Lors de la création d'une fiche** par un·e utilisateurice, YesWiki fabrique une page à partir de cette fiche. +L'adresse (_url_) de cette page est déterminée automatiquement à partir du titre de la fiche. Une fiche dont le titre serait « Le titre de ma fiche » donnerait la page _LeTitreDeMaFiche_. À l'usage, il peut arriver que deux fiches soient créées avec le même titre. _Bazar_ évite alors les doublons en ajoutant un nombre à la fin du titre qu'il génère (ici, _LeTitreDeMaFiche1_). + +#### Fabriquer un titre à partir de 2 champs +Il est possible d'utiliser un titre combiné : par exemple : "champ prénom + champ nom". +Pour cela utiliser le champ de type **[Titre automatique](/docs/fr/bazar?id=titre-automatique)** + +### Texte court +Un champs de texte qui permet la saisie de quelques mots. +#### Paramètres spécifiques au type de champs « texte court » : + - **Valeur** Ce paramètre permet de pré-remplir le champ. C'est utile lorsque on connait la réponse la plus courante (si, par exemple, on demande le pays). + - **Nombre de caractères visibles** : Ce paramètre permet de préciser combien de caractères seront visibles à l'écran. + - **Longueur max** : Ce paramètre permet de limiter la longueur de la réponse que les utilisateurices peuvent saisir. +**NB.** ce champ est par défaut de type texte, les autres types disponibles sont : + - nombre + - slider <= propose un curseur coulissant entre une valeur minil=male et maximale + - adresse url + - mot de passe + - couleur <= propose de choisir une couleur + +### Texte long +Une zone de texte permet la saisie d'un texte relativement long et pouvant courrir sur plusieurs lignes. +#### Paramètres spécifiques au type de champs « zone de texte » : +- **Valeur** : Ce paramètre permet de pré-remplir le champ. C'est utile lorsque on connaît la réponse la plus courante (si, par exemple, on demande le pays). +- **Format d'écriture** : Ce paramètre permet de paramétrer les fonctionnalités d'écriture dont disposeront les utilisateurices. Trois valeurs sont possibles. + - **Wiki –** C'est la valeur par défaut. Elle offre pour la saisie de ce champ tous les outils disponibles lorsqu'on édite une page YesWiki (liens, fichiers joints, composants ...). + - **Éditeur wysiwyg –** Ce paramétrage offre à l'utilisateurice plus de facilité de saisie. Son usage est toutefois à limiter pour des raisons d'ergonomie. La barre de mise en forme est plus classique mais n'offre pas les options wiki (composants...) + - **Texte non interprété –** Cette valeur limite la saisie aux seuls caractères sans mise en forme (pas d'italique ni de gras par exemple). C'est très utile pour saisir des adresses postales. +- **Largeur champ de saisie** : Ce paramètre permet de préciser la largeur du champ de saisie. + +### Date +Un champ de type date permet de saisir sans erreur une date. +Certains affichages des résultats (calendrier, agenda, etc.) nécessitent la présence d'un champ date. + +#### Paramètres spécifiques au type de champs date : + - **Initialiser à Aujourd'hui** : Ce paramètre permet de préciser si on souhaite que la date soit prédéfinie à la date du jour. + +### Image +Un champ de type image permet d'importer un fichier image qui sera ensuite visualisable dans la fiche. +#### Paramètres spécifiques au type de champs « image » : + - **Hauteur vignette** : YesWiki génère une vignette des images afin de les afficher rapidement si besoin. Ce paramètre permet de préciser la hauteur de cette vignette. + - **Largeur vignette** : YesWiki génère une vignette des images afin de les afficher rapidement si besoin. Ce paramètre permet de préciser la largeur de cette vignette. + - **Hauteur re-dimension** : YesWiki peut harmoniser la taille des images importées pour ce formulaire. Ce paramètre permet de préciser la hauteur de cette image redimensionnée. + - **Largeur re-dimension** : YesWiki peut harmoniser la taille des images importées pour ce formulaire. Ce paramètre permet de préciser la largeur de cette image redimensionnée. + - **Alignement** : C'est là que l'on paramètre le comportement d'affichage de l'image. Son fonctionnement est similaire à ce qui se passe dans l'édition de pages (quand on joint une image avec le bouton Fichier). + +### URL +Permet de saisir un lien web qui sera cliquable dans la fiche + +### Upload de fichier +Ce type de champ permet d'uploader un fichier (par exemple au format PDF). Ce fichier est ensuite téléchargeable par les personnes qui visualisent la fiche. +#### Paramètres spécifiques au type de champs « upload de fichier » : + - **Taille max** Ce paramètre permet de limiter la taille du fichier. Il s'agit d'un nombre d'octets (par ex. 2000000 équivalent à 2 Mo). + +### Email +Ce type de champs permet de saisir une adresse électronique. YesWiki effectue automatiquement des contrôles sur la syntaxe de l'adresse et propose également de paramétrer des comportements spécifiquement liés à ce type de données. +#### Paramètres spécifiques au type de champs « email » : + - **Remplacer l'email par un bouton contact** En sélectionnant « oui » pour ce paramètre, on fait en sorte que l'adresse électronique soit remplacée, lors de l'affichage de la fiche, par un bouton qui renvoie vers un formulaire de contact automatiquement généré. L'email n'est donc pas visible par les personnes qui visualisent la fiche. + - **Affichage brut de l'email autorisé pour** Ce paramêtre permet d'indiquer qui a le droit de voir l'email saisi depuis ce champ dans des tableaux et dans les affichages de la fiche sans bouton contact + - **Envoyer le contenu de la fiche à cet email** Ce paramètre permet de demander à YesWiki d'envoyer le contenu de la fiche à l'adresse saisie. Cet envoi se fera lorsque la personne aura validé la saisie de la fiche. + __Astuce__ : Il est possible d'ajouter un contenu personnalisé dans le corps du mail via la page Fichier de configuration dans Gestion du site. Pour cela : insérer votre contenu (avec mise en forme possible en HTML) au niveau du paramètre ```Message personnalisé des mails envoyés depuis l'action contact - mail_custom_message``` + __Pour aller plus loin dans la personnalisation des mails envoyés__ : pour les développeurs Il est possible d'adapter les messages affichés dans les e-mails en copiant les templates associés depuis tools/contact/templates/notify-email-*.twig dans custom/templates/contact/ puis en modifiant le contenu de ces modèles (syntaxe twig) + +### liste déroulante +Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'une liste déroulante. +En outre, l'utilisation de ce type de champ permet d'avoir recours à des [facettes](/docs/fr/bazar.md#afficher-des-filtres-facettes) pour filtrer parmi les fiches remplies. +Avec "Sélectionner", l'utilisateurice ne pourra choisir qu'un choix parmi la liste. + +En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles. +#### Paramètres spécifiques au type de champs « sélectionner » : + - **Origine des données** : Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ». +Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ». + - **Choix de la liste/du formulaire** Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent. + - **Valeur par défaut** Ce paramètre vous permet de proposer une valeur par défaut. Si vous n'en précisez pas, c'est le mot « choisir » qui s'affichera jusqu'à ce qu'un choix soit effectué. Attention, pour préciser la valeur par défaut, il faut indiquer sa clef dans la liste (et non pas sa valeur). + +### Cases à cocher +Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'un groupe de cases à cocher. En outre, l'utilisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies. +Avec "Groupe de cases à cocher", l'utilisateurice pourra cocher plusieurs choix parmi la liste. + +En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles. +#### Paramètres spécifiques au type de champs « groupe de cases à cocher » : + - **Origine des données** Dans ce paramètre, pour permettre à l'utilisateurice de choisir parmi les valeur d'une liste, sélectionnez « une liste ». +Si, au contraire, vous souhaitez permettre à l'utilisateurice de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ». + - **Choix de la liste/du formulaire** Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurices choisissent. + - **Valeur par défaut** Ce paramètre vous permet de proposer une valeur par défaut. Attention, pour préciser la valeur par défaut, il faut indiquer sa clef dans la liste (et non pas sa valeur). + +### Boutons radio +Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'un groupe de boutons radio. En outre, l'utilisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies. +"Groupe de boutons radio " se présente comme les cases à cocher mais l'utilisateurice ne pourra choisir qu'une option parmi la liste. + +#### Paramètres spécifiques au type de champs « groupe de boutons radio » : + - **Origine des données** : Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ». +Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ». + - **Choix de la liste/du formulaire** : Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent. + - **Valeur par défaut** : Ce paramètre vous permet de proposer une valeur par défaut. Attention, pour préciser la valeur par défaut, il faut indiquer sa clef dans la liste (et non pas sa valeur). + +### Géolocalisation de l'adresse +![image champ_zone.png (24.5kB)](images/DocBazarChampGeo_champ_geoloc.png) + +Ce champ est un outil qui permet de transformer une adresse saisie en un jeu de coordonnées (longitude et latitude). +Son comportement est donc un peu différent de ce qu'on trouve dans les autres champs. + +Notamment, pour trouver les coordonnées d'une adresse, il faut à YesWiki des informations sur celle-ci. Votre formulaire doit donc obligatoirement contenir au moins un des champs suivants (une bonne pratique étant d'en avoir plusieurs, voire tous). + - un champ dont l'identifiant unique est « bf\_adresse ». S'il n'existe pas, il est d'ailleurs inséré automatiquement lors de la création du champ « géolocalisation de l'adresse » ; + - un champ dont l'identifiant unique est « bf\_ville » ; + - un champ dont l'identifiant unique est « bf\_codepostal » ; + - un champ dont l'identifiant unique est « bf\_pays ». + +Il est indispensable d'avoir un champ de ce type dans votre formulaire si vous souhaitez afficher vos résultats sous forme de carte. + +#### Paramètres du type de champs « géolocalisation de l'adresse » : + - **Nom Champ Latitude** Sauf besoin précis, conservez la valeur par défaut qui est « bf\_latitude ». + - **Nom Champ Longitude** Sauf besoin précis, conservez la valeur par défaut qui est « bf\_longitude ». + - **Champ code postal pour l'autocomplétion** : s'assurer que le formulaire possède un champ texte court pour le code postal et noter son nom (ex. : bf_codepostal). Ainsi quand vous allez taper un code postal puis sélectionner la ville associée, la géolocalisation sera automatiquement mise à jour. + - **Champ ville pour l'autocomplétion** : s'assurer que le formulaire possède un champ texte court pour la ville et noter son nom (ex. : bf_ville). Ainsi quand vous allez taper un nom de ville puis sélectionner le code postal associé, la géolocalisation sera automatiquement mise à jour. + + - Vous pourrez activer la possibilité de se géolocaliser depuis la position de l'ordi ou du GSM + +### Mots clés +Possibilité d'ajouter des mots clés en les séparant par un clic sur la touche entrée + +### Custom HTML +Le champ custom html permet d'insérer un texte, un titre, un lien, ou tout autre contenu au format HTML. +Il se décline en deux options : + - le contenu qui sera affiché lors de la saisie (cela peut être une information destinée à expliquer à l'utilisateur ce qu'on attend comme élément ) + - le contenu affiché lors de la consultation d'une fiche + +ex :