Skip to content

Commit fa706bd

Browse files
doc : relecture
1 parent d12437c commit fa706bd

File tree

1 file changed

+66
-73
lines changed

1 file changed

+66
-73
lines changed

docs/users/fr/bazar.md

Lines changed: 66 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -147,9 +147,10 @@ Lorsque vous avez fini de modifier votre formulaire, vous devez valider au moyen
147147

148148
_Bazar_ propose de nombreux types de champs. Voici ceux auxquels vous aurez le plus souvent recours.
149149

150-
#### /!\\ À ne jamais oublier – Le titre /!\\
151-
152150
#### Le seul champ indispensable : le titre
151+
* Il a l'aspect d'un titre (en haut, plus gros, en couleur). Mais on s'y attendait.
152+
* Dans une liste de fiches par exemple, seul le titre sera visible pour toutes les fiches non « dépliées ».
153+
* 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 ».
153154

154155
##### Particularités indispensables
155156

@@ -163,129 +164,120 @@ Vous êtes libres de définir le libellé qui vous convient.
163164

164165
##### Qu'advient-il de ce titre ?
165166

166-
**Lors de la création d'une fiche** par un utilisateur, YesWiki fabrique une page à partir de cette fiche.
167+
**Lors de la création d'une fiche** par un·e utilisateurice, YesWiki fabrique une page à partir de cette fiche.
167168
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_).
168169

169-
170-
#### Champ de type texte court
171-
172-
Un champs de texte qui permet la saisie de quelques mots
173-
.
174-
##### Paramètres génériques
170+
#### Paramètres génériques
175171

176172
Certains paramètres sont génériques à tous ou pratiquement tous les types de champs. Ils sont repris ici.
177173

178-
###### Obligatoire
174+
**Obligatoire**
179175

180176
![image champ_param_oblig.png (2.5kB)](images/DocBazarParametresGeneriques_champ_param_oblig_20220204195251_20220204185301.png)
181177

182178
Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.
183179

184-
###### Identifiant unique
180+
**Identifiant unique**
185181

186182
![image champ_param_ID.png (4.6kB)](images/DocBazarParametresGeneriques_champ_param_ID_20220204195423_20220204185535.png)
187183

188184
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.
189185
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
190186

191-
##### Intitulé
187+
**Intitulé**
192188

193189
![image champ_param_label.png (3.0kB)](images/DocBazarParametresGeneriques_champ_param_label_20220204195423_20220204190117.png)
194190

195191
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.
196192

197-
##### Texte d'aide
193+
**Texte d'aide**
198194

199195

200196
![image champ_param_aide.png (2.4kB)](images/DocBazarParametresGeneriques_champ_param_aide_20220204200514_20220204192507.png)
201197

202198
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.
203199

204200
!> Basculer tout ca dans administration / gestion des droits pour alléger la doc bazar ???
205-
##### ✨ Peut être lu par
201+
202+
**Peut être lu par**
206203

207204
![image champ_param_access_read.png (3.0kB)](images/DocBazarParametresGeneriques_champ_param_access_read_20220211175241_20220218105840.png)
208205

209206
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.
210207
~~[Voir la liste des différentes valeurs possibles]~~(https://quincaillere.org/formationgarecentrale2022/?DocBazarParametreAccesValeurs "Les différentes valeurs possibles").
211208

212-
##### Peut être saisi par
209+
**Peut être saisi par**
213210

214211
![image champ_param_access_write.png (3.0kB)](images/DocBazarParametresGeneriques_champ_param_access_write_20220211175241_20220218110059.png)
215212

216213
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.
217214
[Voir la liste des différentes valeurs possibles](https://quincaillere.org/formationgarecentrale2022/?DocBazarParametreAccesValeurs "Les différentes valeurs possibles").
218215

219-
##### Paramètres spécifiques au type de champs « texte court »
216+
#### Champ de type texte court
217+
218+
Un champs de texte qui permet la saisie de quelques mots.
220219

221-
###### Valeur
220+
**Paramètres spécifiques au type de champs « texte court » :**
221+
222+
**Valeur**
222223

223224
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).
224225

225-
###### Nombre de caractères visibles
226+
**Nombre de caractères visibles**
226227

227228
Ce paramètre permet de préciser combien de caractères seront visibles à l'écran.
228229

229-
###### Longueur max
230+
**Longueur max**
230231

231-
Ce paramètre permet de limiter la longueur de la réponse que les utilisateurs peuvent saisir.
232+
Ce paramètre permet de limiter la longueur de la réponse que les utilisateurices peuvent saisir.
232233

233234
#### Champ de type « zone de texte »
234235

235236
Une zone de texte permet la saisie d'un texte relativement long et pouvant courrir sur plusieurs lignes.
236-
* Il a l'aspect d'un titre (en haut, plus gros, en couleur). Mais on s'y attendait.
237-
* Dans une liste de fiches par exemple, seul le titre sera visible pour toutes les fiches non « dépliées ».
238-
* 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 ».
239-
240-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
241237

238+
**Paramètres spécifiques au type de champs « zone de texte » : **
242239

243-
##### Paramètres spécifiques au type de champs « zone de texte »
244-
245-
##### Valeur
240+
**Valeur**
246241

247242
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).
248243

249-
##### Format d'écriture
244+
**Format d'écriture**
250245

251-
Ce paramètre permet de paramétrer les fonctionnalités d'écriture dont disposeront les utilisateurs. Trois valeurs sont possibles.
246+
Ce paramètre permet de paramétrer les fonctionnalités d'écriture dont disposeront les utilisateurices. Trois valeurs sont possibles.
252247

253248
* **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.
254-
* **Éditeur wysiwyg –** Ce paramétrage offre à l'utilisateur beaucoup plus de facilité de saisie. Son usage est toutefois à limiter pour des raisons d'ergonomie.
249+
* **Éditeur wysiwyg –** Ce paramétrage offre à l'utilisateurice beaucoup plus de facilité de saisie. Son usage est toutefois à limiter pour des raisons d'ergonomie.
255250
* **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.
256251

257-
##### Largeur champ de saisie
252+
**Largeur champ de saisie**
258253

259254
Ce paramètre permet de préciser la largeur du champ de saisie.
260255

261256
#### Champ de type « image »
262257
Un champ de type image permet d'importer un fichier image qui sera ensuite visualisable dans la fiche.
263258

264-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
265-
266-
267-
268-
##### Paramètres spécifiques au type de champs « image »
259+
**Paramètres spécifiques au type de champs « image » :**
269260

270261
**Hauteur vignette**
271262
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.
263+
272264
**Largeur vignette**
273265
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.
266+
274267
**Hauteur re-dimension**
275268
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.
269+
276270
**Largeur re-dimension**
277271
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.
272+
278273
**Alignement**
279274
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).
280275

281276
#### Champ de type « upload de fichier »
282277

283278
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.
284279

285-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
286-
287-
288-
##### Paramètres spécifiques au type de champs « upload de fichier »
280+
**Paramètres spécifiques au type de champs « upload de fichier » :**
289281

290282
**Taille max**
291283
Ce paramètre permet de limiter la taille du fichier. Il s'agit d'un nombre d'octets (par ex. 2000000 équivalent à 2 Mo).
@@ -294,14 +286,14 @@ Ce paramètre permet de limiter la taille du fichier. Il s'agit d'un nombre d'oc
294286

295287
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.
296288

297-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
298-
299-
300-
##### Paramètres spécifiques au type de champs « email »
289+
**Paramètres spécifiques au type de champs « email » :**
301290

302291
**Remplacer l'email par un bouton contact**
292+
303293
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.
294+
304295
**Envoyer le contenu de la fiche à cet email**
296+
305297
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.
306298

307299
#### Champ de type « sélectionner »
@@ -310,19 +302,21 @@ Un champ de ce type permet de proposer à l'utilisateur une liste fermée de cho
310302
En outre, l'utilisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
311303

312304
En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles.
313-
*A AJOUTER : Lorsqu'on peut énumérer toutes les réponses possibles à une question *
314305

315-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
316306

317-
318-
##### Paramètres spécifiques au type de champs « sélectionner »
307+
**Paramètres spécifiques au type de champs « sélectionner » :**
319308

320309
**Origine des données**
310+
321311
Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ».
322312
Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ».
313+
323314
**Choix de la liste/du formulaire**
315+
324316
Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.
317+
325318
**Valeur par défaut**
319+
326320
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).
327321

328322
#### Champ de type « groupe de cases à cocher »
@@ -331,17 +325,21 @@ Un champ de ce type permet de proposer à l'utilisateur une liste fermée de cho
331325
En outre, l'utilisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
332326

333327
En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles.
334-
*A AJOUTER : Lorsqu'on peut énumérer toutes les réponses possibles à une question *
335328

336329

337-
##### Paramètres spécifiques au type de champs « groupe de cases à cocher »
330+
**Paramètres spécifiques au type de champs « groupe de cases à cocher » :**
338331

339332
**Origine des données**
340-
Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ».
341-
Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ».
333+
334+
Dans ce paramètre, pour permettre à l'utilisateurice de choisir parmi les valeur d'une liste, sélectionnez « une liste ».
335+
Si, au contraire, vous souhaitez permettre à l'utilisateurice de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ».
336+
342337
**Choix de la liste/du formulaire**
343-
Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.
338+
339+
Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurices choisissent.
340+
344341
**Valeur par défaut**
342+
345343
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).
346344

347345
#### Champ de type « groupe de boutons radio »
@@ -350,42 +348,39 @@ Un champ de ce type permet de proposer à l'utilisateur une liste fermée de cho
350348
En outre, l'utilisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
351349
En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles.
352350

353-
*A AJOUTER : Lorsqu'on peut énumérer toutes les réponses possibles à une question *
354-
355-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
356-
357-
358-
##### Paramètres spécifiques au type de champs « groupe de boutons radio »
351+
**Paramètres spécifiques au type de champs « groupe de boutons radio » :**
359352

360353
**Origine des données**
354+
361355
Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ».
362356
Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ».
357+
363358
**Choix de la liste/du formulaire**
359+
364360
Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.
361+
365362
**Valeur par défaut**
363+
366364
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).
367365

368366
#### Champ de type date
369367

370368
Un champ de type date permet de saisir sans erreur une date.
371369
Certains affichages des résultats (calendrier, agenda, etc.) nécessitent la présence d'un champ date.
372370

373-
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
374-
375-
376-
##### Paramètres spécifiques au type de champs date
371+
**Paramètres spécifiques au type de champs date :**
377372

378373
**undefined**
374+
379375
Ce paramètre permet de préciser si on souhaite que la date soit prédéfinie à la date du jour.
376+
380377
**Attention** – À l'heure à laquelle ces lignes sont écrites, la valeur « non » aboutit à ce que la date ne soit pas prédéfinie, et inversement.
381378

382379
#### Champ de type « géolocalisation de l'adresse »
383380

384381
![image champ_zone.png (24.5kB)](images/DocBazarChampGeo_champ_geoloc_20220204222452_20220204212502.png)
385382

386-
Ce champ n'est pas un vrai champ.
387-
388-
Il s'agit, de fait, d'un outil qui permet de transformer une adresse saisie par un humain en un jeu de coordonnées (longitude et latitude).
383+
Ce champ n'est pas un vrai champ. Il s'agit, de fait, d'un outil qui permet de transformer une adresse saisie par un humain en un jeu de coordonnées (longitude et latitude).
389384
Son comportement est donc un peu différent de ce qu'on trouve dans les autres champs.
390385

391386
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).
@@ -396,15 +391,13 @@ Notamment, pour trouver les coordonnées d'une adresse, il faut à YesWiki des i
396391

397392
Il est indispensable d'avoir un champ de ce type dans votre formulaire si vous souhaitez afficher vos résultats sous forme de carte.
398393

399-
##### Paramètres du type de champs « géolocalisation de l'adresse »
400-
401-
394+
**Paramètres du type de champs « géolocalisation de l'adresse » :**
402395

403-
###### Nom du champ latitude
396+
**Nom du champ latitude**
404397

405398
Avec ce champ, YesWiki va convertir l'adresse postale en coordonnées. Ce paramètre indique à YesWiki dans quel nom interne il doit donner à la valeur de latitude. Sauf besoin précis, conservez la valeur par défaut qui est « bf\_latitude ».
406399

407-
###### Nom du champ longitude
400+
**Nom du champ longitude**
408401

409402
Avec ce champ, YesWiki va convertir l'adresse postale en coordonnées. Ce paramètre indique à YesWiki dans quel nom interne il doit donner à la valeur de longitude. Sauf besoin précis, conservez la valeur par défaut qui est « bf\_longitude ».
410403

@@ -423,7 +416,7 @@ https://quincaillere.org/formationgarecentrale2022/?M23bLecturesBazar1ConcevoirS
423416
## 2 – Permettre la saisie des fiches
424417

425418
Pour permettre la **saisie des fiches**, insérez le formulaire de saisie dans la page wiki de votre choix via le bouton composant **Afficher un formulaire de création de fiche**.
426-
Dans les options avancées, vous pouvez choisir le ** Nom de la page de ce wiki à afficher après création d'une fiche**
419+
Dans les options avancées, vous pouvez choisir le ** Nom de la page de ce wiki à afficher après création d'une fiche** pour renvoyer vers une page préparée par vos soins suite à la saisie d'une fiche.
427420

428421

429422
## 3 – Afficher les résultats du formulaire

0 commit comments

Comments
 (0)