Les thèmes et les plugins WordPress sont développés en anglais et doivent faire l’objet d’une traduction française pour être compréhensible du plus grand nombre. Ce tutoriel abordera 2 cas : quand un fichier .po existe déjà et quand il est absent alors même que le thème ou le plugin dispose de chaînes traduisibles.
Cas n°1 – Un fichier .po est présent
C’est le cas le plus courant et le plus simple. Le thème ou le plugins dispose d’un fichier .po généralement situé à la racine du dossier ou dans un sous-dossier /languages ou /lang.
Poedit est LE logiciel de traduction .po qui générera vos .mo
Pour procéder à la traduction, vous devez éditer ce catalogue de chaînes de traduction à l’aide Poedit. Ce logiciel multiplateforme vous permettra de générer un fichier compilé .mo qui servira à afficher les données traduites sur votre site.
Pour en savoir plus, reportez-vous au tutoriel dédié à Poedit.
Il est important de renommer votre fichier .po / .mo en fonction du préfixe de langue. Par exemple, pour le français on indiquera fr_FR.mo et fr_FR.po sinon impossible de faire fonctionner la traduction.
Cas n°2 – Aucun fichier .po existant
Ce cas est le plus complexe car il requiert des étapes de configurations supplémentaires dans Poedit. Dans cette situation, il n’existe aucun fichier de traduction pré-configuré mais le thème ou le plugin est annoncé comme étant prêt à traduire.
Notez que cette manipulation vaut aussi bien pour les fichiers .pot à la seule différence qu’un fichier .pot n’est autre qu’un modèle qui nous servira à créer un .po.
Étape n°1 – Récupération des sources de traduction
Rapatriez dans un premier temps le dossier de votre thème ou du plugins à traduire sur votre bureau. Ce sera plus simple par la suite.
Étape n°2 – Création d’un nouveau catalogue
Lancez ensuite Poedit puis faites Fichier, Nouveau catalogue.
Remplissez les différents champs qui viennent d’apparaître dont :
- Nom et version du projet : par exemple, Mon Thème 1.0 ;
- Equipe de traduction : indispensable de spécifier l’auteur pour conserver une trace si le projet est mis à disposition de tous (logique open-source) ;
- Adresse électronique de l’équipe : idem que précédemment, utile pour prendre contact et poser des questions au traducteur ;
- Langue : la langue de traduction, ici le français ;
- Jeu de caractères : toujours sur UTF-8 tout comme WordPress ;
- Jeu de caractères du code source : idem ;
- Formes plurielles : indiquez nplurals=2; plural=(n > 1) ;
Création d’un catalogue sous Poedit
Passez donc à présent sur l’onglet Chemins de sources. C’est ici que nous allons indiquer où se trouve le dossier du thème ou du plugin à traduire.
Cliquez donc sur le second bouton pour créer un nouvel emplacement. Dans le champ relatif au chemin, indiquez le répertoire de votre dossier. Par exemple :
/Volumes/DATA/Desktop/twentyeleven
Le chemin des fichiers à traduire sous Poedit
Continuez maintenant sur le dernier onglet Mots-clés source.
Il faut savoir qu’une chaine de traduction est facilement identifiable dans le code PHP d’un thème ou d’un plugin WordPress. En effet, elle est précédée d’un mot-clé comme __ ou _e ce qui nous donne à titre d’exemple :
<h1><?php _e('Hello World' , 'twentyeleven'); ?></h1>
<h1><?php echo __('Hello World' , 'twentyeleven'); ?></h1>
La fonction est formée d’une part de la chaine à traduire et d’autres part du domaine du thème ou du plugin. Ce domaine permet de regrouper les chaines issus d’un même projet – utilisé notamment par des plugins comme WPML qui gère les sites multilingues.
Dans la première ligne, le _e ajoute automatiquement le echo et affiche donc la traduction. Le second avec __ ne le fait pas.
Pour aller plus loin et comprendre comment gérer les variables dans les chaînes de traduction, reportez-vous à I18n – Internationalisation pour WordPress. Vous y apprendrez que la gestion des langues sous WordPress respecte les standards PHP et repose sur la librairie Gettext.
Mais poursuivons en ajoutant les mots-clés suivants : _e et __ (double underscore, le tiret sous le 8).
Ces mots-clés nous serviront à détecter les chaînes à traduire
Validez le tout en cliquant sur OK. Votre catalogue est fin prêt… mais il ne contient toujours pas les chaînes à traduire !
Étape n°3 – Récupération des chaînes de traduction
Nous allons demander à Poedit de scanner l’intégralité du dossier pour rechercher les chaînes à traduire en fonction des mots-clés spécifiés.
Pour ce faire, cliquez sur Mettre à jour.
La mise à jour des sources est utile à chaque nouvelle version d’un thème ou d’un plugin pour ajouter les nouvelles chaines – ce qui n’est pas toujours fait par les auteurs
Bingo ! Toutes les traductions sont apparues… ou du moins les chaînes à traduire car maintenant c’est à vous de travailler.
Et n’oubliez pas de transférer les fichiers .mo à l’aide d’un client FTP dans le dossier du thème ou du plugin concerné.
Cas n°3 – Le thème ou le plugin n’est pas translation-ready
C’est le cas le plus rare… premièrement, contactez le développeur pour qu’il fasse un effort ! Deuxièmement, pour gagner du temps ou si la réponse est négative, créez vous mêmes les chaînes à traduire en rajoutant les mots-clés… cela demande de bonnes compétences en matière d’internationalisation.
Dans tous les cas, rappelez-vous d’une chose concernant la gestion des traductions : ne jamais effectuer une traduction directement dans le code, jamais !
Podcast: Télécharger (Durée: 4:30 — 96.2MB)
Excellent tuto, manque juste la gestion des historiques de traductions mais ça dégrossit déjà pas mal le job
Tu peux m’en dire plus toi qui gère des traductions WordPress au quotidien ?
Oui, bien sur.
En fait PoEdit peut gérer un dictionnaire de traductions. Il suffit de créer un base de référence puis d’indiquer le répertoire ou les traductions sont stockées. Une fois que c’est fait, il faut à chaque nouvelle trad dire à PoEdit d’aller chercher à traduire automatiquement. Ca n’affranchit pas de la vérification de la trad mais ça traduit les termes les plus récurrents
C’est donc à ça que sert cette fonction de traduction auto ?
Et ouais, comme quoi avec WP on en apprend tous les jours et c’est ça qui est bon
Super cette fonction. Merci Je vais tester. Et effectivement pour les termes récurrents, quel gain de temps
Salut.
Pour les formes plurielles, ce ne serait pas plutôt nplurals=2; plural=(n>1) ?
En tout cas c’est ce qui est indiqué dans la trad fr de WP.
Et pour les mots clés, _n et _x sont assez courants aussi.
A+
Greg
Oui les formes plurielles changent en fonction des pays. Pour en savoir plus, direction : http://translate.sourceforge.net/wiki/l10n/pluralforms
OK pour les mots-clés additionnels.
P.S : indiques « Greg » comme nom hein !
Très bon tuto, je ne savais même pas que c’était possible de créer un fichier de traduction chez WordPress, même pour un plugin.
En tout cas ça à l’air plus facile à mettre en place que ce je pensais.
Merci Aurélien. Je recommande également ce bon tuto par Amaury
POEdit, c’est tellement chiant, chez Wysija on a décidé de se mettre sur Transifex. Un genre de GlotPress, en mieux.
https://www.transifex.com/projects/p/wysija/
Merci de l’info même si je note que ce n’est pas gratuit.
C’est gratuit pour les projets open source!
Bref, pour ceux qui font des plugins comme nous, Transifex est comme un outil envoyé du ciel…
Pour des traductions directement dans l’interface d’administration, il existe aussi l’extension « codestyling localisation ».
Pas forcément très ergonomique pour des centaines de termes à traduire mais très très pratique pour ajouter ou enrichir des traductions (on peut également visualiser l’emplacement des chaines dans les fichiers php)
merci pour ce tuto, j’ai créé un dossier language puis mis les fichiers en_EN.po (essayer default.po ) et en_EN.mo puis fr_FR.po et fr_FR.mo ,malgré toout le thème reste en anglais, pourquoi?
site test : http://er.v.free.fr/
Merci
il faut rajouter un code dans functions.php pour que la traduction soit prise en compte, sinon on n’a pas de fichier po. et .mo d’origine.
@noaneo: c’est probalement le cas numéro 3: Le thème ou le plugin n’est pas translation-ready. D’autre part le répertoire language n’est pas nécessairement « language », c’est la fonction load_theme_textdomain (qui doit être présente pour que le thème soit traduisible, il existe le pendant pour les plugins) qui définit à la fois le répertoire des fichiers de traduction et le domaine de traduction.
Mots clés: Mettre __ et _e est très insuffisant, WordPress nous fournit une dizaine de mots clés pour les traductions, il FAUT les mettre tous pour assurer une traduction de qualité: __, _e, _n, _x, _ex, _nx, esc_attr__, esc_attr_e, esc_attr_x, esc_html__, esc_html_e, esc_html_x, _n_noop, _nx_noop
oui le thème n’était pas fait pour la traduction, mais comme j’ai fait cela fonctionne parfaitement.
Merci
Bonjour,
Je ne savais ou envoyer ma suggestion (je n’ai pas vu de contact email sur le site…).
Bref, serait il possible de faire un tutoriel complet (A à Z) sur la mise en ligne (transfert de local au serveur) de wp?
Je m’explique, je suis en train de finir mon thème perso en local et je souhaite le mettre enfin en ligne, mais après une simple recherche Google (wordpress local en ligne) je m’aperçoit que beaucoup de gens galère avec la mise en ligne de leur wordpress.
Dois je réinstaller un nouveau wordpress sur mon serveur ou y glisser tout mon dossier wordpress local en bourin?
Je sais pas du tout comment faire et j’ai peur de perdre la configuration des bdd, plugins, menu, widgets…. je ne suis pas le seul dans ce cas apparemment.
Merci
++
Le formulaire de contact est dans le pied de page.
Sinon, oui c’est une bonne idée de tutoriel mais c’est compréhensible que beaucoup de monde galèrent sur une opération de ce niveau technique…
Bonjour,
Mettre sur FTP, tout votre site local et dans la base de de donnée, la sauvegarde de votre site local puis comme si vous le déplacez d’un dossier, d’un serveur ou d’un nom de domaine, modifier l’url dans la base de donnée, tos les codes sont dans cet article
http://olivierlabbe.com/2009/03/deplacer-wordpress-dun-dossier-serveur-ou-nom-de-domaine/
les codes sont à mettre un par un dans l’onglet SQL.
ha oui effectivement le formulaire est dans le footer mais j’étais sur mon iphone et je ne l’ai pas vu…
Merci de cet article Aurélien !
A noter un site assez pratique pour traduire grossièrement un .po :
http://littlesvr.ca/ostd/translatepot.php
Merci pour ce tutoriel tout à fait éducatif.
Mais pourquoi ne faut-il « jamais effectuer une traduction directement dans le code, jamais ! »
Car tu ne peux pas gérer plusieurs langues, que c’est compliqué si tu as besoin d’aller rechercher pour éditer une chaîne et un tas d’autres raisons que je n’ai pas en tête.
Ces raisons sont logiques en effet. J’ai crains un instant que d’autres conséquences, plus technico-techniques, soient envisageables. Après avoir fait la traduction d’un thème dans le code, je vais pourvoir, grâce à ce tutoriel, mettre enfin mon thème à jour avec sa dernière version et faire la traduction en deux temps trois mouvements !
Merci Aurélien pour cette somme de travail présentée dans ce site et dont tout le monde est bénéficiaire.
y’a un truc que j’arrive pas à faire avec poedit c’est enregistré un fichier .pot
.po et .mo sans probleme mais pas le .pot
comment on fait ?
concernant le chemi, tu peux en dire davantage ?
Si mon fichier.mo est dans le dossier wp-content/plugins/monplugin je dois mettre le path du dossier monplugin, c’est ça ?
Chaque plugin / thème fonctionne différemment. Certains disposeront d’un dossier /lang ou /languages, d’autre pas. Il faut voir avec l’auteur lorsqu’aucune information n’est proposée.
Excuse moi aurélien mais je pense que tu n’as pas compris ma question.
Si le fichier.mo est dans le dossier wp-content/plugins/monplugin, directement dans ce dossier là, pas dans un dossier lang ou language, je dois mettre le path du dossier monplugin (path serveur) ?
Il te faut créer la traduction sur ta machine personnelle et non directement sur le serveur car le .mo ne sera pas généré. Si tu opères en local, alors oui mais restez sur le bureau est plus simple et rapide.
Bonjour,
Très intéressant cet article ; je n’y ai pourtant pas trouvé la réponse à mon problème : j’utilise bien sûr WP en français avec un thème (Ovid, de Themeforest) traduit lui aussi en français, mais pas moyen de remplacer le terme anglais Category qui apparaît sur mes pages (p.ex. ici http://www.ecolesrec.ch/category/es/espees/). Vous n’auriez pas une idée du problème ? D’avance merci !
2 solutions : soit le fichier PO est incomplet auquel il faut le mettre à jour par rapport à la source, soit il faut vérifier que la chaine est internationalisée dans le thème.
Bonjour,
Je suis confrontée au même pb avec le thème REASON, je ne parviens à traduire le terme « Category » en français et n’ai pas très bien compris la réponse d’Aurélien.
Puis-je avoir plus d’explications ?
D’avance merci.
Bonjour,
Je n’ai pas encore approfondi la question, désolé. Mais si je sais ce qu’est un fichier .po, je ne sais pas comment « vérifier que la chaine est internationalisée dans le thème. » C’est vrai que sa réponse n’est guère limpide pour un non-expert de WP… Le premier qui trouve la solution informe l’autre !
Bonne chance …
Très bien.
J’ai cherché un peu, mais je débute sur wordpress.
Je suis évidemment preneuse d’une solution !
Avis aux experts wordpress !!!
Pas de panique, ce n’est pas très compliqué… il faut suivre le cas n°2 à la lettre pour mettre à jour le fichier de traduction à partir du thème original. Recherchez ensuite les termes relatifs à « category ». Il y est forcément dans 99%.
Bonsoir Aurélien,
Pas de panique, c’est sûr. Mais c’est bizarre : mon thème est traduit, j’ai inspecté son fichier de traduction .po (acheté sur wptrads.fr) et tout est traduit. Pourtant, c’est bien le terme anglais « Category » qui s’affiche…
Bonjour,
J’ai trouvé la solution pour mon thème. Dans l’éditeur, « Modèle pour la page d’accueil », il suffit de remplacer :
CODE NON FORMATE DONC INVISIBLE, DESOLE
J’espère que ça marchera pour toi.
Bon we
Effectivement, le code est invisible. Mais j’ai aussi trouvé la parade : modifier le fichier category.php.
Merci !
bonjour , svp j’ai besoin de savoir comment je peux faire un site avec la langue fr/an ,je veux quand j’accède a mon site (front)je trouve un lien (fr/an) et quand je clique « An » tout le site change en anglais (page ,menu ,contenu).
pour le moment je travail sur wordpress version 3.5.1 fr (le fichier langages est vide).
j’ai essayé avec des plugin mais ca fonctionne pas .
Est ce que je dois avoir un autre dossier worpdress (version anglais ) sous ma racine pour que sa marche ??
Le plugin multilingue que je recommande : WPML. Payant mais vraiment pas cher !
Bonjour,
J’ai bien effectué le tuto, par contre sur mon plugin j’ai un problème de traduction partielle. J’ai bien traduit avec Poiedit les lignes de codes correspondent bien aux fichiers sources, mais j’ai quand même des traductions qui ne passe pas. Comment résoudre cela ?
Pour tester Poedit, j’ai décidé de traduire le plugin Milestone bien connu sur WordPress.com. Il est au téléchargement pour un WP auto-hébergé, mais disponible en allemand. Après avoir ouvert le fichier .po, des chaînes semblent « verrouillées » dans un fichier .po. Impossible donc de les traduire. Comble de malheur, certaines chaînes sont des expressions qui apparaissent en front.
Bref. Quelqu’un saurait-il me dire comment déverrouiller ces chaînes ? Après avoir fouillé dans les paramètres de poedit et sur le web, je n’est encore rien trouvé.
Les chaînes ne sont pas verrouillées. Il faut veiller à bien configurer le catalogue pour les formes plurielles (c’est juste une question de configuration). Plus d’infos ici : http://wordpress.stackexchange.com/questions/33312/how-to-translate-plural-forms-for-themes-plugins-with-poedit
Merci Aurélien pour ce coup de pouce et ce lien.
Bonjour, j’ai essayé de traduire un petit plugin « Simple Contact Form Revisited widget » mais il n’y pas de répertoire lang ou language. J’ai créé les fichiers fr_FR.mo et .po avec poedit et les ai mis à la racine du plugin. Mais cela ne traduit rien. Je suppose que ce plugin n’est pas prêt pour être traduit. Comment le savoir?
Si vous êtes parvenu à faire détecter des chaînes à traduire par Poedit, il doit y avoir un moyen de les faire prendre en charge par le plugin. Cela dit, il commence à dater et le mieux serait de prendre contact avec son auteur.
Merci de votre réponse. Les chaines sont détectées, pas toutes, par _e et __
Je cherchais un formulaire de contact simple qu’on puisse mettre dans les widgets de façon à ce qu’il apparaisse sur toutes les pages. Pour le moment j’ai traduit en « dur » dans les routines php bien je sache que cela ne devrait pas se faire (retraité maintenant, j’ai fait du développement de logiciel pendant toute ma carrière…). je vais chercher une autre solution.
Je suis déçu de rencontrer problème sur problème avec les extensions que je tente d’utiliser et de devoir régulièrement contacter les auteurs.
Avez-vous testé Contact Form 7 ? Le shortcode (bout de code entre crochet) fonctionne dans n’importe quel widget texte de WordPress.
Merci, oui je connais Contact Form 7 que j’utilise par ailleurs. Merci de votre suggesstion de recopier le shortcode dans un widget.