Réaliser une surcharge d'extension dans un template

Qu’est-ce qu’une surcharge de template ?

Pour expliquer la notion de surcharge de template dans Joomla, voici une explication fonctionnelle et technique :

  • Fonctionnellement : c'est le fait de remplacer l’affichage prévu par Joomla, par un affichage personnalisé par vous-même.
  • Techniquement : c'est l'action de dupliquer un écran (du dossier /tmpl) d’une extension Joomla dans le dossier “/html” du template. Cela active la surcharge et Joomla utilisera ainsi cet écran pour afficher les données de l’extension concernée.

Créer la surcharge du rendu d'un article

Pour activer la surcharge de l'affichage d'un article, vous devez accéder à l’écran des substitutions de template de votre Joomla.

Dans la console d'administration :

  1. Menu Extensions > Templates > Templates,
  2. puis cliquez sur le lien “Détails et fichiers” de votre template,
  3. sélectionnez l’onglet “Créer des substitutions“,
  4. pour un article, cliquez sur le composant “com_content > article

 

Un message s’affiche pour vous confirmer que votre fichier de substitution, pour réaliser la surcharge, est créé.

Message
Substitution créée dans \templates\......\html\com_content\article
Substitution créée.

Note : Désormais quand un article sera affiché sur le site, le rendu utilisera le fichier de substitution que vous venez de créer.

Cette opération de création d'une surcharge peut être effectuée sur toutes les extensions présentes dans cet écran (Modules, Composants, ...) !

Modifier la surcharge du rendu d'un article

Pour personnaliser le code HTML/PHP de votre surcharge

  1. repassez sur le 1er onglet “Editeur”,
  2. cliquer sur “html > com_content > article > default.php

Lle dossier “html” dans les templates sert uniquement a contenir les substitutions des surcharges de template.

Le code du fichier HTML/PHP de l'écran d'affichage d'un article sera affiché dans une zone de saisie pour que vous puissiez le modifier et enregistrez vos modifications de personnalisation.

Supprimer la surcharge du rendu d'un article

Si vous supprimez le fichier de substitution, Joomla utilisera à nouveau le fichier de rendu original.

Pour le supprimer, retournez en modification (onglet "Editeur") du fichier default.php et cliquez sur le bouton [Supprimer le fichier] (en haut).

Note : vous pourrez à tout moment recréer la substitution en recommençant la procédure de création.