Une référence relie un contenu à un autre, comme un bien à sa ville ou un produit à sa marque. Cet article vous apprend à déclarer un champ de référence, à relier vos contenus dans l’éditeur et à afficher ces liens sur vos pages.
Comprendre une référence
Une référence relie un contenu à un autre, par exemple un bien à sa ville ou un produit à sa marque. Elle se pose par un champ de référence, que vous nommez et déclarez sur le type du contenu qui pointe.
Le contenu visé est le plus souvent un terme d’une catégorie, mais un champ peut viser n’importe quel type public. Une référence se lit dans les deux sens : le bien affiche sa ville et la page de la ville liste ses biens.
Un type peut porter plusieurs champs vers le même type. Un produit peut ainsi avoir une « Marque principale » et des « Marques partenaires », deux liens distincts vers la catégorie « Marques ».
Déclarer un champ de référence
Vous devez être administrateur du site.
- Dans le menu de l’administration, ouvrez Types de contenu.
- Cliquez sur Modifier sur la ligne du type qui pointe, par exemple Produits.
- Dans la section Champs de référence, cliquez sur Ajouter un champ de référence. Une ligne s’ajoute.
- Dans Nom de la référence, saisissez le nom du lien, par exemple
Marque principale. - Dans Type visé, choisissez le type des contenus à relier, par exemple Marques.
- Dans Cardinalité, choisissez Unique ou Multiple.
- Cliquez sur Enregistrer.
| Colonne | Effet | Valeur par défaut |
|---|---|---|
| Nom de la référence | Le nom du lien, affiché dans l’éditeur et dans les filtres. La clé technique en est tirée. Si elle est déjà prise, _2 s’y ajoute. | Vide. |
| Type visé | Le type des contenus qu’on peut relier. La liste donne chaque type avec son nom technique. | Aucun. |
| Cardinalité | Unique : un seul contenu relié, comme une marque principale. Multiple : plusieurs, comme des marques partenaires. | Multiple. |
Renommer un champ garde les liens déjà posés. La croix d’une ligne retire le champ à l’enregistrement.
Une catégorie visée par un champ apparaît dans le menu de l’administration sous le type qui la vise. Classer avec une catégorie le détaille.
Relier un contenu dans l’éditeur
- Ouvrez le contenu dans l’éditeur, par exemple un produit.
- Dans la barre latérale de droite, ouvrez l’onglet du document, celui qui porte le nom du type.
- Ouvrez l’onglet Références. Chaque champ de référence du type y a son bloc, sous son nom.
- Cliquez dans le champ Rechercher…. La liste montre dix contenus du type visé, par ordre alphabétique.
- Tapez quelques lettres pour affiner, puis cliquez sur un contenu. Il s’affiche au-dessus du champ.
Le lien s’enregistre dès que vous choisissez le contenu. Vous n’avez pas à enregistrer le contenu ouvert. La croix d’un contenu relié le retire aussitôt.
Un champ Unique n’affiche plus la recherche une fois un contenu choisi. Pour en changer, retirez-le puis choisissez l’autre.
La recherche propose les contenus publiés, les brouillons et les contenus privés que vous avez le droit de lire. Un contenu relié en brouillon n’apparaît sur votre site qu’une fois publié.
Afficher les références d’un contenu
Le bloc Références affiche, sur la page d’un contenu, les contenus reliés par un champ. Par exemple, la marque d’un produit ou les prestations d’une réalisation.
- Dans le contenu ou dans le gabarit de son type, ajoutez le bloc Références. Ajouter un bloc explique comment.
- Dans l’onglet Réglages de la barre latérale, panneau Champ de référence, choisissez le Champ à afficher.
- Mettez en forme les deux blocs qu’il contient, décrits dans le tableau qui suit.
| Bloc | Rôle | Réglage |
|---|---|---|
| Libellé de référence | Le nom du champ, affiché une fois, par exemple « Marque ». | Balise HTML, dans le panneau Balise du libellé. Par défaut span. |
| Contenu référencé | Le modèle répété pour chaque contenu relié. Il porte au départ le titre du contenu. | Plusieurs contenus : En ligne, séparées par des virgules (par défaut) ou En blocs (grille ou flex), une carte par contenu. |
Le Contenu référencé accepte les blocs d’une carte de liste : le titre, l’extrait et le média du contenu relié. Sur un terme qui a des couleurs et une icône, il les prend. Afficher les données d’un contenu explique comment afficher le titre ou un champ du contenu relié.
Posé dans un gabarit, le bloc lit le champ sur le type du contenu affiché. Un même gabarit sert ainsi tous les types qui déclarent ce champ.
Lister les contenus qui pointent vers une page
Sur la page d’un terme, une liste peut montrer tous les contenus qui le visent : sur la page « Lyon », les biens de Lyon. Vous n’avez pas à les choisir, la liste suit vos références.
- Ouvrez le terme dans l’éditeur, ou le gabarit des pages de sa catégorie.
- Ajoutez le bloc Liste de contenus.
- Dans l’onglet Réglages, panneau Requête, réglez Source de la requête sur Référence.
- Facultatif : dans Champ de référence, choisissez le champ qui doit pointer. N’importe quel champ de référence, le choix par défaut, les accepte tous.
- Facultatif : dans Limiter à des types de contenu, cochez les types à lister. Sans case cochée, la liste accepte tous les types.
La liste vise le contenu affiché : celui dont le contenu porte la liste, ou celui que montre le gabarit. Dans l’éditeur, son aperçu montre déjà les contenus qui visent le terme ouvert.
Choisir un champ précis sert quand un type pointe deux fois vers le même type. Avec « Marque principale », la page de Nike ne liste que les produits dont Nike est la marque principale.
Lister les contenus rangés de la même façon
Dans le gabarit des pages d’un type qui porte un champ de référence, une liste peut montrer les contenus rangés comme celui qu’on lit. Sur un article de la rubrique « Démarrer », elle montre tous les articles de « Démarrer ».
- Ouvrez le gabarit des pages du type dans l’éditeur.
- Ajoutez le bloc Liste de contenus.
- Dans le panneau Requête, réglez Source de la requête sur Frères et sœurs.
- Dans Référence partagée, choisissez le champ que les contenus partagent. Il est choisi d’office quand le type n’en a qu’un.
La liste montre tout ce qui pointe, par ce champ, vers ce que vise le contenu lu. Le contenu lu reste dans la liste, marqué comme le contenu courant. Sa carte prend l’état Active, que vous habillez dans l’onglet Styles de la carte.
Tant qu’aucun champ n’est choisi, la liste reste vide. La source Frères et sœurs n’est proposée que dans le gabarit d’un type qui déclare un champ de référence.
Filtrer une liste par référence
Une liste de contenus peut proposer à vos visiteurs de filtrer par référence, par exemple par ville ou par marque. Plusieurs valeurs cochées dans un même filtre élargissent le résultat, deux filtres le resserrent. Lister et filtrer vos contenus détaille les filtres.