Modifier les liens utiles du menu Aide Joomla

En tant que webmaster, la création du site internet de votre client représente seulement une partie du travail. En effet, une fois le site terminé, votre client peut toujours avoir besoin de votre aide s'il souhaite faire des modifications par exemple. Il est donc intéressant de pouvoir lui apporter cette aide grâce aux liens utiles du menu "Aide" directement dans le back-office de son site Joomla.

Avant-propos

Comment ça marche ?

Par défaut, les liens utiles que l'on trouve dans l'onglet "Aide" de Joomla renvoie vers des ressources quasiment toutes en anglais, ce qui peut être un problème pour tous ceux qui ne parlent pas cette langue. Il est donc intéressant de pouvoir proposer des liens menant vers un forum en français ou encore vers votre propre site afin d'obtenir de l'aide en français.

Pour ce faire, il va falloir récupérer (avec FileZilla) et modifier (avec NotePad++) deux fichiers :

• Le fichier PHP "default_enabled.php" qui se trouve dans /administrator/modules/mod_menu/tmpl
• Le fichier texte "fr-FR.mod_menu.ini" qui se trouve dans /administrator/language/fr-FR

Modification du fichier default_enabled.php

Maintenant que vous avez récupéré le fichier en question, il va falloir le modifier. Ouvrez donc le fichier "default_enabled.php" dans NotePad++ et rendez vous à la ligne 325. Le principe est de renvoyer les requêtes JTtext vers d'autres éléments que nous allons rajouter par la suite au fichier "fr-FR.mod_menu.ini".

Il faut remplacer les éléments surlignés que vous voyez ci-dessous :

new JMenuNode(JText::_('MOD_MENU_HELP_LINKS'), '#', 'class:weblinks'), true
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_EXTENSIONS'), 'http://extensions.joomla.org', 'class:help-jed', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_TRANSLATIONS'), 'http://community.joomla.org/translations.html', 'class:help-trans', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_RESOURCES'), 'http://resources.joomla.org', 'class:help-jrd', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_COMMUNITY'), 'http://community.joomla.org', 'class:help-community', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_SECURITY'), 'http://developer.joomla.org/security.html', 'class:help-security', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_DEVELOPER'), 'http://developer.joomla.org', 'class:help-dev', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_SHOP'), 'http://shop.joomla.org', 'class:help-shop', false, '_blank')
	);

Par :

new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP'), '#', 'class:weblinks'), true
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC1'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC1_URL'), 'class:help-jed', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC2'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC2_URL'), 'class:help-trans', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC3'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC3_URL'), false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC4'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC4_URL'), 'class:help-community', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC5'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC5_URL'), 'class:help-security', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC6'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC6_URL'), 'class:help-dev', false, '_blank')
	);
	$menu->addChild(
	new JMenuNode(JText::_('MOD_MENU_HELP_MYHELP_TOPIC7'), JText::_('MOD_MENU_HELP_MYHELP_TOPIC7_URL'), 'class:help-shop', false, '_blank')
	);

Modification du fichier fr-FR.mod_menu.ini

L'étape suivante consiste à ajouter dans le fichier langue "fr-FR.mod_menu.ini" les termes et les liens qui apparaîtront dans le menu "Aide". Toujours dans NotePad++, rendez vous à la fin du fichier et copier/coller ceci :

MOD_MENU_HELP_MYHELP="My Help"
MOD_MENU_HELP_MYHELP_TOPIC1="My Help Topic 1"
MOD_MENU_HELP_MYHELP_TOPIC2="My Help Topic 2"
MOD_MENU_HELP_MYHELP_TOPIC3="My Help Topic 3"
MOD_MENU_HELP_MYHELP_TOPIC4="My Help Topic 4"
MOD_MENU_HELP_MYHELP_TOPIC5="My Help Topic 5"
MOD_MENU_HELP_MYHELP_TOPIC6="My Help Topic 6"
MOD_MENU_HELP_MYHELP_TOPIC7="My Help Topic 7"
MOD_MENU_HELP_MYHELP_TOPIC1_URL="http://mydomain.com/help_topic_1"
MOD_MENU_HELP_MYHELP_TOPIC2_URL="http://mydomain.com/help_topic_2"
MOD_MENU_HELP_MYHELP_TOPIC3_URL="http://mydomain.com/help_topic_3"
MOD_MENU_HELP_MYHELP_TOPIC4_URL="http://mydomain.com/help_topic_4"
MOD_MENU_HELP_MYHELP_TOPIC5_URL="http://mydomain.com/help_topic_5"
MOD_MENU_HELP_MYHELP_TOPIC6_URL="http://mydomain.com/help_topic_6"
MOD_MENU_HELP_MYHELP_TOPIC7_URL="http://mydomain.com/help_topic_7"

Bien sûr, il ne vous reste plus qu'à remplacer les termes surlignés en jaune par le texte et le lien que vous voulez voir apparaître dans le menu "Aide" du back-office Joomla.

Création d'un fichier fr-FR.override.ini

Enfin, il faut savoir que si vous mettez à jour votre version de Joomla, les modifications effectuées précédemment risquent d'être perdues. Mais il existe un moyen d'éviter ça.

Par défaut, il n'existe pas de fichier "fr-FR.override.ini", seulement "en-GB.override.ini" qui se trouve dans /administrator/language/overrides. Il vous suffit de récupérer ce dernier et de le renommer. Ensuite, il faut copier/coller le texte que vous avez précédemment placer dans le fichier "fr-FR.mod_menu.ini" (voir ci-dessus), puis mettre ce nouveau fichier dans /administrator/language/overrides grâce à FileZilla.

Source : Joomla Community Magazine - Janvier 2012

L'auteur : un expert à votre service

Nom : Geoffrey LEOST