JOOMLA JOOM FISH User Manual

Documentation non-officielle

Solution multilingue pour

Documentation Française

Emmanuel Danan

www.vistamedia.fr

www.joomlafacile.com

Informations Légales:

Vous avez le droit d'imprimer ce document pour votre propre usage. Il vous est interdit de le distribuer sous quelque forme que ce soit - imprimée ou électronique - sans autorisation expresse de l'auteur. Vous n'avez pas le droit de faire un lien de téléchargement direct sur ce document sans autorisation expresse de l'auteur. Vous avez toutefois la possibilité de faire un lien vers la page de téléchargement du document sur le site de l'auteur

www.vistamedia.fr) pour permettre à vos visiteurs de le télécharger à partir de là. Ce document vous est fournit

( gratuitement, mais sans aucune garantie. Vistamedia ne pourra en aucun cas être tenu responsable de toute perte ou dommage résultant de l'utilisation de ce document, ou de toute information ou opinion qu'il contient.

Joom!Fish – Documentation Française www.vistamedia.fr Page 1/20

Sommaire

Sommaire.....................................................................................................................................................................2

Crédits..........................................................................................................................................................................2

Equipe de développement de Joom!Fish.................................................................................................................2

Logo..........................................................................................................................................................................2

Licence Joom!Fish....................................................................................................................................................2

Soutenir le projet Joom!Fish.....................................................................................................................................2

Introduction.................................................................................................................................................................3

I - Installation du composant Joom!Fish..................................................................................................................3

1.- Installation ...........................................................................................................................................................3

2.- Récupération du pack de langue Allemand ........................................................................................................4

II - Configuration des Langues de Joom!Fish .........................................................................................................5

III - Traduire les éléments du site..............................................................................................................................6

1.- Traduire les menus. ............................................................................................................................................6

2.- Traduire les articles.............................................................................................................................................9

3.- Les éléments pré intégrés.................................................................................................................................10

4.- Les autres types d’éléments. ............................................................................................................................11

IV - La configuration de Joom!Fish.........................................................................................................................12

1.- Le composant....................................................................................................................................................12

2.- Les mambots/plugins ........................................................................................................................................13

a - bot de recherche multi langue ......................................................................................................................13

b - bot système multi langue ..............................................................................................................................13

3.- Le module..........................................................................................................................................................13

V - Techniques avancées.........................................................................................................................................14

1.- Mettre en place un menu dépendant de la langue............................................................................................14

a - Téléchargez le module mod_mainmenu_ml.................................................................................................15

b - Installez-le :...................................................................................................................................................15

c - Création des deux nouveaux menus. ...........................................................................................................15

d - Paramétrage du module de menu multilingue :............................................................................................16

e - Dépublication des modules d’origine............................................................................................................17

2.- Contrôler la position d’un module en fonction de la langue..............................................................................18

3.- Comment utiliser des templates différents selon la langue...............................................................................19

a - Faire varier le CSS uniquement....................................................................................................................19

b - Faire varier le template complet ...................................................................................................................19

4.- Autoriser un Manager à utiliser Joom!Fish .......................................................................................................20

Crédits

Equipe de développement de Joom!Fish

Alex Kempkens - JoomFish AT ThinkMatrix DOT net Geraint Edwards - joomfish.credits AT copyn.plus DOT com Ivo Apostolov - joomfish AT unwe DOT net Lévis Bisson Robin Muilwijk

Logo

Tommy White (tommy AT tommywhite DOT com)

Licence Joom!Fish

Soutenir le projet Joom!Fish

Vous aimez Joom!Fish? Vous pouvez soutenir le projet en achetant quelques objets sympas dans la boutique en

http://thinklabs.net/external/joom!fish_eu_shop.html

ligne :

Joom!Fish – Documentation Française www.vistamedia.fr Page 2/20

Introduction

L’objectif de ce guide est de vous apprendre à créer un site trilingue avec le composant Joom!Fish. Pourquoi un site trilingue ? Tout simplement parce que c’est souvent l’insertion d’une troisième langue qui pose problème et cela permet de prendre un exemple le plus complet possible. Cette documentation est largement illustrée de copies d’écran afin de vous guider au mieux.

Je me suis basé sur la version 1.0.11 de Joomla! et la version 1.7 de Joom!Fish. Vous pouvez récupérer une version du composant (menus et paramètres traduits - français préconfiguré) sur mon site à l’adresse suivante : La version officielle est disponible sur le site du projet Joom!Fish :

http://forge.joomla.org/sf/frs/do/downloadFile/projects.joomfish/

Le forum de support français pour le multilingue : http://forum.joomlafacile.com/forumdisplay.php?f=71 Le forum de support officiel en anglais : http://forum.joomla.org/index.php/board,123.0.html

Si vous avez des suggestions d’amélioration ou de corrections, elles sont les bienvenues. Vous pouvez me contacter via : En espérant que ce document répondra aux attentes de la plupart des utilisateurs, je vous souhaite une bonne lecture.

http://www.vistamedia.fr/telechargements/composants-joomla/joomfish/

www.vistamedia.fr ou emmanuel CHEZ vistamedia POINT fr

I - Installation du composant Joom!Fish

1.- Installation

Dans l’administration du site, sélectionnez dans le menu « installation » l’option « composants » (figure 1)

Cliquez sur le bouton parcourir

Sur votre disque dur, sélectionnez l’archive ZIP contenant le composant et cliquez sur « Ouvrir »

Joom!Fish – Documentation Française www.vistamedia.fr Page 3/20

Puis cliquez sur le bouton installer.

Voila, le composant est installé. Vous avez devant les yeux l’écran de présentation et tout en bas de la page vous pouvez cliquer sur le bouton « Continuer »

2.- Récupération du pack de langue Allemand

Par défaut votre installation de Joomla comporte deux langues : le Français et l’Anglais. Il vous faut donc récupérer le pack de langue Allemand et l’installer avant de commencer à configurer Joom!Fish. Rendez-vous sur le site officiel des extensions Joomla à la rubrique Languages/Translations for Joomla.

http://extensions.joomla.org/component/option,com_mtree/task,listcats/cat_id,1837/Itemid,35/

Cliquez sur le bouton « Download »

Vous arrivez sur la Forge Joomla où vous allez trouver le pack de langue qui va bien. C’est bien entendu celui qui correspond à la version de Joomla que vous utilisez. (version 1.0.11 dans la série des 1.0.x)

Joom!Fish – Documentation Française www.vistamedia.fr Page 4/20

Télécharger le sur votre disque dur, puis procédez à son installation. Cliquez sur l’option « Langues » du menu « Installation »

Sélectionnez l’emplacement de l’archive puis cliquez sur installer.

Vous arrivez sur l’écran du gestionnaire de langues qui récapitule les langues installées sur votre site ainsi que la langue principale utilisée. Ici c’est le français.

Remarque : Le concept de langue principale est fondamental afin de bien comprendre ce qu’il est possible de réaliser avec Joom!Fish. Il y a une seule langue de référence et un article ne pas exister en Anglais s’il n’existe pas en Français d’abord (du moins pour conserver une organisation cohérente). Joom!Fish permet exclusivement de traduire les contenus existant déjà dans la langue principale de votre site !!!

II - Configuration des Langues de Joom!Fish

Cette étape consiste à activer les langues dans lesquelles le site sera traduit.

Cliquez sur l’option langue du composant Joom!Fish

Joom!Fish – Documentation Française www.vistamedia.fr Page 5/20

Les trois langues installées apparaissent bien dans la liste du gestionnaire de langues Joom!Fish. Il faut renseigner la colonne nom, le code ISO, l’ordre d’affichage dans le site et éventuellement le chemin de l’image (si vous souhaitez un petit drapeau personnalisé). Cochez les trois cases « Activer » et cliquez sur le bouton « Sauver »

Voyons un peu ce que ça donne dans votre site. Faites un aperçu dans une nouvelle fenêtre pour constater les modifications. En haut à droite de l’écran une liste déroulante est apparue. Cette liste contient bien les trois langues dans l’ordre que vous avez choisi et avec le nom que vous leur avez donné.

Nous verrons un peu plus loin comment changer cette liste pour la mettre en ligne ou la remplacer par de jolis petits drapeaux. Si vous ne tenez plus en place pour votre petit drapeau vous pouvez faire un tour au chapitre IV-3.

Essayons maintenant de changer la langue du site pour voir ce qui se passe… On constate qu’une partie des éléments est traduite. Il s’agit des éléments contenus dans le fichier de langue de Joomla! C’est déjà ça de gagné !

Les langues sont maintenant configurées vous êtes prêt a démarrer le gros du travail : la traduction.

III - Traduire les éléments du site

Remarque :

Tout d’abord une petite précision. Joom!Fish est capable de traduire tous les éléments de contenu de votre site (articles, menus, composants, modules) qui figurent dans la base de données. Certains modules comportent parfois des éléments de langues codés sous forme de variables. Ils ne pourront être traduits !!!

1.- Traduire les menus.

Pour accéder aux traductions sélectionnez l’option « traduction » du composant Joom!Fish.

Joom!Fish – Documentation Française www.vistamedia.fr Page 6/20

+ 14 hidden pages