Index
Afficher les données
Bazar – Afficher les résultats
Vous avez créé votre formulaire, permis la saisie des fiches. Nous allons maintenant afficher les résultats.Remarques préliminaires
Pas de fiches, pas d'affichage
Bazar offre plusieurs manières de présenter les résultats. Mais, dans la plupart des cas, s'il n'y a pas de résultats (pas de fiches), vous ne verrez rien. Donc pour s'assurer que tout fonctionne comme vous le souhaitez, il est toujours préférable de saisir quelques fiches.Cartographie
Pour afficher les résultats sous la forme d'une carte, il est impératif que vous ayez un champ de type « géolocalisation de l'adresse ». Les coordonnées géographiques sont en effet indispensables.Calendrier et agenda
De même, pas de calendrier ni d'agenda sans champ de type date.Image
Quant à tous les affichages qui nécessitent une image (trombinoscope ...), il faut évidemment que le champs correspondant existe.Facettes
Vous ne pourrez mettre en œuvre des facettes dans votre affichage que si votre formulaire utilise au moins une liste (champs de type « sélectionner », « groupe de cases à cocher » ou « groupe de boutons radio »).Comment faire
1 –Vous pouvez afficher les résultats sur toute page où cela vous semble cohérent. Donc, vous vous rendez sur la page et à l'endroit où vous voulez que vos résultats soient affichés.
Télécharger le fichier formulaire_affichage_composant.png2 – Cliquez sur le bouton « Composants », puis sur « Afficher les données d'un formulaire ».
Télécharger le fichier formulaire_affichage_dialog.png3 – Dans la boîte de dialogue qui s'ouvre, cliquez sur la zone intitulée « Choisissez un formulaire ».
4 – Choix du formulaire – Dans la liste de formulaires qui s'affiche, choisissez celui dont vous souhaitez afficher les résultats.
5 – Choix du type d'affichage – Puis, cliquez sur la zone intitulée « Sous quelle forme voulez-vous afficher les données ? ».
6 – Dans la liste qui s'affiche, choisissez le type d'affichage que vous souhaitez (cf. « Remarques préliminaires »).
4 – Choix du formulaire – Dans la liste de formulaires qui s'affiche, choisissez celui dont vous souhaitez afficher les résultats.
5 – Choix du type d'affichage – Puis, cliquez sur la zone intitulée « Sous quelle forme voulez-vous afficher les données ? ».
6 – Dans la liste qui s'affiche, choisissez le type d'affichage que vous souhaitez (cf. « Remarques préliminaires »).
Télécharger le fichier formulaire_affichage_choix_fait.pngUne visualisation des résultats du formulaire s'affiche en partie dans la boîte de dialogue. En dessous de cette vue, se trouve une section dans laquelle vous trouverez toutes sortes de merveilles. Nous allons en développer deux.
Ajout d'une facette (optionnel)
7 – Cliquez sur le bouton « Ajouter une facette », vous ferez apparaître deux zones de saisie. Cliquez sur la flèche verticale qui se trouve à gauche de ces zones de saisie.
Ajout d'une facette (optionnel)
7 – Cliquez sur le bouton « Ajouter une facette », vous ferez apparaître deux zones de saisie. Cliquez sur la flèche verticale qui se trouve à gauche de ces zones de saisie.
Télécharger le fichier formulaire_affichagechoix_facette.png8 – Choisissez le champ sur lequel vous voulez que la facette fonctionne.
9 – La prévisualisation de l'affichage se modifie en conséquence dans la boîte de dialogue.
Modifier l'ordre d'affichage des fiches (optionnel)
10 – Par défaut, Bazar montre les fiches dans l'ordre alphabétique croissant de leur titre. Vous pouvez modifier ce comportement.
Dans la colonne la plus à droite de cette section, cliquez sur le champ « Champ pour le tri ».
10 – Par défaut, Bazar montre les fiches dans l'ordre alphabétique croissant de leur titre. Vous pouvez modifier ce comportement.
Dans la colonne la plus à droite de cette section, cliquez sur le champ « Champ pour le tri ».
11 – Choisissez le champ sur lequel vous voulez trier l'affichage de vos fiches.
12 – En dessous de ce champ, cliquez sur le champ « Ordre de classement ».
13 – Choisissez l'ordre de tri que vous souhaitez (croissant ou décroissant).
Télécharger le fichier formulaire_affichage_action.png14 – Insertion dans la page – Cliquez sur le bouton insérer dans la page. Cela donne quelque chose comme ceci.
15 – Enregistrer votre page.
CC-by-SA YesWiki
Bazar – Afficher uniquement certains résultats grâce aux requêtes "query"
Vous savez afficher l'ensemble des fiches d'un formulaire, mais dans certains cas, il peut être utile de n'afficher que certaines fiches.
- Par exemple :
- pour un trombinoscope afficher uniquement les fiches des personnes ayant autorisé l'affichage de leur fiche profil
- pour une page projet, ne voir que les personnes, les réunions ou les ressources liées à ce projet
Préalable
En premier lieu il est nécessaire de définir quelle valeur de quel champs va permettre le tri des fiches à afficher.
Puis, si ce n'est déjà fait, de créer dans le formulaire le champs et la liste ou le formulaire bazar associé, en conséquence.
- Dans un formulaire "Annuaire", créer un champs de type "bouton radio" avec l'intitulé "j'autorise l'affichage de mon profil sur le trombi" et une liste avec deux valeurs : "oui" ou "non"
- Dans un formulaire "Agenda", créer un champs de type "case à cocher" avec l'intitulé "projets concernés" et une liste avec des valeurs de type : "super projet 1" "projet génial 2" "projet relou 3"...
Ajout de la requête dans votre affichage bazar
- 1 : Mettez vous en mode édition, sur la ligne de code d'affichage de votre formulaire
Télécharger le fichier Capture_dcran_du_20250212_143704.png
- 2 : Ajoutez dans le code, en mode édition, la "query" en fonction de ce que vous souhaitez
Trier les fiches en fonction d'une valeur : query="bf_champs=clé"
- bf_champs est l'identifiant du champs concerné. Il est défini par défaut lorsque vous choisissez le type de champs. Ex: bf_checkboxes mais vous pouvez le personnaliser lors de la création de votre formulaire.
- clé est la clé de la valeur de votre liste.
Télécharger le fichier Capture_dcran_du_20250212_155347.png
Autres possibilités :
- trier sur la base de valeurs différentes : query="bf_champs!=clé" permet de garder uniquement les valeurs différentes de "clé"
- trier avec plusieurs valeurs de la même liste en ajoutant une virgule sans espace entre les clés : query="nom_du_champs=clé1,clévaleur2"
- trier sur la base de valeurs de deux listes différentes : query="nom_du_champs1=clé|nom_du_champs2=clé"
- trier sur la base d'un contenu vide : query="bf_champs=" Permet de ne garder que les fiches dont le champ bf_champs est vide
- trier sur la base de contenu non vide : query="bf_champs!=" Permet de ne garder que les fiches dont le champ bf_champs n'est pas vide
- trier sur base du contenu d'un champ (bf_...)
- query="bf_champs=a." Affiche tous les titres commençant par a)
- query="bf_champs=.a" (affiche tous les titres finissant par a)
- query="bf_titre=NomYeswiki (affiche la fiche dont le champ titre est NomYeswiki)
- query="bf_champs=." (affiche toutes les fiches dont le champ "bf_titre" est vierge)
- trier sur base d'une liste dynamique de type "checkboxfiche" query="checkboxfiche<numeroduformulaireappelé>=PageFiche
- Exemple : {{bazarliste id="2" query="checkboxfiche2=TesT"}}
Index
Composants de mise en forme
Les composants de mise en forme
Les wikis sont très souvent denses en informations : non seulement elles sont la mémoire du collectif dans le temps mais en plus elles doivent répondre aux questions d'une multitude d'acteurs du collectif. C'est pourquoi il est nécessaire de faciliter le parcours utilisateur. N'importe quelle personne doit pouvoir trouver l'information utile en 3 clics. Il est donc primordial d'anticiper les besoins des utilisateurs et d'organiser votre wiki de manière à suggérer où aller pour accomplir une action comme "s'inscrire" "en savoir plus" "afficher la carte". Votre boite à outils se compose de la barre de menu, mais aussi des liens, des boutons, des images cliquables...Vous trouverez ici un aperçu des composants de mise en forme utilisables dans Yeswiki.
Les composants se trouvent dans la barre d'édition d'une page :
Télécharger le fichier Capture_dcran_du_20250130_105041.png
Télécharger le fichier Capture_dcran_du_20250130_105041.png
En cliquant sur Mise en forme, voici les options :
Télécharger le fichier MiseEnForme_liste_deroulante.png
Télécharger le fichier MiseEnForme_liste_deroulante.png
Bouton
Un bouton est un élément visuel coloré qui permet de mettre en valeur un lien. Il se détache du contenu par son fond coloré et l'interactivité est mise en valeur par un léger changement de couleur lorsque l'utilisateur le survole avec la souris.
La dernière version de Yeswiki ("Doryphore") présente une nouveauté dans l'interface d'édition qui facilite grandement l'utilisation des éléments de mise en forme : les composants.
Une interface permet maintenant d'insérer facilement des boutons (et autres éléments de mise en forme que nous verrons plus loin).
Si vous souhaitez modifier un paramètre de votre bouton pour utiliser une autre couleur par exemple, il est possible d'éditer le composant en cliquant sur la ligne dans l'éditeur, un crayon apparait à gauche, il permet de réafficher les paramètres du bouton. (voir demo ci-dessous)
Pour aller plus loin dans la mise en forme, vous pouvez cocher la case paramètres avancés
Une interface permet maintenant d'insérer facilement des boutons (et autres éléments de mise en forme que nous verrons plus loin).
Si vous souhaitez modifier un paramètre de votre bouton pour utiliser une autre couleur par exemple, il est possible d'éditer le composant en cliquant sur la ligne dans l'éditeur, un crayon apparait à gauche, il permet de réafficher les paramètres du bouton. (voir demo ci-dessous)
Pour aller plus loin dans la mise en forme, vous pouvez cocher la case paramètres avancés
Paramètres avancés disponibles pour les boutons
- Ouvrir dans une pop-up - permet à l'utilisateur de rester sur la même page
- ouvrir dans un nouvel onglet - à n'utiliser que si le lien renvoie vers un autre site, sinon la convention est de garder le même onglet pour les liens internes
- taille du bouton : petit moyen grand
- position du bouton : à droite ou sur toute la largeur (j'utilise l'option "sur toute la largeur" en particulier dans les colonnes, cela permet d'avoir des boutons de la meme taille meme si le texte est de taille différente)
- afficher sous forme de lien - et utiliser quand même les options telles que icone ou ouverture pop up
- masquer le bouton si l'utilisateur n'a pas accès à la page cible (par exemple le bouton renvoie vers une page réservé aux admins, on peut masquer le bouton aux autres utilisateurs)
Nouveauté
Les étiquettes sont disponibles dans les composants de mise en forme. C'est une petite indication qui attire l'oeil. Elle s'adapte bien à un texte court pour donner un qualificatif à une rubrique.
Les 3 couleurs que vous avez choisi dans votre configuration graphique sont disponible pour les étiquettes (primaire, secondaire 1 et secondaire 2).
4 couleurs supplémentaires porteuse de sens, comme leur nom l'indique :
Les étiquettes sont disponibles dans les composants de mise en forme. C'est une petite indication qui attire l'oeil. Elle s'adapte bien à un texte court pour donner un qualificatif à une rubrique.
Paramètre disponible
couleurLes 3 couleurs que vous avez choisi dans votre configuration graphique sont disponible pour les étiquettes (primaire, secondaire 1 et secondaire 2).
4 couleurs supplémentaires porteuse de sens, comme leur nom l'indique :
- info, la couleur de l'étiquette info est une déclinaison plus claire de votre couleur primaire, elle offre un balisage visible mais se fond dans le contenu
- success, un vert synonyme d'un événenement positif ou d' "objectif validé"
- warning, pour un point de vigilance - une échéance proche
- danger, pour un point de désaccord ou un point urgent
Les onglets peuvent être considérés comme une sorte de menu.
Il y a 2 manières de faire :
Il y a 2 manières de faire :
- Onglets avec des parties de la page (recommandé si les contenus sont relativement simples ou courts)
- Onglets avec des pages différentes (recommandé si le contenu est riche ou si les pages sont déja créées)
- Attention dans ce cas : vous devrez recopier le code des onglets sur toutes les pages concernées ;-)
Paramètres
Les onglets peuvent être affichés de différentes manières :- en horizontal, c'est-à-dire au dessus de votre contenu (vous avez alors le choix entre souligné, sobre et justifié)
- en vertical, c'est à dire à gauche de votre contenu
Ce type d'encadrés ou d'accordéon permet d'afficher / masquer un texte. Il est disponible sous le nom "Encadré" dans les composants. L'action qui en découle s'appelle panel et se décline sous différentes formes : dépliée ou pas et dans les différentes couleurs de base de votre thème : Primary Secondary-1 ...
Cette mise en forme s'adapte particulièrement bien pour les FAQ (Foire aux questions)
Cette mise en forme s'adapte particulièrement bien pour les FAQ (Foire aux questions)
Paramètres
Type :- simple encadré
- accordeon ouvert
- accordéon fermé
Couleur : comme pour les étiquettes un jeu de couleurs correspondant à votre configuration graphique est disponible. Essayer d'adopter une couleur pour un type d'information.
Les sections (ou bandeau)
La section permet de définir un style pour un des blocs de votre page : un simple fond de couleur ou un bandeau avec une image de fond
Un fond de couleur avec votre couleur primaire mettra en avant votre texte.
Un fond en pleine largeur avec une image crée une séparation fluide entre 2 parties qui traitent de sujets différents (une image en pleine largeur doit avoir une dimension de 1920px de large - sa hauteur dépendra de la taille du texte contenu dans la section, si l'image est juste décorative vous devrez spécifier une hauteur à la section )
Paramètres
- texture : permet de choisir si un utilise une couleur unie ou des motifs en fond de section
- forme : la section peut aussi prendre une forme de blob un arrondi asymétrique
- tonalité : permet de jouer sur les contraste entre le texte et le fond pour assurer une bonne lisibilité
- afficher sur toute la largeur - permet de couvrir toute la largeur de l'écran (supprime les marges)
- les options animation pour mettre en mouvement une partie du contenu
- Nouveauté une option pour masquer/afficher une section aux utilisateurs non connectés
- L'option "Ne pas mettre de conteneur" est parfois utile si vous combinez plusieurs types de composants (section et colonnes par exemple) et que votre texte déborde
Les erreurs fréquentes : Les textes se chevauchent en version mobile
Si votre page contient des sections, évitez d'utiliser le paramètre "height", il vaut mieux laisser le comportement par défaut qui permet à la section de s'adapter au contenu - ainsi si la largeur de l'écran varie, la hauteur du contenu va s'allonger...Cette erreur courante peut être très facilement corrigé en supprimant le paramètre "height" de votre code correspondant à la section.
Télécharger le fichier Capture_exemple_section.png
Sur cet exemple, plusieurs sections permettent de structurer la page :
- une section avec une image de fond
- une section avec un motif diagonale (paramètre texture)
- une section avec un fond uni de couleur bleu
Les colonnes
Structurer le contenu
Le composant colonne vous permet d'insérer le code wiki pour 2, 3, 4, 6 ou 12 colonnes. L'écran étant divisable en 12 colonnes, à vous de le moduler la taille et le nombre de colonne pour obtenir la structure souhaitée.Paramètres
Vous choisissez le nombre de colonnes :2, 3, 4, 6 ou 12.Le code sera créé pour des colonnes de taille égale : si vous créez 2 colonnes le code indiquera size=6 pour chacune.
Mais vous pouvez adapter. Par exemple pour 2 colonnes : 1/3 (size 4) + 2/3 (size 8)
{{grid }}
{{col size="4"}}
{{section bgcolor="#d0e0e3" class="text-left" height="300" }}
=====size 4===== {{end elem="section"}}
{{end elem="col"}}
{{col size="8"}}
{{section bgcolor="#d0e0e3" class="text-left" height="300" }}
=====size 8===== {{end elem="section"}}
{{end elem="col"}}
{{end elem="grid"}}
Index
Conception technique du formulaire
Bazar – Conception technique du formulaire
Accéder à Bazar
Bazar est la partie base de données de YesWiki. On s'y rend de la manière suivante.- Menu roue crantée en haut à droite du wiki.
- Entrée « Formulaires ».
Notez qu'il faut être connecté avec un compte administrateur du wiki pour pouvoir utiliser certaines fonctionnalités Bazar.
L'écran qui se présente ressemble à ceci (image de droite).
Télécharger le fichier bazar.png
Les différents onglets en haut de cette page permettent d'accéder aux différentes fonctions de Bazar.
« Formulaires » vous permet de gérer vos formulaires.
« Rechercher » vous permet de rechercher parmi les fiches déjà présentes dans vos formulaires.
Vous pouvez également trier vos fiches pour n'afficher que celles appartenant à un formulaire donné.
« Saisir » vous permet de saisir des fiches dans un de vos formulaires.
« Listes » vous permet de créer les listes (et leurs contenus) que vous utiliserez ensuite dans vos formulaires.
« Importer » vous permet d'importer des données en nombre (en provenance d'un tableur par exemple) directement dans un de vos formulaire.
« Exporter » vous permet d'exporter les données d'un de vos formulaire pour un usage externe (dans un tableur par exemple).
Gestion des formulaires Bazar
Pour gérer les formulaires, il faut se rendre sur l'onglet « Formulaires » de la partie base de données de YesWiki.- Menu roue crantée en haut à droite du wiki.
- Entrée « Formulaires ».
- Onglet « Formulaires ».
Cet onglet 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.
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 ou 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.
Création d'un formulaire
Télécharger le fichier formulaire_creation.png
Modification d'un formulaire
Télécharger le fichier formulaire_modification.png
Nom du formulaire
Dans la première zone en haut de l'écran, on saisit (création), ou on trouve (modification), le nom du formulaire.- Ce nom peut être composé de plusieurs mots, comportant éventuellement des caractères accentués.
- Il est possible de modifier ce nom par la suite.
Description du fomulaire
Cette zone permet de saisir des explications pour comprendre l'objectif du formulaire depuis l'écran de gestion des formulaires (cf. 1 précédent).Ajout, suppression et réorganisation des champs du formulaire
Remarque concernant le vocabulaire – Nous appellerons « champ » la mise en œuvre technique d'une question.Depuis la version Doryphore de YesWiki, la gestion des champs du formulaire se fait au moyen d'un constructeur graphique. Celui-ci permet d'ajouter, modifier, supprimer ou réorganiser des champs dans le formulaire.
Télécharger le fichier formulaire_constructeur.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 intitulé (1),
- une représentation de leur aspect dans le formulaire final (2),
- un petit astérique rouge si le champ est obligatoire (3).
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).
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. Télécharger le fichier formulaire_constructeur_grab.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ééxistant.
Télécharger le fichier formulaire_constructeur_drop_field.png En relachant le bouton de la souris, le champ se crée.
Télécharger le fichier formulaire_constructeur_champ_creation.png
Modification d'un champ de formulaire
En cliquant sur le petit crayon correspondant à un champ, on peut modifier ses différents paramètres.Les détails sont dans l'onglet ci-dessous : "Types de champs des formulaires Bazar"
Enregistrer
Lorsque vous avez fini de modifier votre formulaire, vous devez valider au moyen du bouton du même nom en bas de page.A toi de jouer !
Dans les formulaires de ton wiki :- modifie le formulaire "Agenda"
- supprime la questions "Documents"
- glisse au-dessus de la question "Description" les 2 questions "Début et fin d'événement"
- crée un nouveau formulaire
- nomme le formulaire test ou en cohérence avec un vrai besoin
- modifie la question "Titre de la fiche"
- ajoute une question de type "texte long"
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Types de champs Bazar
Bazar propose de nombreux types de champs. Voici ceux auxquels vous aurez le plus souvent recours.Les types de champs les plus simples et les plus courants
Le seul champ indispensable : le titre
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.
Corollaire
Si un formulaire doit comporter une question obligatoire qui en sera le titre, il convient de choisir judicieusement celle-ci. Dans le cas de la participation à un goûter, par exemple, on pourra demander le prénom de la personne qui s'inscrit.Qu'advient-il de ce titre ?
Lors de la création d'une fiche par un utilisateur, YesWiki fabrique une page (d'un type particulier) à 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).
Le fait que chaque fiche soit également une page présente plusieurs avantages.
- Vous pouvez donner l'adresse d'une fiche (ex. : https://mon.wiki.fr/?LeTitreDeMaFiche) à quelqu'un sans pour autant que cette personne ait à chercher parmi toutes les fiches.
- Les différentes modifications de la fiche occasionneront autant de versions de la page.
- Il est possible de modifier les droits sur une fiche/page en particulier.
- Si vous modifiez le titre d'une fiche après sa création, le titre affiché sera bien modifié, mais pas l'adresse de la page.
- 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 ».
Champ de type texte court
Un champ texte permet la saisie de quelques mots.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.
Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.
Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.
Voir la liste des différentes valeurs possibles.
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 utilisateurs peuvent saisir.Champ de type « Texte long »
Une zone de texte permet la saisie d'un texte relativement long et pouvant courrir sur plusieurs lignes.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
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 connait 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 utilisateurs. 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.
- Éditeur wysiwyg – Ce paramètrage offre à l'utilisateur beaucoup plus de facilité de saisie. Son usage est toutefois à limiter pour des raisons d'ergonomie.
- 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.Champ de type « image »
Un champ de type image permet d'importer un fichier image qui sera ensuite visualisable dans la fiche.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
Paramètres spécifiques au type de champs « image »
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).Image par défaut
Ce paramètre permet de télécharger une image qui apparaitra par défaut si aucune autre image n'est téléchargée.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 redimension
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 redimension
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.Taille max
Ce paramètre permet de préciser une taille maximum. Ici l'unité est en octet, 2000000 correspond à 2Mo.Champ de type « upload de fichier »
Ce type de champ permet d'uploaded un fichier (par exemple au format PDF). Ce fichier est ensuite téléchargeable par les personnes qui visualisent la fiche.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
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).Label à l'affichage
Ce paramètre permet de choisir l'intitulé qui apparait au-dessus du bouton de téléchargement lors de l'affichage de la fiche. Par défaut l'intitulé est "Fichier : {filename}" c'est à dire Fichier : le nom du fichier téléchargé..Extensions présélectionnées
Lors de la saisie de la fiche, ce paramètre permet de présélectionner uniquement certains types de fichier pour faciliter la recherche du fichier à télécharger.Ex : .pdf" pour ne pré-sélectionner que les fichiers pdf ou .pdf,.jpg,.png" pour ne présélectionner que ces 3 extensions.
Type sémantique du champ
Champ de type « 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.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
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 renvoit vers un formulaire de contact automatiquement généré. L'email n'est donc pas visible par les personnes qui visualisent la fiche.Dans ce cas les paramètres avancés changent :
-affichage brut de l'email autorisé pour
- Envoi d'email autorisé pour permet de choisir qui peut voir le bouton permettant d'envoyer un mail grâce au formulaire de contact
- Peut être saisie par permet de choisir qui peut voir ce champ au moment de la saisie de la fiche.
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.Champ de type 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.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
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.Les autres types de champs
Lorsqu'on peut énumérer toutes les réponses possibles à une question
Il arrive fréquemment qu'on puisse énumérer (lister) toutes les réponses possibles à une question de notre formulaire, pour exemples : (oui, non) ou encore (sympathisant, adhérent, etc.).À quoi cela peut-il servir ?
Dans Bazar, cette énumération des réponses possibles se matérialise sous la forme d'une liste ou d'un formulaire dont les différentes fiches constitueront les réponses possibles.Lors de la phase 1 de conception du formulaire, ces énumérations (listes ou formulaires liés) vont permettre de poser les questions sous forme de :
- liste déroulante,
- groupe de cases à cocher,
- groupe de boutons radio.
Lors de la phase 3 d'affichage des résultats du formulaire, le recours à des énumérations permet de proposer des facettes afin que l'utilisateur puisse filtrer parmi les fiches remplies.
Les listes dans Bazar
Bazar permet de définir des listes que vous allez pouvoir utiliser ensuite dans des formulaires.Gestion des listes
Pour gérer les listes, il faut se rendre sur l'onglet « Listes » de la partie base de données de YesWiki.- Menu roue crantée en haut à droite du wiki.
- Entrée « Formulaires ».
- Onglet « Listes ».
Cet onglet se présente de la manière suivante (les nombres en rouge sur la capture d'écran correspondent aux numéros dans la liste ci-après).
1 – Le nom de la liste. C'est le nom sous lequel cette liste apparaîtra pour vous.
2 – Un aperçu de la liste. En cliquant sur la petite flêche descendante à droite, on peut faire apparaître l'ensemble des valeurs possibles.
3 – Le nom de la liste, vu du côté de YesWiki cette fois. Vous n'aurez a priori pas à utiliser ce nom.
4 – Ce petit bouton en forme de crayon permet d'accéder à la modification de la liste.
5 – Cette petite poubelle permet de supprimer la liste. Attention, il n'y a pas de moyen de récupérer une liste supprimée.
6 – Ce bouton permet de créer une nouvelle liste.
7 – Vous pouvez, si vous avez repéré sur un autre YesWiki une liste qui vous conviendrait, utiliser ce champ pour saisir l'adresse du wiki en question. Vous serez ensuite guidés pour récupérer la ou les listes qui vous intéressent sur ce wiki.
2 – Un aperçu de la liste. En cliquant sur la petite flêche descendante à droite, on peut faire apparaître l'ensemble des valeurs possibles.
3 – Le nom de la liste, vu du côté de YesWiki cette fois. Vous n'aurez a priori pas à utiliser ce nom.
4 – Ce petit bouton en forme de crayon permet d'accéder à la modification de la liste.
5 – Cette petite poubelle permet de supprimer la liste. Attention, il n'y a pas de moyen de récupérer une liste supprimée.
6 – Ce bouton permet de créer une nouvelle liste.
7 – Vous pouvez, si vous avez repéré sur un autre YesWiki une liste qui vous conviendrait, utiliser ce champ pour saisir l'adresse du wiki en question. Vous serez ensuite guidés pour récupérer la ou les listes qui vous intéressent sur ce wiki.
Création ou modification d'une liste
Pour modifier une liste ou utilisera donc le petit bouton en forme de crayon (cf. 4 précédent). Et, pour créer une nouvelle liste, on utilisera le bouton « Saisir une nouvelle liste ».Les deux boutons envoient sur un écran similaire, vide dans le cas de la création et chargé du contenu de la liste dans le cas d'une modification.
Création d'une liste
Télécharger le fichier liste_creation45.png
Modification d'une liste
Télécharger le fichier liste_modification45.png
Nom de la liste
Dans la première zone en haut de l'écran, on saisit (création), ou on trouve (modification), le nom de la liste (cf. 1 de la section précédente).- Ce nom peut être composé de plusieurs mots, comportant éventuellement des caractères accentués.
- Il est possible de modifier ce nom par la suite.
Saisie ou modification d'une valeur de la liste
Chacune des valeurs de la liste sera saisie dans une ligne.On y trouve deux valeurs et deux boutons :
- Le libellé ou texte – C'est le texte ou la valeur qui va s'afficher. Cela peut être un ou plusieurs mots ou des nombres. C'est le seul élément à saisir. Il faut valider une valeur en cliquant sur le +.
- La clef ou identifiant unique – C'est le nom que YesWiki va utiliser pour cette valeur.
- Dans la version 4.5 cette clef est générée automatiquement par YesWiki. Dans les version précédentes, nous recommandons de n'utiliser pour cette clef que des suites de caractères sans accents et sans espaces.
- Même si vous n'en verrez rien, c'est cette clef que YesWiki va stocker dans les fiches de formulaire pour lesquelles les utilisateurs ont choisi cette valeur de liste.
- Le bouton de suppression – Ce bouton permet de retirer cette valeur de la liste. Attention :
- une valeur supprimée ne peut pas être restaurée (pas d'annulation de la suppression). Si après avoir supprimé une valeur vous vous rendez compte qu'il s'agissait d'une erreur, vous devrez saisir à nouveau cette valeur.
- Quand vous supprimez une valeur d'une liste, cela ne change rien dans les différentes fiches de formulaires. Autrement dit, supposons que vous ayez une liste (oui, non), et que vous ayez un formulaire d'inscription dans lequel vous demandez au personnes si elles sont adhérentes au moyen de cette liste (oui, non). Si vous supprimer la valeur « oui » de la liste, toutes les fiches pour lesquelles les personnes ont répondu « oui » à la question « Avez-vous adhéré ? » vont conserver cette information.
- La poignée de déplacement – Cette poignée permet de changer l'ordre des valeurs dans la liste. Vous pouvez ainsi ajouter des valeurs selon vos besoins, puis réordonner la liste pour qu'elle se présente comme vous le souhaitez (par exemple, dans l'ordre alphabétique).
Ajouter une nouvelle valeur à la liste
Si vous souhaitez ajouter une valeur à votre liste et qu'aucune ligne de saisie n'est vide, vous pouvez en ajouter une au moyen du bouton +.Enregistrer
Lorsque vous avez fini d'ajouter des valeurs à votre liste, vous pouvez cliquer sur ce bouton afin de sauvegarder votre liste.Liste à plusieurs niveaux
La version 4.5 de YesWki permet de faire des listes à plusieurs niveaux.Vous allez déplier et saisir des valeurs de niveaux inférieurs avec la flèche à gauche de la valeur.
Voici un exemple avec 2 niveaux :
Télécharger le fichier CaptureListe2niveauxbazar.png On peut même imaginer 3, 4 ... niveaux :
Télécharger le fichier CaptureListe3ou4niveauxbazar.png Voici comment ça s'affichera lors de la saisie :
Télécharger le fichier affichagelisteplusieursniveaux.png Et voici comment ça s'affichera lors de l'affichage des données avec des facettes :
Télécharger le fichier vidoaffichagebazarfacetteplusieursniveauxdelistes.gif
Utiliser un formulaire en tant que liste
Bazar permet d'utiliser, dans un formulaire, un autre formulaire comme s'il s'agissait d'une liste. Les réponses à cet autre formulaire constituent alors les différentes valeurs de cette liste.Premier exemple
Vous avez un formulaire « projet » présentant des projets et un autre formulaire, « commentaire », permettant d'ajouter des commentaires sur ces projets.Vous souhaitez, au sein du formulaire « commentaire », permettre à l'utilisateur de choisir dans une liste déroulante dynamique la fiche « projet » qu'il souhaite commenter.
Second exemple
Vous avez un formulaire « recette » qui regroupe différents plats (un par fiche).Et, dans un autre formulaire (« menu » par exemple), vous souhaitez permettre à l'utilisateur de choisir dans une liste déroulante dynamique un plat parmi vos recettes.
Comment faire ?
Bazar va permettre de lier un formulaire à un autre. Dans notre premier exemple, des fiches du formulaire « commentaire » vont être liées à des fiches du formulaire « projet ».Pour cela on utilise un des champs :
Lors du paramétrage de ce champ, il faut :
- pour le paramètre « Origine des données », choisir « Un formulaire Bazar ».
- puis, pour le paramètre « Choix de la liste/du formulaire », indiquer le formulaire à partir duquel vous souhaitez que les utilisateurs choisissent.
Montrer les fiches liées
En reprenant notre premier exemple, on peut, lorsqu'on affiche une fiche « projet », montrer toutes les fiches « commentaire » s'y rapportant.Pour cela on utilisera, dans le formulaire « projet », un champ du type « Liste des fiches liées » dont le paramètre « Id du formulaire lié » contiendra l'identifiant Bazar du formulaire « commentaire » (point 5 sur cette page).
Champ de type « sélectionner »
- En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
- 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'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des 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).Champ de type « groupe de cases à cocher »
- En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
- 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'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des 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'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).Champ de type « groupe de boutons radio »
- En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
- 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'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
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
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.Identifiant unique
Télécharger le fichier champ_param_ID.pngCe 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é
Télécharger le fichier champ_param_label.pngIl 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
Télécharger le fichier champ_param_aide.pngCe 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
Télécharger le fichier champ_param_access_read.pngPar 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.Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.Voir la liste des différentes valeurs possibles.
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. 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).Champ de type « géolocalisation de l'adresse »
Télécharger le fichier champ_geoloc.png 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).
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_pays ».
Paramètres du type de champs « géolocalisation de l'adresse »
Obligatoire
Télécharger le fichier champ_param_oblig.pngCe paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.
Nom du champ latitude
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 ».Nom du champ longitude
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 ».Champ de type « titre automatique »
Télécharger le fichier champ_titre_automatique_etroit.png Pour qu'un formulaire Bazar fonctionne, il doit contenir un champ titre.
Plus exactement, il doit contenir un champ de type « texte court » dont l'identifiant unique soit « bf_titre ».
Cependant, il n'est pas toujours pertinent de nommer les fiches d'un formulaire à partir du contenu d'un seul champ.
Le champ de type « titre automatique » permet de fabriquer un titre à partir de plusieurs champs. Ce titre sera rempli automatiquement lors de l'enregistrement de chaque fiche.
Comment faire
- Laissez le paramètre « Intitulé » tel quel.
- Tout se fait avec le paramètre « Valeur ».
- Dans « Valeur », pour faire référence à un autre champ, vous devez encadrer son identifiant unique entre des doubles paires d'accolades (ex. : « {{bf_prenom}} », notez bien qu'il y a deux accolades ouvrantes avant l'identifiant unique du champ, et deux accolades fermantes après).
- Dans « Valeur », vous pouvez également ajouter du texte, avant, après ou entre les différents champs référencés.
- Supprimez le champ titre du formulaire (celui dont l'identifiant unique est « bf_titre »).
Exemples
Il y a très souvent plusieurs manières de faire la même chose. Ces exemples n'ont pour objectif que de faire comprendre le fonctionnement du champ.Prenons le cas d'un formulaire dans lequel on demande prénom et nom. On peut utiliser le champ titre avec pour libellé « Prénon Nom ». C'est simple, mais outre le fait que cela ne garantit pas que tout le monde saisira son prénom, ou son nom, ou les saisira dans cet ordre, cela ne permet pas de trier les fiches par nom de famille.
Dans ce cas là, on peut :
- demander le prénom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text » ;
- demander le nom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text1 » ;
- ajouter un champ de type « titre automatique » ;
- dans le paramètre valeur de ce champ, saisir « {{bf_text}} {{bf_text1}} ».
Dans le cas d'un formulaire d'organisation de goûters, on pourrait souhaiter construire le titre à partir du prénom et de la date du goûter. On pourrait alors avoir un titre tel que : « Théo vient le 14/02/2022 ».
Dans ce cas là, on peut :
- demander le prénom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text » ;
- demander la date dans un champ date obligatoire dont l'identifiant serait par exemple « bf_date » ;
- ajouter un champ de type « titre automatique » ;
- dans le paramètre valeur de ce champ, saisir « {{bf_text}} vient le {{bf_date}} ».
Recommandations importantes
- Assurez vous que les champs que vous allez utiliser pour construire votre titre sont bien obligatoires.
- Il n'y a pas d'aide, ni de contrôle lors de la saisie du paramètre « valeur » du titre automatique. En conséquence, il vous appartient de saisir l'identifiant unique des champs correctement (accolades et identifiant unique correctement écrit).
- Supprimez le champ titre du formulaire (celui dont l'identifiant unique est « bf_titre »).
- Cela ne fonctionne pas avec tous les types de champs (par exemple, le contenu d'un champ zone de texte ou case à cocher peut difficilement être utilisé pour contruire un titre). Donc, faites des essais avant de demander à tout le monde de saisir.
Paramètres du type de champs « titre automatique »
Intitulé
Laissez ce paramètre en l'état.Valeur
C'est dans ce paramètre que vous indiquez comment construire le titre.La référence à un autre champ se fait en écrivant son identifiant unique entre doubles accolades (ex. : « {{bf_text}} ») :
- deux accolades ouvrantes (« {{ »),
- puis l'identifiant unique du champ,
- puis deux accolades fermantes(« }} »).
Champ de type « liste des fiches liées »
Ce type de champs permet dans le cas où on un autre formulaire est lié à celui-ci, d'afficher les fiches ainsi liées. Ce champ a donc un comportement un peu spécial, puisque son effet n'est visible que dans la phase 3 d'affichage des résultats du formulaire. Un certain nombre de ses paramètres ne visent d'ailleurs qu'à définir le comportement dans cette phase d'affichage des résultats.
Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.
Voir la liste des différentes valeurs possibles.
Voir la liste des différentes valeurs possibles.
Paramètres génériques
Ce type de champ ne reprend que peu des paramètres génériques.Peut être lu par
Télécharger le fichier champ_param_access_read.pngPar 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.
Voir la liste des différentes valeurs possibles.
Peut être saisi par
Télécharger le fichier champ_param_access_write.pngPar 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.
Voir la liste des différentes valeurs possibles.
Paramètres spécifiques au type de champs « liste des fiches liées »
Id du formulaire lié
Ce paramètre, obligatoire, permet d'identifier le formulaire lié.Le formulaire lié est celui dans lequel vous avez posé une question (sous forme de liste déroulante, de cases à cocher ou de boutons radio) faisant référence au formulaire courant.
On doit saisir ici l'identifiant Bazar du formulaire lié (point 5 sur cette page).
Query
Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.Ce paramètre permet de n'afficher qu'une partie des fiches liées.
Vous trouverez plus d'information sur sa syntaxe ici.
Par défaut, si vous ne saisissez rien, toutes les fiches liées s'afficheront. C'est en général ce qu'on souhaite.
Params de l'action
Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.Vous pouvez utiliser ce paramètres pour préciser comment afficher les résultats.
Le plus fréquemment, on veut changer l'ordre d'affichage des fiches liées.
On va, par exemple, les afficher non pas triées par titre, ce qui est le comportement par défaut, mais par ordre antechronologique (si elles comportent un champ date).
Dans cet exemple, on saisira dans ce paramètre : « champ=bf_date ordre=desc ».
- « bf_date » est l'identifiant unique du champ date dans le formulaire lié.
- « champ=bf_date » indique que l'on triera les fiches liées en utilisant ce champ date.
- Et « ordre=desc » indique que le tri sera descendant, c'est à dire des dates les plus récentes aux dates les plus anciennes.
- On notera que les deux paramètres sont séparés par un espace.
Par défaut, si vous ne saisissez rien, les fiches liées s'afficheront triées par ordre alphabétique croissant de leur titre.
Nombre de fiches à afficher
Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.Si vous le désirez, vous pouvez préciser ici le nombre de fiches liées à afficher.
Par défaut, si vous ne saisissez rien, toutes les fiches liées s'afficheront. C'est en général ce qu'on souhaite.
Template de restitution
Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.De même que dans la phase 3 on choisit la manière d'afficher les fiches, on peut déterminer ici comment montrer les fiches liées. Cependant, il n'y a pas de jolie boîte de dialogue dans laquelle choisir son template d'affichage. Il faut connaître son nom et le saisir.
Par défaut, si vous ne saisissez rien, les fiches liées s'afficheront sous forme de liste en accordéon. C'est en général ce qu'on souhaite.
Type de fiche liée (ou label du champ)
Vous devez préciser ici le type de champ utilisé dans le formulaire lié pour effectuer cette liaison.- « liste » pour une liste déroulante.
- « checkbox » pour un groupe de cases à cocher.
- « radio » pour un groupe de boutons radio.
Champ de type « Custom HTML »
Télécharger le fichier Bouton_custom_html.pngComme son nom lʼindique, le champ « custom HTML » permet d'incorporer du code HTML dans un formulaire. L'intérêt est que cela permet d'ajouter du texte, par exemple pour contextualiser un ou des champs.
On peut définir si le texte en question apparaît lors de la saisie, ou de l'affichage des fiches, ou les deux.
Ce type de champ comporte uniquement des paramètres spécifiques.
Paramètres spécifiques aux champs de type « Custom HTML »
Contenu lors de la saisie
Ce paramètre permet dʼindiquer ce que lʼon souhaite quʼil sʼaffiche lors de la saisie d'une fiche.Contenu lors de lʼaffichage dʼune fiche
Ce paramètre permet dʼindiquer ce que lʼon souhaite quʼil sʼaffiche lors de la visualisation d'une fiche.Syntaxe commune aux deux paramètres
Si vous ne connaissez pas le code HTML, voici deux syntaxes que vous pourrez utiliser dans les paramètres de ce champ « custom HTML ».-
<p>Mon texte ici</p>quand on veut simplement expliquer quelque chose, pour le champ qui suit par exemple (<p>pour paragraphe). -
<h3>Mon titre ici</h3>quand on veut ajouter un texte plus gros, comme un titre pour une partie du formulaire (<h3>pour heading 3 cʼest à dire titre de niveau 3).
<p> ou <h3> et on termine par, respectivement </p> ou </h3>.Remarques
« Custom HTML » et questions conditionnelles — Dans le cas des questions conditionnelles, YesWiki crée deux champs :- un pour définir à la fois le début de la zone conditionnée et les conditions de son affichage ;
- un second pour marquer la fin de la zone conditionnée.
</div><!-- Fin de condition -->. Dans ce cas, il faut laisser ce champ et lʼétat (tout va bien se passer).Champs « custom HTML » trop complexes — Dans les versions courantes de YesWiki (4.3.1 et les précédentes), évitez de saisir dans un champ « custom HTML » les choses suivantes :
- du texte contenant un retour à la ligne (touche « entrée » du clavier),
- une suite d'éléments HTML (par exemple :
<p>Mon texte ici</p><p>encore du texte</p>ou<h3>Mon titre ici</h3><p>Mon texte ici</p>).
Utilisation poussée des champs « custom HTML » — Si vous maîtrisez HTML et le comportement des pages web, vous pouvez utiliser ce champ pour incorporer des éléments plus complexes à vos formulaires.
Pour aller encore plus loin avec Bazar
Champ de type « configuration des droits d'accès »
Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet de définir les droits d'accès qui seront affectés à chacune des fiches du formulaire. Vous pouvez donc ainsi préciser quelles catégories d'utilisateurs peuvent lire, saisir ou modifier ou encore commenter des fiches de votre formulaire.
Attention ! Cette configuration des droits d'accès ne s'applique qu'aux fiches saisies après son paramétrage. Autrement dit, si vous ajoutez ce « champ » à votre formulaire, ou si vous le modifiez, seules les fiches saisies ou modifiées après cet ajout, ou cette modfication, auront les droits que vous avez définis.
Attention ! Cette configuration des droits d'accès ne s'applique qu'aux fiches saisies après son paramétrage. Autrement dit, si vous ajoutez ce « champ » à votre formulaire, ou si vous le modifiez, seules les fiches saisies ou modifiées après cet ajout, ou cette modfication, auront les droits que vous avez définis.
Détails des paramètres
Peut voir la fiche
Télécharger le fichier champ_param_form_access_read.pngPar défaut, les fiches d'un formulaire peuvent être lues par toute personne (identifié ou non). Ce « champ » permet de modifier ce comportement pour les fiches du formulaire en question. On peut ainsi masquer ces fiches à certain.e.s utilisateurices.
Voir les différentes valeurs possibles.
Peut éditer la fiche
Télécharger le fichier champ_param_form_access_write.pngPar défaut, les fiches d'un formulaire peuvent être édités par toute personne (identifié ou non). Ce « champ » permet de modifier ce comportement pour les fiches du formulaire en question. On peut ainsi protéger ces fiches de façon à ce que seuls certain.e.s utilisateurices puissent les modifier.
Voir les différentes valeurs possibles.
Peut commenter la fiche
Télécharger le fichier champ_param_form_access_comment.pngPar défaut, les fiches d'un formulaire peuvent être commentées par toute personne disposant de cette autorisation sur le wiki. Ce « champ » permet de modifier ce comportement pour les fiches du formulaire en question. On peut ainsi restreindre les commentaires sur ces fiches à certains utilisateurs.
Voir les différentes valeurs possibles.
Ajouter des onglets à son formulaire
Télécharger le fichier formulaire_onglets.pngLorsqu'un formulaire comporte beaucoup de questions ou encore qu'on souhaite séparer les questions les unes des autres pour plus de clarté, on peut, avec Bazar, ajouter des onglets à son formulaire (voir l'exemple ci-contre).
Bazar met deux types de champs à disposition pour cela.
- Le type de champs « navigation par onglets » Télécharger le fichier champ_navigation_par_onglets_bouton.png
- Le type de champs « passage à l'onglet suivant » Télécharger le fichier champ_passage_onglet_suivant_bouton.png
- déclarer qu'on va utiliser des onglets dans ce formulaire (il n'en faut donc qu'un dans le formulaire),
- préciser le nom des dits onglets.
- marquer la fin de chaque onglet (il en faut donc un à la fin de chaque onglet),
- préciser le comportement de chaque onglet lors de la saisie et lors de l'affichage.
Champ de type « navigation par onglets »
Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet d'ajouter des onglets dans votre formulaire. Ces onglets peuvent être affichés lors de la saisie ou lors de l'affichage d'une fiche du formulaire.
Lorsque vous incorporez un tel champ dans votre formulaire, seront ajoutés automatiquement trois champs de type « passage à l'onglet suivant ». Vous pouvez, bien sûr, en ajouter d'autres ou en supprimer selon votre besoin.
Attention ! Il est nécéssaire que le nombre d'onglets soit cohérent avec les valeurs des paramètres « Pour le formulaire » et « Pour la fiche » du champ « navigation par onglets ».
Il s'agit, dans les faits, d'un outil qui permet d'ajouter des onglets dans votre formulaire. Ces onglets peuvent être affichés lors de la saisie ou lors de l'affichage d'une fiche du formulaire.
Lorsque vous incorporez un tel champ dans votre formulaire, seront ajoutés automatiquement trois champs de type « passage à l'onglet suivant ». Vous pouvez, bien sûr, en ajouter d'autres ou en supprimer selon votre besoin.
Attention ! Il est nécéssaire que le nombre d'onglets soit cohérent avec les valeurs des paramètres « Pour le formulaire » et « Pour la fiche » du champ « navigation par onglets ».
Paramètres du type de champs « navigation par onglets »
Pour le formulaire
Ce paramètre définit les onglets affichés lors de la saisie de la fiche.Si vous ne saisissez rien, il n'y aura pas d'onglets lors de la saisie de la fiche.
Vous devez saisir les noms des différents onglets, dans l'ordre, et en les séparant par des virgules (« , »). Par exemple : « Présentation,Adresse,Produits,Vente ».
Pour la fiche
Ce paramètre définit les onglets affichés lors de l'affichage de la fiche.Si vous ne saisissez rien, il n'y aura pas d'onglets lors de l'affichage de la fiche.
Vous devez saisir les noms des différents onglets, dans l'ordre, et en les séparant par des virgules (« , »). Par exemple : « Présentation,Adresse,Produits,Vente ».
Déplacer le bouton valider
Ce paramètre permet de déplacer le bouton de validation au dernier onglet.Couleur des boutons
Ce paramètre permet de choisir la couleur des boutons placés à la fin des onglets.Par défaut, ils seront dans la couleur primaire du wiki. Vous avez le choix parmi la palette de couleurs du wiki.
Taille des boutons
Ce paramètre permet de réduire la taille des boutons des onglets.Champ de type « passage à l'onglet suivant »
Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet de délimiter un onglet en en marquant la fin tout en précisant quand cet onglet doit être affiché (saisie, affichage).
Info Lorsque vous incorporez un tel champ dans votre formulaire, vous marquez la fin d'un onglet et le début d'un suivant.
Il s'agit, dans les faits, d'un outil qui permet de délimiter un onglet en en marquant la fin tout en précisant quand cet onglet doit être affiché (saisie, affichage).
Info Lorsque vous incorporez un tel champ dans votre formulaire, vous marquez la fin d'un onglet et le début d'un suivant.
Paramètres du type de champs « passage à l'onglet suivant »
Pour le formulaire
Ce paramètre définit si l'onglet est affiché lors de la saisie de la fiche.Par défaut, l'onglet est affiché lors de la saisie de la fiche.
Attention à être cohérent avec ce que vous avez saisi pour le paramètre « Pour le formulaire » du champ de type « navigation par onglets ».
Pour la fiche
Ce paramètre définit si l'onglet est affiché lors de l'affichage de la fiche.Par défaut, l'onglet n'apparaît pas lors de l'affichage de la fiche.
Attention à être cohérent avec ce que vous avez saisi pour le paramètre « Pour la fiche » du champ de type « navigation par onglets ».
Question conditionnelle
Il arrive que dans un formulaire on souhaite afficher certaines questions en fonction de la réponse apportée à une des questions précédentes.Cʼest ce qui se passe notamment lorsque lʼutilisateur répond « autre » à une liste déroulante ou à des cases à cocher, et quʼon lui propose alors un champ texte pour préciser (ce champ texte nʼapparaissant que dans ce cas).
La question conditionnelle fait donc suite à une question de type Liste (Sélectionner), Checkbox (cases à cocher) ou Radio (Boutons radio).
Illustrations
- https://boyer.earth/yeswiki/?SaisieParticipant (répondez « oui » à lʼune ou lʼautre des deux questions de la section intitulée « Votre projet support » pour voir apparaître de nouvelles questions).
- https://tourainebio.org/?PageAjoutProducteur#menu4 (répondez « oui » à certaines questions de ce 4e onglet pour voir apparaitre de nouvelles questions).
Télécharger le fichier champ_affichage_conditionnel_contexte.png Lorsque vous insérez un « Affichage conditionnel » dans votre formulaire, Bazar y crée deux champs.
- Le premier, intitulé « Condition »,
- Le second intitulé « Fin de condition ».
- placer, entre le champ « Condition » et le champ « Fin de condition », le ou les champs que vous souhaitez faire apparaître de manière conditionnelle ;
- préciser dans le champ « Condition », la condition d'apparition de ce ou ces champs ;
- laisser le champ « Fin de condition » en lʼétat.
Remarque 1 — Un couple de champs « Affichage conditionnel » (« Condition » et « Fin de condition ») définit une seule condition (même si elle peut être complexe). Si vous souhaitez obtenir différents comportements en fonction de différentes conditions, il vous faudra insérer et définir autant dʼaffichages conditionnels que de conditions à remplir.
Remarque 2 — Il peut arriver, dans certains contextes (formulaire long ou comportant de nombreux champs de type « Custom HTML »), que le champ « Fin de condition » apparaisse sous le nom de « Custom HTML ». Si cʼest le cas, vérifiez juste que son contenu est bien le suivant :
</div><!-- Fin de condition--> dans « Contenu lors de la saisie ».Remarque 3 — Il peut également arriver que, lors de l'affichage sous forme de liste des fiches dʼun formulaire comportant des questions conditionnelles, toutes les fiches semblent imbriquées les unes dans les autres et que seule la première fiche apparaisse (les autres semblant être à lʼintérieur). Si cʼest le cas, ajoutez, tout à la fin de votre formulaire, un champ de type « Custom HTML » dans lequel vous laisserez le paramètre « Contenu lors de la saisie » vide et saisirez
</div></div> dans le paramètre « Contenu lors de lʼaffichage ».Champ de type « condition »
Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet d'exprimer la condition qui sera nécessaire pour montrer tout ce qui se trouve entre « Condition » et « Fin de condition ».
Il s'agit, dans les faits, d'un outil qui permet d'exprimer la condition qui sera nécessaire pour montrer tout ce qui se trouve entre « Condition » et « Fin de condition ».
Paramètres du type de champs « condition »
Pour que cela fonctionne (et ait du sens), la condition doit faire référence à une ou plusieurs valeurs dʼun ou plusieurs champs de type énumération : Liste (Sélectionner), Checkbox (cases à cocher) ou Radio (Boutons radio).Condition
Ce paramètre définit la condition à respecter pour afficher les champs qui suivent (jusquʼà « Fin de condition »).Les règles de syntaxe de ce paramètre sont expliquées dans lʼencadré qui se trouve au dessus.
Voici quelques exemples pour illustrer cette syntaxe.
Rappel sur lʼidentifiant unique On suppose quʼon dispose de :
- un champ de type « Sélectionner » (ou radio ou checkbox) dont l'identifiant unique est bf_trucmuche
- une liste listeConfiture sur laquelle s'appuie ce champ (les valeurs étant : {1, figues}, {2, gingembre-tomates vertes}, … ,{5, autre}).
| Pour afficher si… | valeur du paramètre |
| on a répondu « autre » | bf_Confiture==5 |
| on nʼa pas répondu « figues » | bf_Confiture!=1 |
| on nʼa répondu ni « figues », ni « autre » | bf_Confiture!=1 and bf_Confiture!=5 |
| on nʼa pas répondu du tout | bf_Confiture is empty |
| on a répondu « figues » ou « gingembre-tomates vertes » (pareil quʼen dessous) | bf_Confiture==1 or bf_Confiture==2 |
| on a répondu « figues » ou « gingembre-tomates vertes » (pareil quʼau dessus) | bf_Confiture in [1,2] |
| dans le cas dʼune checkbox, on a répondu « figues » et « gingembre-tomates vertes » | bf_Confiture==[1,2] |
| dans le cas dʼune checkbox, moins de trois cases ont été cochées | bf_Confiture|length < 3 |
| dans le cas dʼune checkbox, au moins deux cases ont été cochées mais pas la case « autre » | bf_Confiture|length > 2 and bf_Confiture!=5 |
Si vous aimez l'histoire et en savoir plus sur les aspects techniques
Le code derrière les champs Bazar
Que se passe-t-il lorsque j'utilise le constructeur graphique de formulaire bazar ?Lorsquʼon crée ou modifie un formulaire bazar, deux méthodes nous sont offertes. La méthode par défaut dans doryphore est le constructeur graphique.
Télécharger le fichier dcfhabjikckbbnbi.png Celui-ci permet de construire son formulaire de manière relativement intuitive sans avoir recours à du code puisque son rôle est justement dʼécrire le code pour vous.
Il est cependant parfois utile de comprendre ce qui se passe derrière. Nous allons donc lʼillustrer avec deux exemples, le cas dʼun champ texte, et celui dʼun groupe de cases à cocher.
Tout dʼabord, quelques petites règles simples :
- à chaque champ placé dans le constructeur graphique, correspond une ligne dans lʼonglet « code » ;
- lʼordre est le même dans les deux onglets (les champs dans le constructeur graphique sont dans le même ordre que les lignes correspondantes dans lʼonglet « code » ;
- chaque ligne de code est composée de plusieurs paramètres et ces différents paramètres sont séparés par des groupes de trois astérisques (***) ;
- le premier de ces paramètres indique toujours le type de champ.
Voyons maintenant ce qui se passe dans le cas dʼun champ texte.
Lʼimage ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un champ texte se retrouve dans la ligne correspondante du code.
Télécharger le fichier alpdkgehbbnibiem.png
Si on regarde la ligne de code (on se rappelle que les différents paramètres sont délimités par « *** ») on constate, par exemple, que :
- le 1er paramètre contient bien le type de champ,
- dans le 2e on retrouve le nom du champ,
- le libellé du champ est dans le 3e paramètre,
- les 4e et 5e paramètres contiennent les nombres de caractères affichés et maximum respectivement,
- le 9e paramètre indique que le champ est obligatoire (« 1 »),
- le 11e paramètre contient le texte dʼaide,
- le 12e paramètre indique que le champ peut être lu par tout le monde (« »). Tous ces détails et bien dʼautres encore se trouvent sur la page https://yeswiki.net/?ChampsPossibles Regardons à présent les différences dans le cas dʼun champ de type groupe de cases à cocher.*
Lʼimage ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un groupe de cases à cocher se retrouve dans la ligne correspondante du code.
Télécharger le fichier oeimcnmcfckahabb.png
Le comportement est identique à celui que lʼon a vu pour un champ de type texte à la différence de :
- le 1er champ dans le constructeur graphique (intitulé «nom ») est vide et nʼa pas de correspondance dans la ligne de code ;
- le 2e paramètre de la ligne de code contient le nom de la liste utilisée pour ce groupe de cases à cocher ;
La page de référence pour retrouver le rôle de chacun des paramètres des codes de champ bazar est : https://yeswiki.net/?ChampsPossibles
A toi de jouer !
Dans le formulaire créé dans l'exercice précédent, amuse toi :- crée de nouveaux champs
- mets certains champs en saisie obligatoire
- crée une nouvelle liste
- retourne dans ton formulaire de test pour appeler cette liste dans une question de type "cases cocher"
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Index
Configurer les accès à certaines parties au sein même des pages
Configurer les accès à certaines parties au sein même des pages
Il est donc possible de limiter les accés en lecture et/ou écriture aux pages du wiki.Mais pourrions nous limiter les accès à certaines parties des pages ?
Et oui !
Lorsque l'on construit sa page wiki, on utilise souvent les composants.
La plupart de ces composants proposent dans leurs paramètres avancés, des choix permettant de limiter leur visibilité aux seuls utilisateurs autorisés.
- dans la cas d'un bouton (ou d'un onglet), vous pouvez le cacher aux utilisateurs qui n'ont pas reçu les droits d'accès vers la page vers laquelle ce bouton pointe.
- dans le cas d'une section, vous pouvez déterminer par qui elle sera "visible"
- ...
Ces opérations sont aussi réalisables pour les différents champs d'un formulaire .
A toi de jouer !
Dans une page "bac à sable" de ton wiki :- Crée une section qui ne sera visible que d'un certain groupe d'utilisateurices
- Crée un bouton qui ne sera visible que d'un certain groupe d'utilisateurices
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
CC-by-SA Gatien Bataille et Louise Didier
Index
Créer une page
Vous pouvez créer une nouvelle page où que vous soyez dans votre wiki : dans une page classique ou dans le menu.
La méthode la plus simple est de :
Donc, vous pouvez choisir de l'appeler nomdemapage ou comptesrendusdereunions.
Toutefois, ce sera plus lisible si vous alternez avec des minuscules et majuscules : « NomDeMaPage ». C'est la méthode traditionnelle de nommage des pages dans YesWiki, nous parlions de « ChatMot »).
Et, c'est encore mieux (notamment pour les moteurs de recherches) si vous optez pour les tirets (« nom-de-ma-page ») ou les soulignés (« nom_de_ma_page »).
Ça donne ça :
Télécharger le fichier page1newb.png Quand je clique sur « insérer », ça génère cette ligne de code :
Il ne vous reste plus qu'à sauver.
Quand le lien vient d'être créé mais que la nouvelle page est vide, un petit crayon apparait devant le lien. Il disparaitra quand vous aurez saisi, et enregistré, du contenu dans la nouvelle page.
Télécharger le fichier page3.png
La méthode la plus simple est de :
- créer un lien
- lors de la création de ce lien, saisir le nom YesWiki de la page que l'on souhaite créer.
Créer un lien
Dans la page en mode édition, cliquez sur le bouton « lien ».
Télécharger le fichier bouton_lien.png
Remarque importante — Dans le cas où vous choisiriez que le lien s'ouvre dans un nouvel onglet ou dans une fenêtre modale, YesWiki utilisera un bouton pour créer le lien (même si il l'affiche sous la forme d'un lien).
Télécharger le fichier bouton_lien.png
Vous serez alors guidé·e dans vos choix avec cette fenêtre :
Faites vos choix et cliquez sur « Insérer » : la ligne de code s'inscrit toute seule ;-)
Fenêtre modale : une fenêtre modale est une fenêtre qui vient s'afficher devant la page que vous êtes en train de visualiser (comme une « pop-up ») et que vous devez fermer avant de pouvoir retourner à la visualisation de votre page. Elle est, soit visible, soit fermée, contrairement à d'autres fenêtres qui peuvent être ouvertes et cachées derrière autre chose.
Faites vos choix et cliquez sur « Insérer » : la ligne de code s'inscrit toute seule ;-)
Fenêtre modale : une fenêtre modale est une fenêtre qui vient s'afficher devant la page que vous êtes en train de visualiser (comme une « pop-up ») et que vous devez fermer avant de pouvoir retourner à la visualisation de votre page. Elle est, soit visible, soit fermée, contrairement à d'autres fenêtres qui peuvent être ouvertes et cachées derrière autre chose.
Voici ce que ça donne quand on regarde le code :
[Aller à la page d'accueil](Accueil) > Aller à la page d'accueil[Aller sur le site de yeswiki](https://yeswiki.net/?Accueil) > Aller sur le site de yeswiki{{button class="btn-primary" link="mailto:louise@quincaillere.org" nobtn="1" text="Envoyer un mail à Louise" }} > Envoyer un mail à Louise
Nommer ma nouvelle page
La seule règle est que le nom de votre page ne comporte : « ni espace ni caractères spéciaux ».Donc, vous pouvez choisir de l'appeler nomdemapage ou comptesrendusdereunions.
Toutefois, ce sera plus lisible si vous alternez avec des minuscules et majuscules : « NomDeMaPage ». C'est la méthode traditionnelle de nommage des pages dans YesWiki, nous parlions de « ChatMot »).
Et, c'est encore mieux (notamment pour les moteurs de recherches) si vous optez pour les tirets (« nom-de-ma-page ») ou les soulignés (« nom_de_ma_page »).
Ça donne ça :
Télécharger le fichier page1newb.png Quand je clique sur « insérer », ça génère cette ligne de code :
[Cliquez ici pour ouvrir la nouvelle page](nom-de-la-page)Il ne vous reste plus qu'à sauver.
Quand le lien vient d'être créé mais que la nouvelle page est vide, un petit crayon apparait devant le lien. Il disparaitra quand vous aurez saisi, et enregistré, du contenu dans la nouvelle page.
Télécharger le fichier page3.png
Astuces
- Une fois votre nouvelle page créée vous pouvez enlever le lien qui y mène sans que la page disparaisse pour autant. Vous pouvez retrouver vos pages au moyen du menu roue crantée en haut à droite, puis en sélectionnant « Tableau de bord ». Cela peut être une bonne manière de cacher des pages.
- Une toute autre manière de créer une nouvelle page est d'aller, dans la barre d'adresse de votre navigateur, modifier l'URL. La dernière partie de l'adresse (après « /? ») correspond au nom de la page.
- YesWiki va interpréter tout ChatMot comme une nouvelle page. Si on veut écrire un ChatMot sans créer de nouvelle page (par exemple pour écrire « YesWiki » sans créer de page ni de lien), on l'encadre de doubles guillemets :
A toi de jouer !
Dans une page "bac à sable" de ton wiki :- Crée une nouvelle page avec ton prénom
- Finalise cette création de page en écrivant quelques lignes dans cette nouvelle page
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Index
Editeur de page
Éléments de base sur les pages
En mode édition, YesWiki vous offre une barre dʼédition comportant une série de boutons qui vous permettent dʼeffectuer la plupart des opérations de mise en forme.
Télécharger le fichier editer_une_page_barre.png
Ce qui donne :
Remarque : en mode édition, si vous ne voyez plus la coloration syntaxique après une liste à puces, il suffit de sauter une ligne, juste après la liste, pour la retrouver… (mais, même sans la coloration, tout le reste fonctionne).
Cela permet de laisser des explications par exemple ou même d'écrire du texte en préparation d'une publication future.
Télécharger le fichier editer_une_page_barre.png
Les principales astuces de mise en page
Lorsqu'on utilise la barre dʼédition de YesWiki, on constate que cela se traduit par lʼapparition de « codes » dans la page. Rassurez-vous ces codes ne sont visibles quʼau cours de lʼédition et se traduiront, lorsque vous enregistrez la page, par la mise en forme ou le comportement voulu. Voici quelques uns de ce code.Accentuation
**Gras**
//Italique//
__Souligné__
@@Barré@@
Titres
======Titre 1======
=====Titre 2=====
====Titre 3====
===Titre 4===
==Titre 5==
Insérer un filet horizontal
----
Ce qui donne :
Listes
- Liste à puces niveau 1 - Puce niveau 1 - Puce niveau 2 - Puce niveau 2 - Puce niveau 1
- Liste à puces niveau 1
- Puce niveau 1
- Puce niveau 2
- Puce niveau 2
- Puce niveau 1
1) Liste énumérée 1) Liste énumérée 1) Liste énumérée
- Liste énumérée
- Liste énumérée
- Liste énumérée
Tableaux
[| | **Nom** | **prénom** | **Couleurs préférées** | |Lagaffe |Gaston |jaune | |Lapalice |Jean |vert | |texte calé à gauche | texte calé à droite| texte centré | |]
| Nom | prénom | Couleurs préférées |
| Lagaffe | Gaston | jaune |
| Lapalice | Jean | vert |
| texte calé à gauche | texte calé à droite | texte centré |
Écrire en html
Si vous souhaitez introduire du HTML dans la page wiki, il faut l'entourer de """" pour qu'il soit traité correctement.
En réalité, une page internet est constituée de code HTML.
Et cʼest ce HTML que sait afficher votre navigateur internet (Firefox, Chrome, Safari ou autre).
Mais le HTML est verbeux et complexe. YesWiki met donc à votre disposition un code plus simple (celui qui est en partie décrit dans cette page). Et lors de l'affichage de la page, YesWiki traduit son code en HTML que le navigateur affiche alors.
Dans le cas où vous insérez du code HTML dans votre code YesWiki, les doubles guillemets ("") indiquent à YesWiki de ne pas traduire le code en question.
Et cʼest ce HTML que sait afficher votre navigateur internet (Firefox, Chrome, Safari ou autre).
Mais le HTML est verbeux et complexe. YesWiki met donc à votre disposition un code plus simple (celui qui est en partie décrit dans cette page). Et lors de l'affichage de la page, YesWiki traduit son code en HTML que le navigateur affiche alors.
Dans le cas où vous insérez du code HTML dans votre code YesWiki, les doubles guillemets ("") indiquent à YesWiki de ne pas traduire le code en question.
Placer du code en commentaire sur la page
En utilisant le code ci-dessous, on peut mettre du texte qui n’apparaît pas sur la page…
{# du texte que je ne souhaite pas afficher #}
A toi de jouer !
Dans une page "bac à sable" de ton wiki, écris un paragraphe avec :- un titre
- du texte en gras
- une liste à puces
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
En plus du texte, on peut vouloir ajouter des images, des documents à télécharger, voire des vidéos ou des fichiers audio. Avec YesWiki ceci est très facile ! Voici comment faire.
Télécharger le fichier inserer_image_bouton.png En fonction du type de fichier à insérer, YesWiki propose des interfaces différentes, mais le principe reste le même.
Pour plus d'infos, aller sur la page {{attach}} de la documentation YesWiki.
Bouton « fichier »
Dans la page en mode édition, cliquer sur le bouton « Fichier » permet de choisir un fichier qui se trouve sur votre ordinateur.Télécharger le fichier inserer_image_bouton.png En fonction du type de fichier à insérer, YesWiki propose des interfaces différentes, mais le principe reste le même.
Le bouton ouvre sur une fenêtre qui permet de choisir l'alignement de l'image, sa taille à l'affichage ainsi que le texte qui s'affichera au survol (texte de la vignette).
Télécharger le fichier inserer_image_fenetre3.png
En cliquant sur « Paramètres avancés », on peut ajouter un lien associé (en vert ci-dessous), des effets graphiques, modifier le texte alternatif et empêcher l'affichage de l'image lorsqu'on clique dessus (en jaune).
Télécharger le fichier inserer_image_fenetre_parametres2.png
On peut modifier l'image après l'avoir enregistrée. Pour cela il faut re-éditer la page, trouver le bout de code entre {{ }} qui concerne ce fichier et cliquer n'importe où dessus : un bouton crayon apparaît, il suffit de cliquer dessus pour afficher la fenêtre permettant de faire toutes les modifications que vous souhaitez.
Télécharger le fichier inserer_image_modifier_crayon2.png
Télécharger le fichier inserer_image_fenetre3.png
En cliquant sur « Paramètres avancés », on peut ajouter un lien associé (en vert ci-dessous), des effets graphiques, modifier le texte alternatif et empêcher l'affichage de l'image lorsqu'on clique dessus (en jaune).
Télécharger le fichier inserer_image_fenetre_parametres2.png
On peut modifier l'image après l'avoir enregistrée. Pour cela il faut re-éditer la page, trouver le bout de code entre {{ }} qui concerne ce fichier et cliquer n'importe où dessus : un bouton crayon apparaît, il suffit de cliquer dessus pour afficher la fenêtre permettant de faire toutes les modifications que vous souhaitez.
Télécharger le fichier inserer_image_modifier_crayon2.png
Ici le bouton ouvre une fenêtre qui permet de modifier le texte du lien et d'afficher le fichier sous forme de lien ou directement inclus dans la page.
Télécharger le fichier inserer_fichier_fenetre2.png
Comme pour les images, on peut
- cliquer sur Paramètres avancés pour ajouter un lien associé, des effets graphiques et que modifier le texte alternatif.
- et modifier le fichier après l'avoir enregistré en cliquant sur bout de code entre {{ }}.
Télécharger le fichier inserer_fichier_fenetre2.png
Comme pour les images, on peut
- cliquer sur Paramètres avancés pour ajouter un lien associé, des effets graphiques et que modifier le texte alternatif.
- et modifier le fichier après l'avoir enregistré en cliquant sur bout de code entre {{ }}.
Le principe est toujours le même. Ces fichiers seront interprétés sous forme de lecteur audio. Mais souvent ce sont des fichiers lourds qu'on a tendance à stocker sur des plateformes spécialisées (vimeo, youtube, peertube ...) pour ensuite les intégrer au wiki en iframe.
Le principe est toujours le même. Ces fichiers seront affichés sous forme de carte heuristique cliquable.
Vous avez envie de code ?
Pas de souci, vous avez ci-dessus les bouts de codes générés par les boutons, ils peuvent être créés directement sur votre page en mode édition, et modifiés comme vous le souhaitez.Pour plus d'infos, aller sur la page {{attach}} de la documentation YesWiki.
Une vidéo pour vous aider
Voir la vidéo (elle est faite à partir de la version précédente mais le principe est le même)A toi de jouer !
Dans une page "bac à sable" de ton wiki :- intègre une image en choissant la taille moyenne et le posionnement à gauche
- reviens modifier la configuration de l'image pour qu'elle soit de taille large, positionnée au centre, et qu'en cliquant sur l'image on arrive sur https://yeswiki.net/
- intègre un document PDF
- une fois sous forme de lien
- une fois affiché directement dans la page
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Pour intégrer une vidéo il est nécessaire qu'elle soit préalablement en ligne sur une plateforme spécialisée : YouTube, Viméo, PeerTube, etc.
Télécharger le fichier Video_menu.png
Vous pouvez alors utiliser l'action {{video}} disponible dans les composants.
Télécharger le fichier Video_composant.pngPar défaut, ce composant vous propose deux paramètres.
En cochant la case « paramètres avancés », vous pouvez faire afficher plus de paramètres.
Une autre méthode consiste à intégrer la vidéo en utilisant un iframe. Cependant l'action {{video}} vous permet un affichage responsive (c'est à dire qui sʼadapte à la taille de la fenêtre).
Télécharger le fichier Video_menu.png
Vous pouvez alors utiliser l'action {{video}} disponible dans les composants.
- Serveur de la vidéo – Vous pouvez choisir le serveur sur lequel se trouve la vidéo parmi PeerTube, Vimeo et Youtube.
- Identifiant de la vidéo – Il ne sʼagit pas de lʼURL complète de la vidéo. Le plus souvent, c'est la série de chiffres et lettres placée en fin d'URL. Par exemple, dans
https://www.youtube.com/watch?v=TNPnia5UCKk, lʼidentifiant de la vidéo est TNPnia5UCKk.
En cochant la case « paramètres avancés », vous pouvez faire afficher plus de paramètres.
- Instance du serveur PeerTube – Ce paramètre nʼest présent que si vous avez choisi PeerTube en tant que serveur de la vidéo.
- Ratio de la vidéo – Vous pouvez préciser le ratio qui vous convient pour afficher la vidéo.
- Largeur maximale – Par défaut, la vidéo sera affichée sur toute la largeur disponible. Si vous le souhaitez, ce paramètre vous permet de préciser la largeur maximale sur laquelle la vidéo sera affichée. Attention, cette largeur doit être saisie en nombre de pixels (par exemple : 500). Vous ne pouvez utiliser de pourcentage pour exprimer cette largeur maximale.
- Hauteur maximale – Par défaut, la hauteur dʼaffichage de la vidéo sera calculée automatiquement en fonction de la largeur disponible (de manière à conserver les proportions, ou ratio, initiales de la vidéo). Ce paramètre vous permet, si vous le souhaitez, de fixer la hauteur maximale dʼaffichage de la vidéo. Attention, cette hauteur doit être saisie en nombre de pixels (par exemple : 500). Vous ne pouvez utiliser de pourcentage pour exprimer cette hauteur maximale.
- Position de la vidéo – Ce paramètre ne prend effet que si vous avez précisé une largeur maximale inférieure à la largeur dʼaffichage disponible. Si vous spécifiez que la position de la vidéo doit être à droite, et qu'il reste de la place à gauche de celle-ci, alors YesWiki commencera à afficher le texte suivant la vidéo à gauche de celle-ci. Et réciproquement pour un choix dʼaffichage de la vidéo à gauche, le texte viendra à droite, sʼil reste de la place.
Une autre méthode consiste à intégrer la vidéo en utilisant un iframe. Cependant l'action {{video}} vous permet un affichage responsive (c'est à dire qui sʼadapte à la taille de la fenêtre).
A toi de jouer !
Dans une page "bac à sable" de ton wiki :- Insère la vidéo https://videos.yeswiki.net/w/qaiq6teGqAk6tDtwVaVsry (en plus cette vidéo peut t'intéresser ;-)
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Dans les pages d'un wiki on a souvent besoin de faire des liens vers d'autres pages ou d'autres sites. Encore une fois, c'est assez simple.
Les trois méthodes pour créer un lien
Cas d'un lien allant vers une page du wiki
Si vous souhaitez que votre lien aille vers une page de votre wiki, il suffit de saisir le nom wiki de cette page (par ex. : « Accueil »). Pour YesWiki, ce nom représente une URL.
Si vous souhaitez que votre lien aille vers une page de votre wiki, il suffit de saisir le nom wiki de cette page (par ex. : « Accueil »). Pour YesWiki, ce nom représente une URL.
Si vous saisissez l'adresse d'une page (par exemple : « https://yeswiki.net »), YesWiki, comprenant qu'il s'agit d'une adresse, générera un lien cliquable dont le texte sera l'URL elle-même (ou le nom de la page de wiki le cas échéant).
Dans la page en mode édition, cliquez sur le bouton « lien ».
Télécharger le fichier bouton_lien.png
Remarque importante — Dans le cas où vous choisiriez que le lien s'ouvre dans un nouvel onglet ou dans une fenêtre modale, YesWiki utilisera un bouton pour créer le lien (même si il l'affiche sous la forme d'un lien).
Télécharger le fichier bouton_lien.png
Vous serez alors guidé·e dans vos choix avec cette fenêtre :
Faites vos choix et cliquez sur « Insérer » : la ligne de code s'inscrit toute seule ;-)
Fenêtre modale : une fenêtre modale est une fenêtre qui vient s'afficher devant la page que vous êtes en train de visualiser (comme une « pop-up ») et que vous devez fermer avant de pouvoir retourner à la visualisation de votre page. Elle est, soit visible, soit fermée, contrairement à d'autres fenêtres qui peuvent être ouvertes et cachées derrière autre chose.
Faites vos choix et cliquez sur « Insérer » : la ligne de code s'inscrit toute seule ;-)
Fenêtre modale : une fenêtre modale est une fenêtre qui vient s'afficher devant la page que vous êtes en train de visualiser (comme une « pop-up ») et que vous devez fermer avant de pouvoir retourner à la visualisation de votre page. Elle est, soit visible, soit fermée, contrairement à d'autres fenêtres qui peuvent être ouvertes et cachées derrière autre chose.
Voici ce que ça donne quand on regarde le code :
[Aller à la page d'accueil](Accueil) > Aller à la page d'accueil[Aller sur le site de yeswiki](https://yeswiki.net/?Accueil) > Aller sur le site de yeswiki{{button class="btn-primary" link="mailto:louise@quincaillere.org" nobtn="1" text="Envoyer un mail à Louise" }} > Envoyer un mail à Louise
Voir la documentation du bouton
Si, pour créer un lien, on utilise le composant « bouton » même dans le cas d'un lien s'affichant dans l'onglet courant, on se laisse la possibilité de faire évoluer plus facilement le comportement de ce lien.
Comment faire ?
1. Dans la fenêtre de paramétrage du bouton, vous saisissez :
3. Choisissez les modalités d'affichage de la destination :
Les avantages à utiliser un bouton pour créer un lien.
Comment faire ?
1. Dans la fenêtre de paramétrage du bouton, vous saisissez :
- le texte du lien dans « Texte du bouton »,
- l'adresse de la page de destination du lien dans « Lien web ou nom d'une page de ce wiki ».
3. Choisissez les modalités d'affichage de la destination :
- si vous voulez que la destination s'affiche dans une fenêtre modale, sélectionnez l'option qui vous convient dans « Ouvrir le contenu du lien dans une popup » ;
- si vous voulez que la destination s'affiche dans un nouvel onglet ou une nouvelle fenêtre, sélectionnez « Oui » dans « Ouvrir dans une nouvelle fenêtre » ;
- si vous voulez que la destination s'affiche l'onglet courant, ne faîtes rien de tout cela.
Les avantages à utiliser un bouton pour créer un lien.
- Vous pouvez ajouter une icône à votre lien.
- Vous pouvez ajouter un texte qui s'affiche au survol du lien.
- Vous pouvez faire en sorte que le lien n'apparaisse pas aux utilisateurs qui n'ont pas accès à la page de destination.
- Vous pouvez modifier tous ces paramètres très simplement aussi souvent que vous voulez.
A toi de jouer !
Dans une page "bac à sable" de ton wiki, fais :- un lien vers la page d'accueil de ton wiki avec pour texte affiché "Revenir à l'accueil"
- un lien vers le site https://yeswiki.net avec pour texte affiché "clique ici pour accéder au site de yeswiki"
- un bouton qui indique "Forum yeswiki", qui envoie sur https://forum.yeswiki.net/ et avec un pictogramme de votre choix
- exercice toi à faire des liens nécessaires pour ton projet, en réfléchissant au type d'ouverture
- dans l'onglet courant
- dans un nouvel onglet
- dans une fenetre modale
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Avec YesWiki on peut facilement intégrer à son wiki des pages intéressantes.
On peut aussi tout simplement avoir besoin d'utiliser différents outils de travail coopératif et vouloir les centraliser dans notre wiki. Voici comment faire.
Ca peut ressembler à un de ces trois pictogrammes :
Le code « iframe » que vous allez trouver ressemblera à ça :
Vous allez sélectionner et copier ce code pour pouvoir le coller dans votre wiki.
Dans le bout de code à copier-coller, les paramètres (on parle d'attributs) width (largeur) et height (hauteur) permettent de spécifier la taille de ce cadre et ils sont renseignés en pixels. Vous pouvez modifier ces chifres pour ajuster la taille de la fenêtre.
Largeur
L'attribut width= est indispensable. Il peut indiquer un nombre pixels ou un pourcentage de la taille de l'écran.
Pour que la fenêtre prenne toute la largeur et s'adapte à l'écran vous pouvez indiquer width=100%
Hauteur
L'insertion iframe peut configurer sa longueur automatiquement via la class
Dans le code de l'« iframe », vous pouvez préciser frameborder="1" (avec cadre noir) ou frameborder="0" (sans cadre noir)
On peut aussi tout simplement avoir besoin d'utiliser différents outils de travail coopératif et vouloir les centraliser dans notre wiki. Voici comment faire.
Incorporer un « widget »
Un peu de vocabulaire
Un « widget » est un petit module qui permet à une page d'embarquer (encapsuler, intégrer… « embed » en anglais) et de re-publier dynamiquement des contenus et fonctions issus de services proposés par d'autres sites internet.Quelques étapes très simples
1. Trouver le code « iframe » permettant l'intégration
Un site propose souvent d'afficher ses contenus ailleurs que « chez lui », en fournissant un morceau de code HTML (appelé iframe), qui se trouve dans les options « Partager », « Intégrer » ou encore « Iframe ».Ca peut ressembler à un de ces trois pictogrammes :
<iframe name="embed_readwrite" src="""https://unsite.com/iframe""" width="100%" height="600" ></iframe>
Vous allez sélectionner et copier ce code pour pouvoir le coller dans votre wiki.
2. Coller ce code dans votre page wiki
Une fois le code collé dans la page il faut penser à ajouter avant et après deux guillemets.""coller ici le code HTML fourni par le site tiers""
3. Sauver et profiter !
Vous enregistrez ces modifications et vous pouvez profiter des fonctionnalités de cet autre site dans votre wiki : lire la vidéo, écrire dans le pad, lire un contenu…Bricoler le code
Changer la taille de la fenêtre
Le code « iframe » fourni peut être personnalisé, notamment pour les dimensions de la fenêtre intégrée.Dans le bout de code à copier-coller, les paramètres (on parle d'attributs) width (largeur) et height (hauteur) permettent de spécifier la taille de ce cadre et ils sont renseignés en pixels. Vous pouvez modifier ces chifres pour ajuster la taille de la fenêtre.
Largeur
L'attribut width= est indispensable. Il peut indiquer un nombre pixels ou un pourcentage de la taille de l'écran.
Pour que la fenêtre prenne toute la largeur et s'adapte à l'écran vous pouvez indiquer width=100%
Hauteur
L'insertion iframe peut configurer sa longueur automatiquement via la class
class="auto-resize" Ajouter ou enlever un cadre noir
La fenetre intégrée peut être encadrée ou non.Dans le code de l'« iframe », vous pouvez préciser frameborder="1" (avec cadre noir) ou frameborder="0" (sans cadre noir)
<iframe width="100%" src="""https://unsite.com/iframe""" frameborder="1" ></iframe>
A toi de jouer !
Dans une page "bac à sable" de ton wiki :- intègre un outil que tu utilises déjà : un pad, un GoogleDoc ...
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Index
Et si je dois modifier mon formulaire alors que des fiches ont déjà été saisies ?
Et si je dois modifier mon formulaire alors que des fiches ont déjà été saisies
Entre ce qu'on a conçu, même à plusieurs, et ce que la vie nous impose parfois, il y a une marge. Donc, il va peut-être vous arriver de devoir modifier un formulaire alors que des fiches ont déjà été saisies pour ce formulaire.Sans entrer dans les considérations techniques, voici quelques indications.
- Si on modifie le nom du formulaire :
- cela ne change rien dans le fonctionnement du formulaire ni pour ses fiches.
- Si on ajoute un champ :
- ce champ sera proposé à la saisie pour toutes les fiches à partir de ce moment là,
- ce champ sera vide pour toutes les fiches saisies auparavant, il faudra donc les modifier une par une pour compléter ce nouveau champ.
- Si on supprime un champ :
- lorsqu'on ouvrira une fiche de ce formulaire, ce champ n'apparaîtra plus.
- Si on modifie l'identifiant unique d'un champ :
- ce champ est « cassé » pour toutes les fiches. Ne faîtes pas cela !
- Si on modifie le libellé d'un champ :
- ce champ sera, à partir de ce moment là, affiché avec le nouveau libellé.
- Si on rend un champ obligatoire :
- ce champ sera obligatoire à partir de ce moment là,
- si vous essayez de modifier une fiche précédemment saisie dans laquelle ce champ serait resté vide, vous ne pourrez valider la fiche qu'après avoir complété ce champ.
- Si on supprime le caractère obligatoire d'un champ :
- ce champ ne sera plus obligatoire à partir de ce moment là,
- Si on modifie le texte d'aide d'un champ :
- le nouveau texte d'aide apparaîtra, à partir de ce moment là, pour ce champ.
Index
Exemples de mise en forme
Exemples de mise en forme pour une page d'accueil
Site vitrine
Télécharger le fichier site_vitrine.png
Copier le modèle Page exemple site vitrine
Quelques exemples inspirants:
https://tiers-lieux.fr
https://classe-dehors.org/
Intranet
Télécharger le fichier CapturePage7.png
Copier le modèle Page exemple intranet
Quelques exemples inspirants:
Ressourc'eure - gare centrale
Gare centrale évènement co-construire
Projet Transiscope
Evènement
Télécharger le fichier CapturePage11.png Copier le modèle Page exemple evenement
Quelques exemples inspirants:
https://rnhp2024.fr
https://co-construire.be
https://www.forum-ess.fr
https://nuitdeschercheurs-france.eu
Index
Gérer les accès des pages non encore existantes
Gérer les accès des pages non encore existantes
La gestion vue jusque maintenant permet de gérer l'existant mais comment gérer ce qui va s'ajouter au wiki ?
En ce qui concerne les pages
- soit en le faisant au fur et à mesure via les méthodes présentées ci-dessus
- méthode la plus courante (mais franchement pas pratique et fastidieuse)
- soit en attribuant des droits par défaut à toutes les nouvelles pages créées
- Pour ce faire, il faut aller dans la roue crantée/gestion du site/fichier de conf
- dans l'accordéon "droit d'accès" vous pouvez déterminer quelles seront les accès par défaut des prochaines pages
- Pour ce faire, il faut aller dans la roue crantée/gestion du site/fichier de conf
En ce qui concerne les fiches bazar
Assez souvent, la contribution sur les wikis se passe via des formulaires.Par défaut ces fiches sont ouvertes en lecture et écriture.
On peut limiter totalement ou partiellemement l'accès aux fiches ou à certaines parties des fiches.
Cela se réalise lors de la construction du formulaire via certains paramètres.
Pour chaque champ de votre formulaire vous pouvez décider des accès en lecture et écriture afin :
- de déterminer qui peut remplir ce champ (donc la visibilité de celui-ci en mode "saisie")
- de déterminer qui peut voir ce champ une fois la fiche existante
Vous pouvez aussi décider d'attribuer "par défaut" des droits particuliers à la fiche entière afin :
- qu'elle ne soit visible QUE par tel ou tel groupe d'utilisateurs
- qu'elle ne soit modifiable QUE par tel ou tel groupe d'utilisateurs
Cette gestion s'effectue via le champ "configuer les droits d'accès" de votre formulaire
Télécharger le fichier confidroitaccesformulaire.png
A toi de jouer !
Dans ton wiki :- modifie les droits d'accès par défaut dans le fichier de configuration
- crée une nouvelle page pour vérifier que la nouvelle configuration s'applique bien
- modifie les droits sur un champ dans un formulaire
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
CC-by-SA Gatien Bataille et Louise Didier
Index
Gérer les droits d'accès en masse
Gérer les droits d'accès en masse
Gestion des droits par utilisateur
La gestion utilisateur par utilisateur est trés fine MAIS présente quelques inconvénients :- lorsque vous avez limité l'accès de plusieurs pages à un utilisateur et qu'un nouvel utilisateur doit recevoir les mêmes accès, vous voilà bon à repasser sur chaque page pour y ajouter son nom ;-(
- idem dans l'autre sens, si un utilisateur doit "perdre" ses accès
Pour s'affranchir de ces limites, la notion de groupe a été introduite.
Un groupe reprend un ou plusieurs utilisateurs wiki. Il se nomme @nomdugroupe.
Un seul groupe existe par défaut sur le wiki @admins et contient par défaut un seul utilisateur à savoir celui qui a créé le wiki.
Ce groupe @admins a TOUS les droits sur TOUTES les pages du wiki.
C'est un groupe "sensible" donc car les utilisateurs qui s'y trouvent ont des pouvoirs importants sur le wiki et notamment des pouvoirs de suppression (de pages, de formulaires bazar, de listes...) avec des effets potentiellement complexes à "rattraper". Il faut donc être vigilant avec les utilisateurs que l'on va placer dans ce groupe.
Il est possible de créer autant d'autres groupes que souhaité.
Ces autres groupes n'ont aucun privilège sur le wiki. Ils sont simplement un regroupement d'utilisateurs. Ce regroupement, ce groupe (@poule, @coq, @...) pourra être utilisé dans la gestion des droits des pages du wiki comme on le ferait pour un utilisateur (on mettra le nom du groupe plutôt que le nom de l'utilisateur).
Ce faisant, si un utilisateur (membre du groupe @coq) quitte le projet et ne doit plus pouvoir modifier les pages auquels il avait accés en écriture, il ne faut pas repasser sur chaque page concernée mais il suffira de l'enlever du groupe @coq ;-)
Pour gérer les groupes (et les utilisateurs inclus) cela se passe sur la page "utilisateurs et groupes" accessible via la roue crantée / gestion du site (attention, il faut faire partie des administrateurs du wiki pour pouvoir modifier, créer, supprimer des groupes)
Voici à quoi ressemble la page
- pour voir le contenu des groupes : je choisis dans la liste et fait "voir/éditer"
- pour créer un nouveau groupe : j'indique son nom et fait "définir"
- pour supprimer un groupe (attention) : je choisis et fait "supprimer"
Pour ajouter ou retirer un utilisateur d'un groupe
lorsque j'ai cliqué sur voir/éditer le groupe concerné, il me suffit dans la case qui apparaît d'indiquer (ou de retirer) le nomwiki de l'utilisateur sur une ligne (sans virgule) et d'enregistrer
Télécharger le fichier ajoutgroupe.png
Gestion des droits des pages en masse
La gestion page par page c'est sympa mais quand on a 150 pages dans son wiki... ça peut vite devenir très long. Heureusement il existe une page permettant de gérer les changements des droits d'accès de plusieurs pages (toutes les pages) en même temps.Cette page se nomme "Droits d'accès aux pages" et est accessible via la roue crantée / gestion du site. (attention, il faut faire partie des administrateurs du wiki pour avoir accès à cette page)
Sur cette page, vous pourrez aussi voir les droits qui sont attribués à chacune des pages du wiki et pourrez cocher les pages qui doivent être modifiées et attribuer en bas les nouveaux droits en utilisant
en mode simple
via les listes déroulantes proposées (droit de lecture, droit d'écriture)Télécharger le fichier modesimple.png
en mode avancé
via les champs classiques (ceux qu'on retrouve quand on édite les droits d'une page seule)Télécharger le fichier modeavance.png
A toi de jouer !
Dans ton wiki :- Crée un nouveau groupe
- Inscris quelques utilisateurices à ce groupe
- Configure quelques pages comme modifiables seulement par ce groupe
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
CC-by-SA Gatien Bataille et Louise Didier
Index
Importer/exporter des formulaires d'un wiki à un autre
Importer/exporter des formulaires d'un wiki à un autre
Un formulaire peut donner lieu à deux types d'imports et exports.- L'import/export du formulaire lui même ("les questions").
- L'import/export des données d'un formulaire ("les réponses").
Importer un formulaire d'un autre yeswiki
Un formulaire sur un autre wiki vous inspire ? Vous pouvez récupérer sa trame pour ne pas repartir de zéro ou le copier « à la main ».Dans l'onglet "formulaires" en dessous du tableau des formulaires, se trouve un cartouche "Importer les formulaires d'un autre yeswiki". Renseignez-y simplement l'URL du wiki « modèle » dans la case prévue à cet effet. Tous les formulaires de ce wiki vont apparaitre et vous pourrez cocher ceux qui vous intéressent.
Attention !
- Les questions qui ont été protégées par des droits restrictifs (accès réservé aux admins par exemple) ne seront pas importées.
- Il est nécéssaire que les deux wiki soient sur la même version et qu'elle soit supérieur à Doryphore 4.5.
Astuces
- Il est possible de faire de même avec les listes
- Voici quelques modèles utiles sur https://yeswiki.net/serveur
Télécharger le fichier bazarimportformulaire.png
Importer/exporter des données
L'onglet "exporter" dans Bazar
Permet de télécharger le contenu d'une base de données au format CSV (format tableur qui sera reconnu par Excel par exemple).Télécharger le fichier bazarexporter.png
L'onglet "importer" dans Bazar
Permet d'incrémenter une base de données à partir d'un fichier.Attention ! La base de données et le fichier d'import doivent être structurés exactement de la même manière. Afin de bien préparer son fichier d'import, après sélection d'un formulaire, yeswiki propose de télécharger un exemple de fichier ".csv". Il est plus facile de construire son tableur en partant de cet exemple. Télécharger le fichier bazarimporter.png
Afficher les bases de données d'autres wikis
Les donnés Bazar d'un autre wiki sont intéressantes à afficher voire compiler sur le votre ? Pas de problème !Il est possible d'afficher sur une page d'un wiki A les données d'un wiki B. Pour cela on utilise par exemple le code :
{{bazarliste id="https://formations.yeswiki.net|1"}}
Celui-ci va afficher les fiches du formulaire 1 du wiki https://formations.yeswiki.net (vos cher·es formateurices YesWiki ;-))
Il est possible de cumuler les sources en ajoutant des virgules :
par exemple :
{{bazarliste id="1, https://formations.yeswiki.net|1, https://formations.yeswiki.net|2"}}
va afficher le formulaire n° 1 de votre wiki, ainsi que les n° 1 et 2 du wiki https://formations.yeswiki.net
Info ! Le contenu s'affichera avec le thème graphique du wiki récepteur : le look du wiki d'origine n'est pas récupéré.
Index
Introduction aux droits d'accès
Introduction aux droits d'accès
Yeswiki a beau être très ouvert lors de son installation (ce qui oblige à se poser quelques questions que nous aborderons lors du webinaire), il n'en offre pas moins une gestion fine des droits de lecture et d'écriture de son contenu.
Cette gestion permettra : - de limiter l'accès de tout ou partie du wiki à certaines personnes ou catégories de personnes (groupes)
- de protéger certaines parties (bandeau, menu, footer...) de votre wiki contre les modifications involontaires (ou intempestives)
- de garder certaines parties de votre wiki cachée (mais pas réellement fermées en accès)
Un préalable pour jouer dans les droits d'accès : exister sur le wiki
En effet seules les personnes ayant un compte sur le wiki peuvent modifier les droits d'accès aux pages et encore avec certaines limites. La seule personne ayant tous les droits est celle qui a créé le wiki (le super admin). Cette personne peut évidemment partager ses droits avec d'autres utilisateurs du wiki (voir plus bas)Il est donc nécessaire de pouvoir se créer un compte sur le wiki ou de se connecter à celui-ci. Cela s'opère via la roue crantée du wiki / se connecter (ou s'inscrire). En cas de perte du mot de passe, le lien "mot de passe perdu" pourra vous le renvoyer sur le mail indiqué lors de l'inscription.
=> plus d'infos sur https://yeswiki.net/?DocumentationIdentification
Une fois connecté, vous ne possédez pas encore beaucoup de droits (sauf si l'administrateur du wiki vous en a attribués) à savoir :
- créer des pages (vu précédemment)
- vous attribuer la propriété d'une page
- attribuer des droits d'accès en lecture et écriture sur les pages dont vous êtes propriétaire
- supprimer les pages dont vous êtes propriétaire
Devenir propriétaire d'une page
- On devient automatiquement propriétaire des nouvelles pages que l'on crée lorsque l'on est connecté sur le wiki (cela se vérifie en bas de page avec la mention propriétaire = vous)
- Pour devenir propriétaire d'une page sans propriétaire, il suffit de cliquer sur Appropriation (en bas de page) : se faisant vous recevez des droits de gestion sur cette page (même si ça ne se voit pas comme ça)
- On ne peut devenir propriétaire d'une page qui a déjà un propriétaire, mais le propriétaire lui même peut décider de vous nommer nouveau propriétaire de cette page. Si vous avez reçu des droits d'admin sur le wiki, vous pourrez devenir propriétaire de n'importe quelle page sans l'accord du propriétaire !
Supprimer une page dont vous êtes propriétaire
Lorsque vous êtes propriétaire d'une page, un bouton supprimer apparait en bas de page. Il vous permettra de supprimer définitivement la page et son historique (attention c'est sans retour d'où le message de confirmation !).Si vous avez reçu des droits d'admin sur le wiki, vous pourrez modifier toutes les pages, y compris celles dont vous n'êtes pas propriétaire.
Modifier les droits d'une page dont vous êtes propriétaire
En bas de page, vous allez trouver un bouton permissions. En cliquant sur celui-ci, une fenêtre popup va vous permettre de gérer les droits en lecture et écriture.Voici les possibilités qui vous sont offertes
Télécharger le fichier popuppermission.png
Ah oui j'oubliais, j'ai compilé des trucs et astuces très pratique sur cette page, vous allez aimer !
Cette gestion page par page et user par user est vite "pesante"
Pour dépasser cette lourdeur, - un module de gestion des droits des utilisateurs par groupe a été créé
- un module de gestion du droit d'accés aux pages en masse a été créé
A toi de jouer !
Dans ta page "bac à sable" de ton wiki :- modifie les droits en lecture
- modifie les droits en écriture
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
CC-by-SA Gatien Bataille et Louise Didier
Index
Les questions à se poser en amont
Les questions à se poser lors de la conception d'un formulaire Bazar
Lorsqu'on conçoit un formulaire, on se pose la question "qu'est-ce que je cherche à savoir ?", autrement dit, « quelles sont les questions auxquelles on souhaite que les utilisateurs répondent ? ».Cohérence des objectifs
En tant que concepteur, la première question que l'on doit se poser dans ce type de démarche est la suivante : « quel est l'objectif de ce formulaire ? »Cette question en amène quelques autres sur lesquelles il pourrait être constructif de se pencher.
- Cet objectif, que j'imagine, a-t-il été validé par le groupe auquel le formulaire est destiné ?
- Quel est mon objectif ?
- Les réponses à ces différentes questions sont-elles cohérentes ?
Éviter de vouloir la perfection
Au risque d'enfoncer quelques portes ouvertes et en supposant que le perfection existe…1 – Le formulaire parfait à vos yeux ne le sera pas nécessairement aux yeux des autres.
2 – Le formulaire parfait, aujourd'hui, ne le sera pas nécessairement demain (et oui, le monde change).
Au delà de ces considérations, voici deux aspects de la conception de formulaire pour lesquels il n'y a pas de bonne réponse absolue.
Le nombre de questions – Vaut-il mieux prévoir un fomulaire le plus complet possible afin d'éviter de solliciter trop souvent la participation ? A contrario, un individu normalement constitué ne risque-t-il pas de se décourager à la vue d'un questionnaire qu'il juge trop long ? Une réponse juste à ces interrogations se trouve peut-être dans les deux considérations suivantes.
- Quels sont, pour le groupe, les objectifs de votre formulaire ? Vous y tenez-vous ?
- Un individu est beaucoup plus enclin à produire un effort qu'il a décidé. Autrement dit, si vous avez conçu, de manière réellement coopérative, un formulaire, chacune des personnes partie prenante à cette conception sera plus volontiers volontaire pour le remplir.
Les informations obligatoires – Quand on y réfléchit bien, si on pose la question, c'est qu'on veut connaître la réponse. Une conséquence de cela est la tendance à rendre obligatoires beaucoup de questions de notre formulaire.
L'expérience montre que les formulaires comportant trop de questions obligatoires sont peu remplis. Les principales raisons en sont le découragement, d'une part, et, d'autre part, l'impossibilité, parfois, de remplir le formulaire en une fois, du fait de la nature de certaines questions.
Une bonne pratique consiste à se focaliser, pour les questions obligatoires, sur celles pour lesquelles l'absence de réponse priverait la fiche de tout son sens.
On évitera également de rendre obligatoire toute question dont la réponse peut demander une implication trop forte sauf si bien sûr c'est là l'objet du formulaire. Pour illustrer, demander aux gens ce qu'ils vont apporter est acceptable pour l'organisation du goûter de la semaine prochaine, mais risque de décourager quand il s'agit de l'encas de toutes les réunions du CA de l'an prochain (on y est pas encore et ça fait beaucoup).
Testez, corrigez, recommencez (itérations) – La conception du formulaire (1re phase) va avoir un impact sur son comportement aussi bien lors de la saisie des différentes fiches (2e phase) que lors de l'affichage de ses résultats (3e phase). Vous allez donc probablement découvrir des choses en cours de route et devoir adapter votre formulaire (1re phase).
Ce n'est pas grave !
Il sera donc judicieux de procéder à quelques tests de votre page de saisie et de votre page d'affichage des résultats avant de diffuser massivement les liens vers ces pages. Voire de le faire tester à des collègues qui apporteront leur regard neuf.
Prendre le contrôle sur son collectif
- Enfermez vous tout seul chez vous.
- Concevez le formulaire parfait.
- Imposez à tous les autres de le remplir.
- Obligez les à être heureux en consultant les résultats.
Si vous pensez ne pas être capable de réaliser au moins une des étapes ci-dessus, alors vous êtes face à une excellente occasion de mettre en œuvre de la coopération en co-élaborant votre formulaire.
A toi de jouer !
Sur un fichier texte ou sur ton cahier, note :- le 1er formulaire auquel tu penses pour ton wiki
- à quel besoin répond ce formulaire ? quel problème va-t-il résoudre ?
- quelles sont les 3 questions indispensables à ce formulaire
- comment vas-tu travailler, soumettre ce formulaire avec tes collègues ?
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Index
Lutter contre les spams en gérant les droits d'accès
Lutter contre les spams en gérant les droits d'accès
En cas de vagues de spams
Hélas comme la plupart des wikis ouverts (MediaWiki, DokuWiki), YesWiki n'échappe pas aux attaques de quelques emmerdeurs référenceurs soit-disant professionnels et autres robots de spam, qui polluent les contenus des pages.Les 10 commandements du lutteur anti spam
1. Je consulte régulièrement mon wiki2. Je m'abonne à son flux RSS
3. Je consulte la page TableauDeBordDeCeWiki de mon wiki (accessible depuis la "roue crantée")
4. Je vérifie les dernières pages modifiées dans le TableauDeBordDeCeWiki ou sur la page DerniersChangements
5. Je vérifie les derniers comptes crées sur la page TableauDeBordDeCeWiki. (Action {{Listusers last="20"}} )
6. J'édite les pages en question et je supprime les parties indésirables, puis je sauve. (Cela prend moins d'une minute)
7. Je protège l'accès en écriture des pages non collectives (PageRapideHaut, PageHeader, PageFooter, etc.)
7bis Je ferme temporairement l'entiereté du wiki en écriture
8. Je mets à jour mon YesWiki quand une nouvelle version sort.
9. Pour les plus endurcis, je fais le grand ménage avec l'outil despam (voir plus bas)
10. Je ne cède pas à la tentation de transformer mon espace collaboratif en bunker. Et je continue à mettre en balance les effets positifs de l'intelligence collective.
Les symptômes : comment identifier les spams ?
- Vous pouvez découvrir sur une ou plusieurs pages des liens vers des sites externes qui semblent sans rapport avec l'objet du wiki (qui vendent des robes de mariée, des sites indonésien sans rapport, des liens commerciaux vers la loi duflot, des textes en langue étrangère etc..)
- Il se peut aussi que de nouvelles pages soit créées, et dans certains cas de nouveaux utilisateurs wikis.
Fermer l'accès au wiki à certaines adresses IP
Souvent les vagues de spam proviennent d'une région spécifique et on peut s'en préserver via une fermeture des accès aux wikis à ces adresses IP spécifiques (les IP sont spécifiques des régions/pays)Vous pourrez régler ces détails dans la roue crantée/ gestion du site/ fichier de conf/ blocage d'adresse IP
Télécharger le fichier confblocageip.png
Il faudra au préalable que vous ayez installé l'extension IP block via roue crantée/gestion du site/mise à jour et extensions
Télécharger le fichier extensionipblock.png
Pour supprimer de nombreuses pages rapidement
Pour supprimer des pages il faut être connecté-e qu'admin. Il y a ensuite 2 méthodes :- coller ceci à la fin de l'url des pages à supprimer : /deletepage&confirme=oui
- installer l'extension Maintenance, puis créer une page où vous mettez l'action {{multideletepages}}
Mettre un wiki en hibernation
Si vous savez que votre wiki ne doit plus bouger dans les mois, années à venir, vous pouvez le mettre en hibernation : les modification ne seront plus possibles, le wiki sera en mode "lecture seule" (à part en désactivant l'hibernation !).Roue crantée > Gestion du site > Fichier de conf > Sécurité > Etat du wiki > hibernate
Pour découvrir l'ensemble des stratégies possibles face au spam => https://yeswiki.net/?LutterContreLeSpam
A toi de jouer !
Dans ton wiki :- Vérifie dans la page GererMisesAJour que ton wiki est bien sur la dernière version. Si besoin, fais la mise à jour.
- Installe l'extension "maintenance"
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
CC-by-SA Gatien Bataille et Louise Didier
Index
Mode multilangue
Traduire le contenu de vos pages
Votre projet est international, vos utilisateurs ne maitrisent pas tous le francais ? Avec YesWiki vous avez la possibilité de gérer la traduction des contenus.
Dans chacune de vos pages
Il existe un composant lang YesWiki permettant de proposer une version de votre page dans une autre langue .Sur une même page vous pouvez avoir
- un texte en francais, il sera précédé par {{lang="fr"}}
- un texte en anglais, il sera précédé par {{lang="en"}}
- un texte en espagnol, il sera précédé par {{lang="es"}}
Exemple
{{lang="fr"}}
=====Bienvenue=====
{{lang="en"}}
=====Welcome=====
{{lang="es"}}
=====Bienvenido=====Dans la barre de menu
Pour permettre aux utilisateurs de choisir leur langue, vous devez ajouter dans votre barre de menu le composant translation, il permettra d'ajouter des drapeaux pour identifier les langues de votre choix.Lorsqu'un utilisateur clique sur un drapeau anglais alors les contenus précédés de lang="en" seront affichés
Exemple :
Ajouter les drapeaux pour choisir la langueTélécharger le fichier drapeaux.png
- {{translation destination="fr"}}
- {{translation destination="en"}}
- {{translation destination="es"}}
Choisir la langue pour les intitulés de l'interface YesWiki
A la création du wiki, la langue choisie est le français, mais ce paramètre peut être modifié via le fichier de configuration. On y accède via : Roue Crantée / Gestion du site / Onglet Fichier de conf
Dans l'accordéon "Paramètres Principaux", le paramètre Langue par défaut - default_language permet de modifier la langue pour les menus et paramètres en mode édition et les pages comme la page de configuration.
valeurs possibles
valeurs possibles
- fr pour francais
- en pour anglais
- es pour espagnol
- pt pour portuguais
- ca pour catalan
- nl pour néerlandais
- auto pour la langue du navigateur
CC-by-SA Mélanie Michel
Index
Modifier le favicon
Modifier le favicon
Le favicon est le petit logo qui apparait sur l'onglet de votre navigateur à coté du titre de votre wiki. Par défaut c'est le logo YesWiki ✌️ mais l'idéal est de le remplacer par le logo de votre projet !- Le favicon est une version miniature de votre logo : il doit être carré, il est recommandé de redimensionner votre image au format 16px*16px ou 32px*32px.
- Pour modifier votre favicon vous devez d'abord le télécharger sur une page de votre wiki, par exemple sur la page "Gérer site" après le racourci vers les pages spéciales (menu, pied de page, etc...), c'est un bon endroit pour laisser les infos réservées à l'administrateur.
- Une fois que vous avez téléchargé votre favicon sur la page (grâce à la fonction attach), copiez l'url complète de l'image (clic droit sur l'image / copier l'url)
- Dans Gestion du site / onglet fichier de configuration , coller l'url de votre image dans le paramètre favicon
Index
Permettre la saisie des fiches
Bazar – Permettre la saisie des fiches
Vous avez à présent créé votre formulaire. Il vous faut à présent en permettre la saisie aux utilisateurs.Voici une méthode pas à pas :
1 – Créer une page qui sera uniquement destinée à la saisie des fiches de ce formulaire. Par exemple, pour permettre la saisie des fiches de mon formulaire d'organisation de gouter, je vais créer une page « SaisieConvive ».
Télécharger le fichier formulaire_saisie_composants.png2 – Cliquez sur le bouton « Composants », puis sur « Afficher un formulaire de création de fiche ».
Télécharger le fichier formulaire_saisie_choix_form.png3 – Dans la boîte de dialogue qui s'ouvre, cliquez sur la zone intitulée « Choisissez un formulaire ».
4 – Dans la liste de formulaires qui s'affiche, choisir celui pour lequel vous souhaitez créer une page de saisie. Une visualisation du formulaire s'affiche en partie dans la boîte dialogue.
4 – Dans la liste de formulaires qui s'affiche, choisir celui pour lequel vous souhaitez créer une page de saisie. Une visualisation du formulaire s'affiche en partie dans la boîte dialogue.
Télécharger le fichier formulaire_saisie_choix_fait.png5 – Optionnel –Si vous cochez « paramètres avancés », vous ferez apparaître une zone vous permettant d'indiquer dans quelle page vous souhaitez que l'utilisateur se retrouve après avoir validé la saisie de sa fiche.
Le comportement par défaut est que l'utilisateur reste sur la page où il était (dans notre exemple « SaisieConvive »).
Télécharger le fichier formulaire_saisie_action.png6 – Cliquez sur le bouton insérer dans la page. Cela donne ceci.
7 – Enregistrer votre page.
CC-by-SA YesWiki
Index
Personnalisation avancées CSS
Page CSS
Pour ajuster les couleurs plus précisemment
Si vous n'avez pas peur d'un peu de codeDes variables CSS sont disponibles dans le thème Margot pour vous aider à affiner le design :
couleur des titres
couleur des liens
couleur de la barre de menu...
Sur chaque wiki, il existe une page nommée PageCss qui permet d'ajouter du code CSS pour définir des styles personnalisés
Un extrait de code est disponible par défaut dans PageCss :
/* :root { */
/* couleur des titres */
/* --title-h1-color:var(--neutral-color); */
/* --title-h2-color:var(--primary-color); */
/* --title-h3-color:var(--secondary-color-1); */
/* --title-h4-color:var(--secondary-color-2); */
/*}*/
Ce code définit des variables de couleurs qui s'appliquent à l'ensemble du wiki.
Titre de niveau 1 - couleur neutre
titre de niveau 2 - couleur primaire
titre de niveau 3 - couleur secondaire 1
titre de niveau 4 - couleur secondaire 2
Dans l'exemple qui est fournit par défaut vous remarquez les caractères /* et */ : c'est le code pour commenter une ligne, c'est à dire signaler qu'elle ne doit pas être appliqué.
Titre de niveau 1 - couleur neutre
titre de niveau 2 - couleur primaire
titre de niveau 3 - couleur secondaire 1
titre de niveau 4 - couleur secondaire 2
Dans l'exemple qui est fournit par défaut vous remarquez les caractères /* et */ : c'est le code pour commenter une ligne, c'est à dire signaler qu'elle ne doit pas être appliqué.
Si vous souhaitez commencer la personnalisation il faudra d'abord enlever les commentaires pour les lignes que vous souhaitez personnaliser :
:root {
--title-h4-color:var(--neutral-color);
}
Il est possible d'utiliser soit les couleurs en hexadecimal (#092e67) soit les variables de couleurs qui correspndent aux couleurs que que vous avez choisies via la page Apparence
[IMPORTANT!]Après avoir fait une modif de style CTRL + MAJ + R pour vider le cache du navigateur
Pour aller plus loin
En insérant des instructions css vous allez pouvoir appliquer tous les éléments de style que vous souhaitez.Voici un lien vers la documentation de référence pour apprendre le CSS : https://www.w3schools.com/css/css_syntax.asp
Index
Le thème graphique Margot
Personnaliser l'apparence
Pour définir le style graphique de votre wiki, vous pouvez jouer sur les couleurs, les polices et les illustrations.
Thème graphique Margot
Le thème Margot est le thème standard livré avec la dernière version de YesWiki.Plusieurs variantes sont disponibles en modifiant le squelette, le style et la configuration graphique. A vous de trouver la bonne combinaison. La page LookWiki vous permet de changer le style très facilement : accessible depuis le menu Gestion du site / onglet Look
Squelette : choisir la disposition du site
Il propose plusieurs squelettes qui permettent de jouer sur la position du menu :Modèle classique avec barre de menu horizontale
Choisir le squelette : 1-colTélécharger le fichier Capture_dcran_classique.png
Barre de menu verticale
Choisir le squelette : 1-col-verticalmenu
Télécharger le fichier Capture_dcran_vertical.png
Avec une side bar
Choisir le squelette : 2-cols-left ou 2 cols-right
Télécharger le fichier Capture_dcran_2colsright.png
Style
Margot
Avec le style margot.css la couleur primaire s'appliquera à la barre de menu et à vos liens hypertextes.
Télécharger le fichier Capture_dcran_hackathon.png
Margot-fun
Un style graphique moins conventionnel avec une position du menu sous le bandeau header et une formeMargot light
Avec le style light.css la barre de menu sera blanche et seuls vos titres et les boutons "primaire" auront la couleur primaireConfiguration graphique : la palette de couleurs
1 .Vous pouvez choisir 3 couleurs principales pour votre site :
- la couleur primaire sera visible sur la barre de menu, les liens et les menus de niveau 1 et 2
- la couleur secondaire 1 sera utilisable pour les sections, boutons, les accordéons. Elle sera utilisée aussi en mode édition pour mettre en évidence certains paramètres dans le code des actions yeswiki, veillez à prendre une couleur suffisamment lisible (éviter le pastel pour la couleur secondaire 1)
- la couleur secondaire 2 sera utilisable pour les sections, les boutons, les accordéons
2 . Choisissez la police pour vos titres et pour vos textes.
3. Nommez votre configuration graphique et enregistrez la.
4. Vous pouvez maintenant l'appliquer sur tout le site : soit directement sur la page LookWiki , soit en passant par la page Gestion du site / onglet Thème, en bas de la page vous pouvez définir le style par défaut pour votre site.
Pour vous aider à choisir votre palette de couleurs
Générateur de palette de couleurs et outil de test de contraste : https://coolors.co/UI colors permet de générer des palettes sobres avec une seule couleur et des variantes de teinte : https://uicolors.app/create
Ou si vous n'avez pas la moindre idée, laissez-faire le hazard : https://randoma11y.com/
Choisir des polices
Si vous ne possédez pas de charte graphique, voici un site sur lequel vous pouvez prendre des exemples de combinaisons de police : https://typespiration.com/
A toi de jouer !
- Recherche les codes couleurs de ta charte ou choisis des couleurs dans une palette. Puis fais des essais de personnalisation du thème avec ces couleurs.
- Remplace le favicon de ton wiki par le logo de ton projet ou une image pertinente
Tu es en difficulté ou tu as des questions ? N'hésite pas à solliciter la communauté YesWiki sur le forum
Index
Structure du site
La structure de YesWiki
Par défaut une page wiki contient :
- une Page Titre : c'est le nom du wiki
- une Page Menu Haut : on peut y ajouter des liens vers les pages du wiki (menu et sous-menu)
- une Page Rapide Haut : il s'agit des pages d'administration du wiki, la roue crantée en haut à droite
- une Page Header : c'est une partie utile pour écrire le titre donné au wiki, ajouter une description, un logo... Cette partie est désactivée par défaut à partir de la version doryphore 4.5. Pour la réactiver, il est possible de suivre les instructions lisibles en mode édition de la page header.
- une Page Footer : autrement dit un pied de page, où se trouvent diverses informations au sujet due wiki
Il y a deux manières d'accéder à une page menu pour la modifier :
Par la roue crantée
Télécharger le fichier GereSite_modif_menu_roue.png Dans la page Gestion du site, on retrouve les liens vers toutes les pages citées ci-dessus.
Par l'url
Télécharger le fichier GereSite_modif_menu_url.png Pour les menus par défaut ces url sont :
- https://www.urldusite.ext/PageTitre
- https://www.urldusite.ext/PageMenuHaut
- https://www.urldusite.ext/PageRapideHaut
- https://www.urldusite.ext/PageHeader
- https://www.urldusite.ext/PageFooter
Pour créer ou modifier un menu...
... il faut savoir créer des liens (voir la doc)...
Les titres de menu coorrespondent à des liens menant à des pages, qu'elles soient déjà créées ou non.Si une page n'existe pas : un petit crayon s'affichera à côté de son nom. On pourra créer la page en cliquant sur ce nom.
...et des listes à puces (voir la doc)
Une page menu est organisée comme une liste de puces. Un niveau de menu correspond au retrait de la puce, soit un ou plusieurs espaces placés en début de ligne :- un seul espace avant le tiret créera un titre de premier niveau (toujours apparent dans le menu). Ici la page "Menu exemple".
- deux espaces avant le tiret créera un titre de deuxième niveau (apparent après avoir cliqué sur le titre de premier niveau). Ici les pages "Exemple annuaire", "Exemple agenda"...
N'hésitez pas à vous inspirer du code du menu déjà en place. Un wiki récemment installé a quelques éléments de menu justement pour vous montrer comment ça marche ;-)
Télécharger le fichier edit_menu_yeswiki_45.png
Se connecter
Le bouton munis d'un pyctogramme "personne" sert à s'identifier ou à se créer un compte ("s'inscrire") :Nous explorerons les détails de cette fonctionnalités dans le module qui traite de la gestion des droits.
Roue crantée
Cliquer sur la roue crantée en haut à droite donne accès à un certain nombre d'espaces dédiés à l'administration du wiki :
La roue crantée peut être personnalisée sur PageRapideHaut.
La roue crantée peut être personnalisée sur PageRapideHaut.
Tableau de bord
Dans le tablau de bord vous pouvez voir :- les derniers comptes utilisateurs créés
- les dernières pages modifiées
- la liste exhaustive des pages du wiki
Documentation
Vous avez là une intégration des pages d'aide du site yeswiki.netGestion du site
Cette page gestion du site est très importante. Elle donne accès à de nombreuses fonctionnalités d'administration :Télécharger le fichier gestiondusite.png
Accueil de gestion du site
Vous avez là un récap des menus et pages spéciales du wiki.Droits d'accès
C'est ici que vous pouvez indiquer qui a le droit de faire quoi sur quelle page.Il faut être identifié comme administrateur pour visionner et modifier les informations de cet espace.
Nous explorerons les détails de cette fonctionnalités dans le module qui traite de la gestion des droits.
Look
C'est par là que vous personnalisez le squelette et l'esthétique de votre wiki.Il faut être identifié comme administrateur pour visionner et modifier les informations de cet espace.
Nous explorerons les détails de cette fonctionnalités dans le module qui traite de la personnalisation graphique
Utilisateurs et groupes
Ici vous visualisez les comptes utilisateurs créés et vous pouvez les organiser en "groupes".Il faut être identifié comme administrateur pour visionner et modifier les informations de cet espace.
Nous explorerons les détails de cette fonctionnalités dans le module qui traite de la gestion des droits.
Mots clés
Si vous avez utilisé des mots clés pour qualifier vos pages wiki vous en trouvez un récap ici.Il faut être identifié comme administrateur pour visionner et modifier les informations de cet espace.
Fichier de conf
Certains éléments de configuration peuvent être personnalisés ici : accès par défaut, sécurité, indexation ...Il faut être identifié comme administrateur pour visionner et modifier les informations de cet espace.
Nous les explorerons au fil des modules.
Mises à jour / extensions
Vous pouvez voir ici la version du wiki et s'il s'agit de la toute dernière.Si vous êtes identifié comme administrateur vous pouvez faire les mises à jour.
Mes contenues
C'est ici que l'on peut retrouver la liste des contenues que l'on a créé ou édités.Formulaires
C'est ici que l'on configure Bazar : Bazar est une extension importante de Yeswiki qui lui ajoute des fonctionnalités de création et de gestion de bases de données (formulaires).Nous verrons ça en détails dans le module qui traite des formulaires.
Il faut être identifié comme administrateur pour créer ou modifier un formulaire Bazar.
Index
Une démarche en trois phases
Bazar – Une démarche en trois phases
Vous avez décidé d'utiliser un ou des formulaires pour faciliter la contribution.Quelques éclaircissements s'imposent sur la notion de formulaire.
Un formulaire va vous permettre 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.).
Prenons un exemple
1 – Supposons que je souhaite organiser un goûter et que j'utilise pour ce faire un formulaire dans lequel je demande :- le prénom de chaque personne,
- si elle apporte une boisson ou un gâteau (soyons fous !),
- une description plus détaillée de ce qu'elle apporte.
2 – Afin de permettre la saisie, je vais mettre à disposition une page sur laquelle je vais afficher le formulaire vide afin que chaque personne puisse y répondre.
Marguerite, Théo, Barnabé et Manon se rendent sur cette page et remplissent le formulaire. Lorsque chacune de ces personnes se rend sur cette page elle remplit sa fiche qui répond à ce formulaire.
Marguerite, Théo, Barnabé et Manon se rendent sur cette page et remplissent le formulaire. Lorsque chacune de ces personnes se rend sur cette page elle remplit sa fiche qui répond à ce formulaire.
3 – Pour que tout le monde puisse voir ce que chacun va apporter, je vais également mettre à disposition une page sur laquelle je vais afficher toutes les fiches de réponses au formulaire sous forme de liste (par exemple).
Je verrai sur cette page les fiches de Marguerite, Théo, Barnabé et Manon.
Je verrai sur cette page les fiches de Marguerite, Théo, Barnabé et Manon.
Un peu de vocabulaire
Nous appellerons formulaire le jeu de questions posées. Dans notre exemple, ce sont :- prénom,
- le type de ce que la personne apporte,
- des précisions sur ce que la personne apporte.
Les trois phases
Du point de vue de l'utilisateur, seules existent :- la page sur laquelle il ou elle pourra saisir sa fiche,
- et la page d'affichage sur laquelle on peut consulter les réponses au formulaire.
Mais pour vous qui allez fabriquer le formulaire, les choses sont légèrement différentes.
Vous allez devoir, avant même de fabriquer les pages de saisie des fiches et d'affichage des réponses, concevoir ce formulaire.
Nous avons donc trois phases :
- concevoir le formulaire,
- mettre à disposition une page pour la saisie des fiches,
- mettre en œuvre une page d'affichage des résultats du formulaire.
| Vous | L'utilisateur |
| Concevoir | |
| Permettre la saisie | Saisir sa fiche |
| Afficher les résultats | Consulter les résultats |
1 – 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.
On se place, lors de cette étape, à un niveau générique (le formulaire). On ne sait pas si Marguerite va répondre. En revanche, on sait qu'on veut collecter (et donc demander) le prénom de chacune des personnes qui répond au formulaire.
Cette phase de conception va avoir un impact sur le comportement du formulaire lors de la saisie des différentes fiches, mais également sur ce qu'il est possible de faire en termes d'affichage du formulaire.
Lors de la conception vous travaillerez dans la page Formulaires de votre wiki accessible via le menu roue crantée en haut à droite du wiki.
2 – Permettre la saisie des fiches
Pour construire la page de saisie des fiches vous travaillerez dans une page que vous aurez choisie à cet effet.3 – Afficher les résultats du formulaire
De même pour l'affichage des résultats du formulaire que vous mettrez en œuvre dans une page de votre choix.CC-by-SA YesWiki