Trouver le bon paramètre pour n'afficher que des éléments de formulaire choisis avec la balise Query de l'outil yes wiki (niveau avancé)


Objectif : pouvoir n'afficher que les éléments correspondant à un tri précis (donc sur une ou des valeurs de facettes) dans une page de yes wiki. Ceci nécessite une syntaxe précise utilisant la balise "query" en intervenant manuellement dans le code wiki d'une page. Non seulement le risque d'erreur est important, mais trouver le nom correct du paramètre avec lequel faire le tri est compliqué.

Exemple : Afficher les éléments de formulaire étant des Ateliers ou cafés numériques seulement (et pas les formations) sur une page.

Méthode :

Récupération des paramètres


  • On va afficher tous les éléments non triés sur une page en créant une page wiki, et on va y ajouter la facette de tri. Ceci peut se faire avec cet exemple en allant créer une page vierge puis en faisant "composants"/"afficher les données d'un formulaire".
  • Puis on choisit le formulaire à afficher : ici "Catalogue des ateliers et formations".
  • On choisit un mode d'affichage, par exemple "blocs".
  • Une fenêtre d'apercu apparait, avec en bas : "ajouter une facette".
  • Cliquer "ajouter une facette", cliquer sur "champ" et choisir dans notre exemple "Atelier ou formation - listeListeAxe2AccompagnementUsagesatelirerouformations".

Méthode 1 de récupération du bon intitulé pour le tri final (nom du champ de la facette pour yes wiki)

  • Quand on clique sur "champ" apres avoir choisi "ajouter une cafette" on a le titre lisible du champ puis "-" puis la chaîne de caractères qui nous intéressent. Hélas, elle n'est pas copiable...

  • Par contre, le code wiki généré par cette action nous permet de récupérer la chaine de caractères qui pourra spécifier notre tri final : listeListeAxe2AccompagnementUsagesatelirerouformations

  • Code wiki généré dans cet exemple :

{{bazarliste id="22" template="card" displayfields="visual=imagebf_image,title=bf_titre" groups="**listeListeAxe2AccompagnementUsagesatelirerouformation**" nbcol="3" }}
Méthode 2 via le handler /raw:

  • Suivre les étapes précédentes (création de la page avec la facette active).
  • Valider la page puis l'afficher. On voit ceci.
  • Ajouter /raw à la fin de l'adresse de la page dans la barre d'adresse de votre navigateur web.
  • Il s'agit d'un handler, une extension activable sur toute page du wiki.

On voit alors ceci.. Le paramètre recherché, c'est à dire le nom de facette, est possible à copier-coller. Cette méthode est utile notamment quand on cherche la chaine de caracteres de plusieurs facettes afin de les avoir sous les yeux, et de pouvoir les récupérer en copier-coller. Attention on ne peut ajouter /raw que si on a pas cliqué un choix de sélection dans la page.

Méthode 3 la plus simple et efficace, via page de test avec affichage facette

  • On crée une page avec la/les facettes qu'on veut isoler (cf ci-dessus).
  • On effectue la sélection dans le bloc facette de la page, en consultation comme un usager standard en lecture, exactement comme on souhaite la forcer ensuite, par exemple ici nous allons cliquer la case à cocher "ateliers et cafés numériques". Vous pouvez par exemple aller sur la page ici et sélectionner "Ateliers et cafés numériques".
  • La sélection s'affiche sur la page, mais l'adresse de la page a changé dans la barre d'adresse du navigateur et nous voyons ceci dans la barre d'adresse du navigateur internet:https://www.espacenumeriqueesc.fr/?Demo_Facette#listeListeAxe2AccompagnementUsagesatelirerouformation=A22** .

Et là on voit dans la barre d'adresse à la fois le nom correct de la facette de tri et la valeur cible pour trier correctement (ici uniquement les ateliers).

  • Nom correct de la facette : listeListeAxe2AccompagnementUsagesatelirerouformation
  • Valeur du choix de tri pour cette facette : A22

Faire un copier-coller de ces éléments (ctrl+C)

Etape suivante : intégrer le query dans le code wiki pour forcer le tri à l'affichage

La balise query est documentée par ici.
Ceci permet de filtrer les éléments et de ne proposer aucun autre tri en choix aux usagers, ou de combiner ce filtre avec des facettes et choix pour l'usager.

Pour afficher directement les ateliers uniquement, on va reprendre le code wiki de la page de test générée et ajouter query="listeListeAxe2AccompagnementUsagesatelirerouformation=A22".
Ceci va donner :

{{bazarliste id="22" template="card" displayfields="visual=imagebf_image,title=bf_titre" query="listeListeAxe2AccompagnementUsagesatelirerouformation=A22" nbcol="3" }}


Ce qui affiche bien uniquement les ateliers comme ci-dessous :

Aucun résultat


Important :

Query peut combiner le tri de plusieurs valeurs d'une facette ou de plusieurs facettes avec le séparateur "|" (voir documentation). Et bien évidemment il se combine avec les paramètres d'affichage classiques des données de formulaires.
Conseil de méthode :

  • Faites d'abord votre page de test avec la facette à isoler et récupérez nom et valeur pour le paramètre query.
  • Puis copier-coller nom et valeur de la facette, par exemple dans un bloc-note.
  • Recréez la page complètement pour le rendu final (autres champs de recherche, graphisme, etc)
  • Allez modifier à nouveau la page et complétez le code wiki avec query="nom de la facette=valeur|nom de l'autre facette= autre valeur", etc.

Normalement vous aurez combiné tris forcés et choix utilisateurs ainsi que votre affichage maîtrisé graphiquement sur votre page.

Bonne chance !