Template

Un template (ou gabarit) est un modèle de mise en page réutilisable qui fixe la structure d’une page et ses éléments communs, comme l’en-tête ou la navigation. Il prévoit aussi les emplacements, appelés zones, où les contributeurs ajoutent du contenu. Dans Jahia, le contributeur le choisit quand il crée une page. Toutes les pages construites sur le même modèle partagent la même ossature.

Définition et fonctionnement

Le template permet à une grande organisation de laisser de nombreux contributeurs créer des pages sans que le site perde sa cohérence. La charte et la structure sont portées par la mise en page commune. L’équipe éditoriale se concentre sur le contenu. Une évolution de mise en page se fait une fois, au lieu d’être reprise page par page.

Dans Jahia, il définit la mise en page des pages ainsi que des contenus affichés comme une page à part entière (ressources principales, voir Content Template). Il peut contenir des éléments non modifiables et des zones dans lesquelles les contributeurs ajoutent et modifient des contenus, chacun rendu par une vue. Ces modèles sont écrits par les développeurs et livrés dans un module, par exemple un jeu de modèles, en JSP (la technologie de pages web de Java) ou, depuis Jahia 8.2, en JSX ou TSX (la syntaxe de balisage utilisée avec React) dans un module JavaScript.

Documentation Academy : formation développeur sur les jeux de modèles et leurs templates

Le template et le template de contenu : les différences

Le template organise la page entière. La vue rend un contenu particulier. Le template de contenu est un cas à part, qui donne une page complète à un contenu qui n’est pas une page.

Les notions de mise en page dans Jahia
Notion	Ce qui la distingue
Content Template	Il permet d’afficher comme une page complète un contenu qui n’est pas une page de l’arborescence, par exemple un article ou une offre d’emploi.
Vue	Une vue est le code qui transforme un contenu en HTML. Elle rend un élément, pas l’ossature de la page.
Zone	Une zone est un emplacement défini dans le code de la mise en page, où les contributeurs ajoutent leurs contenus.

Le template en pratique

Un site institutionnel peut fonctionner avec un petit nombre de mises en page, par exemple une page d’accueil, une page de rubrique et une page de contenu libre. Chacune fixe l’en-tête, la navigation et le pied de page. Chacune propose aussi des zones où les contributeurs composent leur page avec les composants autorisés. Les équipes créent des centaines de pages sans jamais toucher à la structure. En contrepartie, modifier un modèle partagé touche toutes les pages qui l’utilisent. Mieux vaut donc les recenser avant.

Questions fréquentes

Modifier un template change-t-il le texte de toutes les pages qui l’utilisent ?

Non. Une modification de la mise en page change la structure, les éléments communs ou les règles de rendu de toutes les pages concernées, mais pas les contenus saisis dans leurs zones. Les textes et les images restent ceux des contributeurs. Séparer la mise en page du contenu permet précisément de refondre une mise en page sans ressaisir le site.

Un contributeur peut-il créer lui-même un nouveau template ?

Non. Les templates sont écrits par les développeurs et déployés dans un module. Le contributeur choisit parmi les mises en page disponibles quand il crée une page, puis compose son contenu dans les zones prévues. Un besoin de nouvelle mise en page se formule donc auprès de l’équipe technique, qui l’ajoute au jeu de modèles du site.