Petit guide pour débuter avec les surcharges Joomla!

Effectuer des changements dans les fichiers core de Joomla! est souvent nécessaire, mais il existe une bonne et une mauvaise méthode pour effectuer ces changements.

Petit guide pour débuter avec les surcharges Joomla! Effectuer des changements dans les fichiers core de Joomla! est souvent nécessaire, mais il existe une bonne et une mauvaise méthode pour effectuer ces changements. La mauvaise méthode est de directement éditer les fichiers Joomla!. Si vous faites cela, vous perdrez toutes vos modifications lorsque vous ferez une mise à jour de votre site.
La bonne méthode est d’utiliser les surcharges. Dans ce billet, nous allons voir ce que sont les surcharges ainsi que comment les utiliser pour modifier proprement les composants, modules et langues.
Une introduction aux Surcharges

Quoi ? Une surcharge est un fichier ou une entrée de base de données qui est chargé à la place du fichier core normal.
Où ? Dans Joomla!, les surcharges sont presque toujours placées dans les fichiers du template.
Qui ? Presque tous les designers de templates les utilisent. Si vous achetez un template ou que vous en téléchargez un gratuit, il y a 99% de chance qu’il utilise des surcharges pour mettre en place le design de votre site web.
Comment ? Lisez ce qui suit pour comprendre comment surcharger les modules, les composants et les langues.

 1 – Surcharges de Module
 Pour cet exemple, nous allons modifier le module de connexion. Nous allons supprimer la fonctionnalité “Se souvenir de moi”.

Connectez-vous aux fichiers de votre site et rendez-vous dans le répertoire /modules/.
Recherchez le répertoire /mod_login/.
Dans le répertoire /mod_login/, vous trouverez un dossier /tmpl/. Si vous n’avez pas ce dossier, cela signifie que votre module ne supporte pas les surcharges.
Dans ce répertoire /tmpl/ vous avez un fichier de layout pour ce module. Dans les modules simples, ce fichier est souvent nommé defaut.php. Copiez ce fichier.

Rendez-vous ensuite dans le répertoire /templates/.
Ouvrez le dossier du template que vous utilisez, dans notre exemple /beez_20/.
Ouvrez le dossier /html/.
Dans ce dossier /html/, créez un nouveau dossier portant le même nom que le dossier d’origine du module. Dans notre cas /mod_login/.
Chargez le fichier de layout (defaut.php) dans ce nouveau dossier.

Vous pouvez maintenant éditer et modifier le fichier de layout. Dans notre exemple, commentez ou supprimez les lignes 49 à 52 du fichier defaut.php. 
Enregistrez le fichier et actualisez votre page. Le changement devrait être effectif.

2 – Surcharges de Composant
 Regardons comment reproduire cela, mais cette fois sur un composant. Nous allons supprimer le texte “Se souvenir de moi” affiché sur le composant.

Connectez-vous aux fichiers de votre site et rendez-vous dans le répertoire /component/.
Cherchez le répertoire /com_users/.
Dans le répertoire /com_users/, vous trouverez un dossier  /tmpl/. Si vous n’avez pas ce dossier, cela signifie que votre composant ne supporte pas les surcharges.
Dans le dossier /views/ vous trouverez de nombreux sous-dossiers. Normalement, chacun est logiquement nommé en accordance avec la partie du composant qu’il modifie.
Regardez dans ces dossiers, et dans les dossiers /tmpl/ qu’ils contiennent. Recherchez le fichier layout que nous souhaitons modifier. Dans notre exemple, c’est le fichier /login/tmpl/default_login.php.
Copiez le fichier default_login.php.

Rendez-vous dans le répertoire /templates/.
Ouvrez le dossier du template que vous utilisez, dans notre exemple /beez_20/.
Ouvrez le dossier /html/.
Dans ce dossier /html/, créez un nouveau dossier portant le même nom que le dossier d’origine du composant. Dans notre cas /com_users/.
Créez un sous dossier dans /com_users/, corespondant au sous dossier d’origine du composant. Dans notre cas /login/.
Chargez le fichier layout (default_login.php) dans ce nouveau dossier.

Vous pouvez maintenant éditer et modifier le fichier de layout. Dans notre exemple, commentez ou supprimez les lignes 47 et 48 du fichier default_login.php. 
Enregistrez le fichier et actualisez votre page. Le changement devrait être effectif.

 
 
3 – Surcharges de langue
Alors que les modules et composants doivent être surchargés via les fichiers, les langues elles peuvent être directement surchargées à partir de l’administration Joomla!.
Dans cet exemple, nous allons surcharger « Pas encore de compte ? ».

Connectez-vous à l’administration de votre site en rendez-vous dans Gestion des langues > Surcharges.
Cliquez sur nouveau.
Dans la boite de recherche (en bas à droite), entrez « Pas encore de compte ? » puis cliquez sur le bouton Rechercher.
Cliquez sur le résultat qui s’affiche (dans certains cas, vous pouvez obtenir plusieurs résultats, il faut donc choisir le bon).

Entrez le nouveau texte dans la boite « Texte ».

Cliquez sur le bouton “Enregistrer & Fermer ».
Vous retrouvez votre nouvelle substitution listée comme cela :

En vous rendant sur le frontend, vous verrez le texte modifié :

 
Cet article est une traduction de l’article : A Beginners Guide to Joomla Overrides