Connexion S'inscrire

Connectez-vous

Login *
Mot de passe *
Se souvenir de moi

Créer un compte

Les champs marqués d'un astérisque (*) sont requis.
Nom *
Login *
Mot de passe *
Vérification mot de passe *
Email *
Vérification email *
Captcha *

Création d'un composant Joomla (partie 4) Fichier de langue et support de menu


Cette partie est consacrée au fichier de langue en admin et à l'ajout de la vue liste comme élément de menu. Si vous êtes arrivés directement sur cette page, peut-être que vous aimeriez commencer par le début: Partie 1 | Partie 2 | Partie 3.

1 Les fichiers de langue en Administration

Nous avons déjà ajouté un fichier de langue sur le site dans la partie 3. Ici nous allons faire la même chose en administration. Les fichiers de langue en administration sont dans le dossier "language" qui se trouve dans le dossier "administrator" (administrator/language). La structure est exactement le même qu'en front-end (voir la partie 3). Si nous allons dans un dossier de langue (exemple fr-FR),  nous allons constater que presque tous les composants ont deux fichiers de langue. Exemple: Contact a "fr-FR.com_contact.ini" et "fr-FR.com_contact.sys.ini". Donc nous allons créer ces deux fichiers pour notre composant ("fr-FR.com_djguitariste.ini" et "fr-FR.com_djguitariste.sys.ini"). Jusqu'à présent, si vous allez dans l'administration de Joomla et que vous cliquez sur le menu "Composant", vous verrez que Joomla a donné un nom à notre composant "com-djguitariste". Pour donner un nom plus jolie, on va se servir du fichier de langue. Nous allons utiliser le fichier "fr-FR.com_djguitariste.ini". La ligne ci-dessous permet de changer le nom de notre composant:

COM_DJGUITARISTE="Guitariste"

Nous reviendrons sur l'autre  fichier (fr-FR.com_djguitariste.sys.ini) plus tard. Joomla s'en sert dans les cas suivants:

  • a. lors de l'installation de l'extension, afin de permettre la localisation des messages post-installation,
  • b. pour la construction de menu des composants dans l'administration,
  • c. pour la localisation des paramètres des composants et les paramètres des menus,
  • d. et dans le Gestionnaire d'extension  Gestion.

2 Mise à jour du fichier xml d'installation

Dans le fichier xml d'installation (djguitariste.xml) qui se trouve dans "administrator/components/com_djguitariste", nous allons modifier le fichier pour informer Joomla de l'existence de nos fichiers de langue lors de l'installation. Nous allons le faire pour la partie front-end (le site) et le back-end (administration). Celui de l'admin (back-end) doit être insérer entre les balise "administration". Voici comment spécifier cela dans le xml.

Pour le front-end, à insérer avant la balise administration:


<languages folder="site/language">
  <language tag="fr-FR">fr-FR.com_djguitariste.ini</language>
</languages>    

 Pour la partie back-end, à insérer juste avant la fermeture de la balise "administration":


<languages folder="admin/language">
  <language tag="fr-FR">fr-FR.com_djguitariste.ini</language>
  <language tag="fr-FR">fr-FR.com_djguitariste.sys.ini</language>
</languages>

3 Ajout au Menu

 Pour pouvoir ajouter une vue de notre composant au menu du site (en front-end) depuis l'administration de Joomla, nous avons besoin de créer un fichier xml dans le dossier de la vue. Nous allons créer le fichier "default.xml" pour la vue liste de guitaristes. Le chemin depuis la racine de notre site Joomla sera donc "components/com_djguitariste/views/guitaristes/tmpl/default.xml". Voici le contenu du fichier default.xml:


<?xml version="1.0" encoding="utf-8"?>
<metadata>
  <layout title="COM_DJGUITARISTE_VIEW_DEFAULT_TITLE">
    <message>
      <![CDATA[COM_DJGUITARISTE_VIEW_DEFAULT_DESC]]>
    </message>
  </layout>
</metadata>

 Avant de tester l'ajout de la vue au menu, nous devons ajouter ces nouveaux clés (COM_DJGUITARISTE_VIEW_DEFAULT_TITLE et COM_DJGUITARISTE_VIEW_DEFAULT_DESC ) dans le fichier de langue. C'est là qu'on va utiliser le fichier .sys. Donc dans "administrator/language/fr-FR/fr-FR.com_djguitariste.sys.ini", nous allons rajouter les trois lignes suivantes:


COM_DJGUITARISTE="Guitaristes"
COM_DJGUITARISTE_VIEW_DEFAULT_TITLE="Liste des guitaristes"
COM_DJGUITARISTE_VIEW_DEFAULT_DESC="Cette page affiche la liste des guitaristes"

Pour ajouter la vue à un menu de votre site, connectez-vous à l'administration de votre site Joomla. Cliquez sur le menu "Menus" et sélectionnez le menu désiré puis cliquez sur "Ajoutez un lien de menu". Donnez un titre, et cliquez sur "Sélection" pour choisir le type de lien. Vous devez voir "Guitaristes" dans la liste. Cliquez dessus et choisissez la vue qu'on a rajouté et sauvegardez. Maintenant allez sur votre site en front-end, vous devez voir l'élément que vous avez ajouté. Cliquez dessus pour voir la liste des guitaristes. Cliquez ici pour lire la partie 5.


  • Dernière modification le jeudi, 28 septembre 2017 15:11
  • 1045
Docteur Joomla

Après plus de 10 ans d'expérience en Joomla, je lance ce Blog pour partager mes connaissances avec les autres développeurs Joomla.