Surcharges de templates de modules

Enfin, nous terminerons ce long tutoriel par vous présenter un avantage du thème xSwatch4 qu'est la surchage des templates de modules.
Ces surcharges de templates de modules, réalisées en Bootstrap4 vous garantissent un design totalement responsive (adaptatif), quelques soient les pages affichées de modules .
Le système de surcharges dans XOOPS est une fonctionnalité qui permet au designer du site web de remplacer / modifier un template d'un module sans modifier les fichiers d'origine du module.
Ainsi, lors d'une mise à jour du module, le travail de modification ne sera pas écrasé.

Un tutoriel dédié au système de surcharges dans XOOPS sera bientôt réalisé.
Comprendre les surcharges dans XOOPS
Ce tutoriel n'est pas encore disponible.

1. Présentation et utilisation

Vous trouverez les surcharges des templates de modules sous le dossier /themes/xswatch4/modules depuis la racine de votre site.
Cela signifie que si vous utilisez l'un de ces modules, votre site web utilisera ces surcharges et donc affichera les pages de ces modules de façon responsive.
Vous n'avez rien d'autre à faire, tout est déjà prêt !
Evidemment, auparavant, vous aurez suivi les recommandations situées à l'étape :
"Template theme.tpl - Prérequis" / "6. Modifications de templates"

1a. Structure de surcharges d'un module

La structure de surcharges d'un module est toujours la même.
Nous allons prendre pour exemple le module de gestion d'articles xmnews.
Comme vu précédemment, nous allons donc trouver les surcharges de ce module dans le dossier :
/themes/xswatch4/modules/xmnews. Sous le dossier xmnews, on trouve les surcharges des templates des pages du module, coté utilisateur.
Sous le dossier xmnews/blocks, on trouve les surcharges des templates des blocs du module.

1b. Exemples

Le nom des templates est bien souvent assez parlant.
xmnews_block.tpl : Template du bloc qui affiche les news,
xmnews_block_carousel.tpl : Template du bloc qui affiche le carousel,
xmnews_article.tpl : Template qui affiche un article,
xmnews_index.tpl : Template qui affiche l'index du module (liste des résumés des articles).

2. Modifications et Ajouts de surcharges

Vous avez la possibilité de modifier les surcharges existantes.
Si vous utilisez d'autres modules que ceux listés dans le dossier /themes/xswatch4/modules, vous pouvez dans ce cas ajouter des surcharges de templates de modules en créant un dossier portant le nom du module et en respectant la structure attendue.

Le tutoriel Comprendre les surcharges dans XOOPS détaillera ces points.

---