Petit guide pour débuter avec les surcharges Joomla!

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”.

Module de connexion

  • 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.

mod login

  • 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.

template mod login

  • 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.

Module de connexion modifié


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.

Composant de connexion avant surcharge

  • 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.

com user

  • 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.

template com users

  • 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.

composant-de-connexion-apres-surcharge 


 

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 ?".

langue-avant-surcharge

  • 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).

surcharge-de-langue-recherche

  • Entrez le nouveau texte dans la boite "Texte".

surcharge-de-langue-nouveau-texte

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

liste-de-subtitutions

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

langue-apres-surcharge

 

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

 

Notez cet article:
12
20 Trucs & Astuces pour Joomla 3
Sélection Templates Décembre 2012

Articles en relation

Commentaires

 
Pas encore de commentaire
Déjà inscrit ? Connectez-vous ici
Guest
dimanche 22 janvier 2017
Si vous souhaitez vous inscrire, veuillez saisir un nom d'utilisateur, mot de passe et nom.

Image Captcha

Sur ce site, nous utilisons des cookies.