Tutoriel Joomla! - Créer une surcharge pour Joomla 3

Un module, un composant ne se comporte pas selon vos besoins ? Vous avez envie de procéder à quelques modifications ...

Vous éditez vos fichiers Joomla et vous vous lancez dans la modification de ces fichiers directement .. STOP ! A la prochaine mise à jour du composant ou de Joomla, vous aurez perdu toutes vos modifications. Il faut donc procèder autrement à l'aide des surcharges ou overrides. Vous pourrez ainsi faire vos modifs et surtout les conserver.

En résumé : une surcharge, c'est un fichier que vous allez créer puis modifier. Il se chargera à la place du fichier d'origine. Dans Joomla, les surcharges sont placées dans le dossier templates.

Comment réaliser une surcharge ?

Pour notre exemple nous prendrons le template beez3. Les Templates Joomla sont situés dans le dossier templates, à la racine du site (Filezilla et FTP). Les fichiers et dossiers du template beez3, sont installés dans le dossier templates/beez3

Le dossier qui va recevoir les surcharges est le suivant : templates/beez3/html

Pour l'exemple, nous souhaitons modifier l'affichage du module de connexion, mod_login.

Vous copiez le fichier original du module default.php qui se trouve : à partir de la racine de Joomla : modules/mod_login/tmpl/default.php
Puis dans le répertoire /html/ du template beez3, vous allez créer un nouveau dossier portant le même nom que le répertoire d'origine. Et installer le fichier default.php dedans.
Ce qui donne : templates/beez3/html/mod_login/
Puis installé le fichier copié default.php dedans,
templates/beez3/html/mod_login/default.php 

A présent vous pouvez modifier le fichier default.php. Une fois le fichier sauvegardé, la modification que vous aurez effectuée sera visible sur le site. 

Créer une surcharge de langue ?

Les surcharges de langues peuvent être réalisées dans l'administration de Joomla 3.
Extensions>Gestion des langues>Substitutions
Cliquer sur le bouton NOUVEAU

Vous souhaitez changer dans le module de recherche "Recherche..." et mettre à la place "Votre recherche"
Dans la boite de recherche à droite, saisir "Recherche..." et cliquer sur le bouton RECHERCHER
Des résultats s'affichent, cliquer sur la chaine de traduction : MOD_SEARCH_SEARCHBOX_TEXT, la chaine s'affiche dans la boite "Créer une nouvelle substitution",

Chaine de traduction : MOD_SEARCH_SEARCHBOX_TEXT
Texte : Votre recherche

Cliquer sur le bouton : ENREGISTRER

Sur votre site, dans le module de recherche le nouveau texte s'affiche : "Votre recherche"

La source de cet article : Comment créer une surcharge pour Joomla ?