3.6 - Positions

Une position est un emplacement nommé où l'on publie un module. Corpus en déclare trente-six : les vingt-neuf de la mise en page, listées ici, plus six pour les templates article (article-1 à article-6, voir Les templates article) et trois pour les pages d'erreur.

Une position n'est pas un endroit fixe dans la page. C'est un nom, et c'est le Layout qui décide où ce nom s'affiche. Vous pouvez très bien mettre banner en pied de page : il suffit de le choisir dans le champ Position de la rangée concernée.

C'est pour cela que la liste ci-dessous donne l'usage prévu, pas une contrainte.

Les positions et leur usage prévu

Position	Usage prévu	Où le Layout la place par défaut
topbar-left	Réseaux sociaux, rappel court	Barre d'information, côté gauche
topbar-right	Téléphone, courriel, horaires	Barre d'information, côté droit
topbar	Héritée de Cassiopeia, outils, contact rapide	Aucune, à repointer
header-left	La zone à gauche du logo dans l'en-tête	En-tête, emplacement En-tête 1
menu	Le menu principal, replié derrière un bouton sur téléphone	Barre de navigation
search	Le module de recherche	Bande sous la navigation
breadcrumbs	Le fil d'Ariane	Entre la navigation et le contenu, toujours
banner	Une bannière pleine largeur	En-tête, emplacement En-tête 2
below-top	Une bande sous l'en-tête	Aucune, à choisir dans une rangée
top-a	Première rangée haute	Sections hautes, rangée 1
top-b	Deuxième rangée haute	Sections hautes, rangée 2
top-c	Troisième rangée haute	Sections hautes, rangée 3
top-d	Quatrième rangée haute	Sections hautes, rangée 4
main-top	Dans la colonne de contenu, au-dessus	Contenu, rangée haute
sidebar-left	Colonne latérale, à gauche par défaut	Contenu, colonne 1
sidebar-right	Colonne latérale, à droite par défaut	Contenu, colonne 2
main-bottom	Dans la colonne de contenu, au-dessous	Contenu, rangée basse
bottom-a	Première rangée basse	Sections basses, rangée 1
bottom-b	Deuxième rangée basse	Sections basses, rangée 2
bottom-c	Troisième rangée basse	Sections basses, rangée 3
bottom-d	Quatrième rangée basse	Sections basses, rangée 4
footer	Le pied de page, rangée haute	Pied de page
footer-bottom	Le pied de page, rangée basse, liens d’obligation	Pied de page
social-links	Réseaux sociaux	Aucune, à choisir dans une rangée
social-media	Réseaux sociaux, second jeu	Aucune, à choisir dans une rangée
float-pos	Un bloc flottant, hors flux	Rendu tel quel, sans habillage
debug	La barre de débogage de Joomla	En bas de page
error-403	Modules de la page « accès refusé »
error-404	Modules de la page « introuvable »

La différence qui compte : rangée de page ou rangée de contenu

C'est la distinction la plus utile de toute cette page.

Une section haute ou basse, top-a à top-d, bottom-a à bottom-d, prend toute la largeur de la page. Elle vit hors du contenu, avant ou après lui, et ignore les colonnes latérales.

Une rangée de contenu, main-top, main-bottom, reste dans la colonne du composant, au-dessus ou au-dessous de lui, quelles que soient les colonnes latérales publiées. C'est ce qu'il faut pour un bandeau d'alerte, un rappel ou un formulaire qui doivent rester alignés sur l'article.

Les deux se ressemblent tant qu'aucune colonne latérale n'est publiée. Dès qu'il y en a une, la différence saute aux yeux.

Trois positions à traiter à part

breadcrumbs n'est pas réglable. Le fil d'Ariane vit toujours entre la navigation et le contenu, dans sa propre bande. C'est délibéré : il dit où l'on est, sa place est contre la navigation, qui dit où l'on peut aller. Placé dans la section de contenu, il héritait de sa respiration et flottait au milieu du vide.

float-pos sort sans aucun habillage : pas de cadre, pas de titre de module. C'est à vous de mettre en forme ce que vous y publiez. Utile pour un bandeau de consentement ou un bouton d'appel.

C'est aussi la position du popup, et pour une raison précise : Corpus la rend en fin de page, sans conteneur autour. Un module en panneau posé dans une colonne latérale disparaîtrait avec elle au repli sur téléphone, panneau et icône compris. Voir Les modules de contenu.

debug n'affiche rien tant que le mode débogage de Joomla est désactivé.

Cacher un contenu sur téléphone

Trois niveaux, selon ce que vous voulez faire disparaître. Le seuil est le même partout : celui où le menu se replie derrière son bouton.

Un module, onglet Avancé, Suffixe de classe du module : desktop-only. Le mot se combine avec les autres : no-card desktop-only. Son contraire est mobile-only.

Dans les trois rangées hautes, seules ces deux classes-là passent. La barre d'information, l'en-tête et la navigation rendent leurs modules sans conteneur : un suffixe de classe n'y atteindrait pas le HTML. Corpus reporte donc desktop-only et mobile-only sur la boîte de l'emplacement. Les autres suffixes, un fond, un cadre, n'y ont aucun effet, et c'est volontaire : reportés sur la boîte, ils peindraient la zone entière au lieu du module.

Une bande entière, Theme Customizer, onglet Layout, la bande concernée, liste Classes : Cachée sur téléphone. Le choix inverse, Réservée au téléphone, existe aussi, pour un bloc d'appel qui n'a de sens qu'en mobilité, un numéro à composer par exemple.

Un morceau d'article, dans le code source, les classes de Bootstrap : d-none d-md-block cache en dessous du seuil et montre au-dessus, d-md-none fait l'inverse.

À lire avant de s'en servir. Cacher, ici, veut dire display: none : le contenu disparaît pour tout le monde, y compris pour les lecteurs d'écran. Un visiteur au clavier ou au son perd l'information, pas seulement l'encombrement visuel.

Réservez-le à ce qui est décoratif ou redondant : une illustration, une colonne qui répète ce qui est déjà dit au-dessus. Une information que le visiteur mobile ne trouvera nulle part ailleurs ne doit pas être cachée : sur un site public, il est souvent majoritaire.

Avant de cacher, demandez-vous si vous ne pouvez pas raccourcir, réordonner ou replier dans un accordéon. Les trois gardent l'information ; cacher la supprime.

Construire le pied de page

Le pied se monte avec des modules, pas avec le module Pied de page de Joomla : celui-là ne sort qu'une ligne de copyright et un lien vers joomla.org.

Position footer, la rangée haute. Publiez-y autant de blocs que vous voulez de colonnes ; ils se répartissent tout seuls. Un module Personnalisé pour la présentation, des modules Menu pour les listes de liens. Les modules y sortent sans cadre : dans un pied, le cadre ne sépare rien et alourdit tout. La largeur des colonnes se règle dans le Theme Customizer, onglet Layout, groupe Pied de page, auto répartit également, 4-4-4 impose trois colonnes égales.

Position footer-bottom : la rangée basse. Publiez-y un module Menu avec vos liens d'obligation : accessibilité, mentions légales, données personnelles. Ces liens changent d'un site à l'autre et l'un d'eux est obligatoire en France : ils vous appartiennent, le template ne les invente pas.

Deux choses sont posées par le template lui-même : le bouton Paramètres d'affichage, et la mention © année + nom du site, alignée à droite. Les deux se masquent et se réécrivent dans le groupe Pied de page de l'onglet Layout : voir Le Layout, § Le bas du pied de page.

Le nom du site vient de la configuration globale de Joomla, et non du texte du logo : voir L'apparence, § Le logo, pour la distinction entre les deux.

Si vous venez de Cassiopeia

Tous les noms de position de Cassiopeia sont déclarés dans Corpus. Vos modules restent publiés, à la même position, et réapparaissent au bon endroit dès que le Layout pointe dessus. main-top et main-bottom ont même comportement que chez Cassiopeia : dans la colonne de contenu.

Une seule reprise à faire : topbar. Chez Cassiopeia c'est la bande du haut ; dans Corpus cette bande a deux côtés, topbar-left et topbar-right. Repointez vos modules sur l'un des deux, ou pointez la barre sur topbar dans le champ Position du côté qui vous convient.

Comment savoir ce qui est publié où

Contenu → Modules du site, colonne Position, ou le filtre Sélectionner une position. Joomla n'affiche que les positions déjà utilisées : pour voir toutes celles que Corpus propose, ouvrez un module et déroulez le champ Position : elles y sont regroupées sous le nom du template.

Un module publié sur une position qu'aucune rangée n'affiche ne s'affiche nulle part, et rien ne vous le signale. Si un module reste invisible, vérifiez d'abord que sa position est bien choisie quelque part dans l'onglet Layout du style actif.

À jour pour Corpus 2.1.43.