La cellule - Fiche(s)
⚙️ Accès dans le BO :
Édition « Portail » > 👉 une page
La cellule Fiche(s) permet d'afficher dynamiquement des contenus issus de modèles de fiches, en proposant des options de personnalisation et de filtrage avancées.
Général
Modèle de fiche
Le menu déroulant « Modèle de fiche » permet de sélectionner un modèle de fiche ou une vue personnalisée comme source de données.
En optant pour une vue personnalisée, il est possible de restreindre les résultats en appliquant les critères définis dans cette vue (veillez à ce qu'aucun critère ne soit laissé vide).
Le tri configuré dans la vue personnalisée sera également respecté, par contre la disposition des colonnes de cette vue n'influera pas sur le rendu final dans la cellule.
Fiche(s) à afficher
Le menu déroulant « Fiche(s) à afficher » permet de sélectionner, dans tous les cas :
- toutes les fiches : ensemble des fiches contenues dans le modèle de fiche sélectionné ;
- un gabarit qui produit une liste d'identifiants de fiches, séparés par des virgules.
En fonction des paramétrages, il peut aussi afficher :
- une fiche dont l'identifiant est dans l'URL : cet identifiant est transmis en paramètre dans l'URL, par exemple depuis une page qui permet la recherche dans les fiches ;
- les fiches liées à une autre fiche présente sur la même page (relation inverse).
Restreindre l'affichage
Deux options permettent de limiter l'affichage aux fiches pour lesquelles l'utilisateur connecté est concerné :
- soit en tant qu'usager : « Restreindre aux fiches liées à l’usager connecté » ;
- soit en tant qu'agent instructeur : « Restreindre aux fiches accessibles à l’usager connecté ».
Visibilité
Par défaut, la cellule Fiche(s) est visible de tous. Vous pouvez restreindre cette visibilité à des usagers connectés ou non connectés, ou a des usagers ayant des rôles spécifiques. Il est également possible de conditionner l'affichage de la cellule.
Apparence
Titre
Par défaut, le titre affiché est celui de la fiche, configuré dans le gabarit du résumé du modèle de fiche.
Vous pouvez choisir de ne pas afficher de titre ou définir un titre personnalisé.
Slug
Ajouter un slug à une cellule Fiche(s) permet d'indiquer que cette cellule est la cellule principale.
Taille
Pour afficher le guide de taille comme sur la capture d’écran ci-dessus, sélectionnez une disposition de grille en colonne (une, deux ou trois) dans les Options, au lieu de l’option « Manuel ».
Classes supplémentaires pour le style par CSS
Il est possible d'ajouter des classes CSS réutilisables.
Affichage
Nombre de fiches par page (par défaut : 10)
Afficher le champ de recherche
La case à cocher qui permet d'afficher un champ de recherche sur les fiches n'est visible que lorsque la cellule est paramétrée pour afficher toutes les fiches.
Filtres
Paramétrage côté backoffice
Affichage en frontoffice
Mode d'affichage
Il existe plusieurs modes d’affichage pour les fiches :
- Carte : juxtapose les fiches à l’écran comme des cartes à jouer, avec une configuration possible de chaque carte.
- Tableau : affiche les fiches sous forme de tableau, avec une ligne par fiche, chaque ligne étant configurable.
- Liste : propose par défaut un lien vers chaque fiche, mais ce mode peut également être personnalisé.
Personnaliser l'affichage
L’option « Personnaliser l’affichage » offre une interface de composition graphique qui permet :
- de sélectionner uniquement les champs à afficher ;
- de personnaliser le contenu et l’agencement des éléments selon vos besoins.
Cette fonctionnalité est idéale pour créer des interfaces métier sur mesure, adaptées à des cas d’usage spécifiques.
L’interface propose de nombreuses options avancées, parfois complexes, qui s’adressent principalement à des utilisateurs expérimentés. Elle permet d’afficher différents types de contenu pour les modes « Carte » et « Tableau » tels que :
Champ de la fiche
Lorsque le mode d'affichage est « Carte », il est possible de sélectionner un champ du modèle de fiche, de spécifier le contenu du champ (Libellé et valeur / Libellé uniquement / Valeur uniquement) et le mode d'affichage en cas de valeur absente (Inclure la case vide / Ne pas inclure la case / Inclure un texte personnalisé) et de déterminer la taille.
Lorsque le mode d'affichage est « Tableau », il est possible de sélectionner un champ du modèle de fiche, d'ajouter un de choisir la largeur de la colonne qui s'exprime en pourcentage, par exemple : 15%.
Il est possible de présenter les fichiers (PDF) sous forme de vignette. Une fois sélectionné le champ contenant le PDF, on peut choisir de lui appliquer le mode vignette.
Champ utilisateur
Lorsqu'un usager est associé à une fiche, il est possible de sélectionner un champ du profil usager.
Champ information de la fiche
- Des informations générales sur la fiche (date de création, de modification, statut, identifiant)
Personnalisé
- Des informations personnalisées (sous forme de gabarit dans lesquels on peut utiliser des variables du type {{ card.fields.IDENTIFIANT-DU-CHAMP }} pour afficher la valeur d'un champ de la fiche).
Lien
- Des liens (éventuellement affichés sous forme de bouton).
Lorsque le type de contenu est défini comme un lien, le libellé est affiché même si la destination du lien ne renvoie aucune valeur. Cela permet, via une condition d’affichage, de proposer soit un texte, soit un lien, selon la valeur retournée.
Action
- Une « Action » pour afficher un bouton d'action déclenchant une action globale du workflow de la fiche. Cette action globale doit être configurée avec un déclencheur externe.
Aller plus loin
Lier un modèle de fiche à une page
Dans le menu burger d'une page, il est possible de lier cette dernière à un modèle de fiche. Ce sera utile en particulier pour une page dédiée à l'affichage d'une fiche donnée et qu'on souhaite pouvoir atteindre en mettant le numéro de fiche dans l'URL.
Lorsqu'une page du portail est liée à une cellule Fiche(s), le titre de la page (la balise <title>) devient désormais le titre (le display_label) de la fiche concernée. Par exemple si la page est utilisée pour afficher la fiche d'une école, le titre de la page sera le nom de cette école.