Comment Traduire un Plugin WordPress en Français ?

Pour traduire un plugin WordPress en français, la méthode la plus fiable et durable consiste à utiliser l’extension Loco Translate, qui permet de créer et gérer vos fichiers de traduction directement depuis votre tableau de bord. Cette approche est essentielle pour non seulement franciser votre extension, mais aussi pour garantir la persistance de vos traductions lors des mises à jour du plugin, un point crucial souvent négligé par d’autres tutoriels.

Votre site WordPress est la vitrine digitale de votre entreprise. Si vous ciblez un public francophone, chaque détail compte pour offrir une expérience utilisateur impeccable. Cela inclut la langue des messages affichés par vos plugins. Trop souvent, on installe une extension fantastique, mais elle communique en anglais, créant une dissonance pour vos visiteurs et un manque de professionnalisme perçu.

En tant que développeur WordPress depuis plus de 15 ans, j’ai vu d’innombrables sites souffrir de ce petit détail. Heureusement, traduire un plugin WordPress n’est pas une tâche complexe si l’on connaît les bonnes méthodes. Ce guide complet vous montrera comment franciser une extension WP efficacement, en insistant sur l’aspect le plus critique : la pérennité de vos traductions face aux mises à jour.

Pourquoi traduire un plugin WordPress est-il si important pour votre entreprise ?

La traduction de vos plugins WordPress va bien au-delà de la simple convenance linguistique. C’est un levier stratégique pour l’image de votre marque, l’expérience utilisateur et même votre référencement naturel.

Un site qui parle la langue de ses utilisateurs n’est pas seulement plus agréable, il est plus efficace. Chaque point de friction linguistique est une opportunité manquée de conversion.

Nicolas Buathier, Expert WordPress

Comment fonctionne la traduction des plugins WordPress ? Le système .po et .mo

Avant de plonger dans les tutoriels, il est essentiel de comprendre le mécanisme sous-jacent à la traduction de WordPress. Le cœur du système repose sur des fichiers spécifiques : les fichiers .pot, .po et .mo.

• Fichier .pot (Portable Object Template) : C’est le modèle de traduction. Il contient toutes les chaînes de caractères (mots, phrases) que le développeur du plugin a identifiées comme traduisibles. Il ne contient aucune traduction, seulement les originaux.
• Fichier .po (Portable Object) : C’est le fichier de traduction éditable. Il est créé à partir du .pot et contient les chaînes originales et les traductions correspondantes pour une langue spécifique (par exemple, fr_FR.po pour le français de France). C’est ce fichier que vous allez modifier.
• Fichier .mo (Machine Object) : C’est la version compilée et binaire du fichier .po. WordPress ne peut pas lire directement le .po ; il a besoin du .mo, qui est optimisé pour être lu rapidement par le serveur. Chaque fois que vous enregistrez un fichier .po, un fichier .mo correspondant est généré automatiquement.

Ce système, basé sur la bibliothèque Gettext, est la norme de WordPress pour la gestion des traductions, que ce soit pour le cœur de WordPress, les thèmes ou les plugins. Comprendre ce processus est la clé pour franciser une extension WP de manière autonome.

Quelle est la meilleure méthode pour traduire un plugin WordPress ? Loco Translate ou Poedit ?

Pour traduire un plugin WordPress, deux outils principaux sont à votre disposition : Loco Translate, un plugin WordPress, et Poedit, un logiciel de bureau. Chacun a ses avantages et ses inconvénients.

Pour la majorité des utilisateurs de site-wordpress.fr, l’approche la plus simple et la plus sécurisée est d’utiliser Loco Translate. C’est la méthode que nous allons détailler en premier.

Tutoriel complet : Traduire un plugin avec Loco Translate (méthode recommandée)

Loco Translate est un plugin incontournable pour quiconque souhaite franciser une extension WP sans toucher au code ni manipuler des fichiers via FTP. Suivez ce loco translate tuto pas à pas.

Étape 1 : Installation et activation de Loco Translate

1. Connectez-vous à votre tableau de bord WordPress.
2. Allez dans Extensions > Ajouter.
3. Dans la barre de recherche, tapez « Loco Translate« .
4. Cliquez sur « Installer maintenant » puis « Activer« .

Étape 2 : Créer un nouveau fichier de traduction pour votre plugin

1. Une fois activé, un nouveau menu « Loco Translate » apparaît dans votre barre latérale d’administration. Cliquez dessus, puis sélectionnez « Plugins« .
2. Vous verrez la liste de tous vos plugins. Cliquez sur le plugin que vous souhaitez traduire.
3. Si le plugin a déjà des traductions, vous les verrez listées. Si le français n’est pas présent ou si vous voulez créer une nouvelle traduction, cliquez sur « Nouvelle langue« .
4. Sélectionnez « Français » (ou toute autre langue cible).
5. C’est l’étape la plus CRUCIALE : Pour le « Emplacement« , choisissez « Personnalisé : wp-content/languages/loco/plugins/« . C’est cette option qui garantira que vos traductions ne seront pas écrasées lors des mises à jour du plugin. Ne choisissez JAMAIS l’emplacement « Dans le plugin ».
6. Cliquez sur « Démarrer la traduction« .

Étape 3 : Traduire les chaînes de caractères

1. Vous êtes maintenant dans l’éditeur de traduction de Loco Translate. Sur la gauche, vous verrez la liste des « Chaînes source » (le texte original en anglais).
2. Cliquez sur une chaîne source que vous souhaitez traduire.
3. Dans le champ « Traduction française » en dessous, tapez votre traduction.
4. Répétez l’opération pour toutes les chaînes pertinentes.
5. Si une chaîne contient des variables (par exemple, %s ou {name}), assurez-vous de les inclure dans votre traduction exactement comme elles apparaissent dans l’original.

Étape 4 : Enregistrer et tester

1. Une fois que vous avez terminé vos traductions, cliquez sur le bouton « Enregistrer » en haut. Loco Translate générera automatiquement les fichier po mo wordpress dans le répertoire que vous avez choisi.
2. Videz le cache de votre site si vous utilisez un plugin de cache (ex: WP Rocket, LiteSpeed Cache).
3. Naviguez sur votre site pour vérifier que les traductions apparaissent correctement.

Tutoriel avancé : Traduire un plugin avec Poedit (pour les développeurs ou cas complexes)

Poedit est un outil puissant pour traduire un plugin WordPress en local. Il est particulièrement utile si vous préférez travailler hors ligne, si vous rencontrez des problèmes avec Loco Translate, ou si vous êtes plus à l’aise avec la manipulation de fichier po mo wordpress via FTP.

Étape 1 : Télécharger et installer Poedit

1. Téléchargez Poedit depuis le site officiel (poedit.net).
2. Installez le logiciel sur votre ordinateur (disponible pour Windows, macOS et Linux).

Étape 2 : Récupérer le fichier .pot du plugin

1. Connectez-vous à votre site via FTP ou SFTP (avec un client comme FileZilla).
2. Naviguez vers le dossier du plugin à traduire : /wp-content/plugins/nom-du-plugin/languages/.
3. Recherchez le fichier .pot (par exemple, nom-du-plugin.pot). S’il n’existe pas, certains plugins utilisent un fichier .po avec toutes les chaînes, ou vous devrez générer un .pot avec un outil comme WP-CLI ou des plugins de développement.
4. Téléchargez ce fichier .pot sur votre ordinateur.

Étape 3 : Créer un nouveau fichier de traduction avec Poedit

1. Ouvrez Poedit.
2. Allez dans Fichier > Nouveau à partir d’un fichier POT/PO….
3. Sélectionnez le fichier .pot que vous avez téléchargé.
4. Poedit vous demandera la langue de la traduction. Choisissez « Français« .
5. Poedit vous demandera d’enregistrer le nouveau fichier. Enregistrez-le sous la forme nom-du-plugin-fr_FR.po (en remplaçant nom-du-plugin par le texte domain de votre plugin, souvent son slug). Poedit générera automatiquement le .mo correspondant.

Étape 4 : Traduire les chaînes de caractères

1. L’interface de Poedit est similaire à celle de Loco Translate. Sur la partie supérieure, vous verrez les chaînes originales.
2. Cliquez sur une chaîne à traduire.
3. Dans la partie inférieure, entrez votre traduction.
4. Utilisez les raccourcis clavier (Ctrl+Entrée ou Cmd+Entrée) pour passer à la chaîne suivante.
5. N’oubliez pas les variables si elles sont présentes.

Étape 5 : Enregistrer et téléverser les fichiers

1. Une fois toutes les traductions effectuées, cliquez sur « Fichier > Enregistrer« . Poedit sauvegardera les fichiers .po et .mo.
2. Retournez à votre client FTP/SFTP.
3. Pour préserver vos traductions : Téléchargez les deux fichiers (.po et .mo) dans le répertoire /wp-content/languages/plugins/. Il est recommandé de créer un sous-dossier spécifique au plugin si vous en avez plusieurs pour une meilleure organisation, ou d’utiliser le répertoire /wp-content/languages/loco/plugins/ si vous avez déjà utilisé Loco Translate.
4. Videz le cache de votre site.
5. Vérifiez les traductions sur votre site.

Comment maintenir vos traductions à jour après une mise à jour de plugin ?

C’est le point noir de nombreux tutoriels existants et la raison principale pour laquelle les utilisateurs perdent leurs traductions. La clé est de ne jamais stocker vos fichiers de traduction directement dans le dossier du plugin.

Avec Loco Translate : Synchroniser vos traductions

Si vous avez suivi nos recommandations et enregistré vos traductions dans le répertoire wp-content/languages/loco/plugins/, la mise à jour est simple :

1. Après la mise à jour du plugin, retournez dans Loco Translate > Plugins et sélectionnez votre plugin.
2. Cliquez sur le fichier de traduction français que vous avez créé.
3. En haut de l’éditeur, vous verrez un bouton « Synchroniser« . Cliquez dessus. Loco Translate va comparer votre fichier de traduction avec le nouveau fichier .pot du plugin et ajouter les nouvelles chaînes, tout en signalant celles qui ont disparu.
4. Traduisez les nouvelles chaînes et enregistrez.

Avec Poedit : Mettre à jour les fichiers .po et .mo

Si vous utilisez Poedit, le processus est légèrement plus manuel :

1. Téléchargez le nouveau fichier .pot du plugin (ou le fichier .po de base s’il n’y a pas de .pot) via FTP.
2. Ouvrez votre fichier de traduction nom-du-plugin-fr_FR.po avec Poedit.
3. Allez dans Catalogue > Mettre à jour à partir du fichier POT/PO….
4. Sélectionnez le nouveau fichier .pot (ou .po) que vous venez de télécharger. Poedit mettra à jour votre fichier avec les nouvelles chaînes.
5. Traduisez les nouvelles chaînes et enregistrez votre fichier po mo wordpress.
6. Téléchargez les fichiers .po et .mo mis à jour dans le répertoire /wp-content/languages/plugins/ (ou votre emplacement personnalisé) via FTP.

Quelles sont les erreurs à éviter lors de la traduction de plugins ?

Même avec les meilleurs outils, des erreurs peuvent se glisser. Voici les pièges les plus courants à éviter pour franciser une extension WP sans accroc :

• Traduire dans le dossier du plugin : C’est l’erreur numéro un. Toutes vos heures de travail seront réduites à néant à la prochaine mise à jour. Utilisez toujours les emplacements sécurisés mentionnés précédemment.
• Oublier de vider le cache : Si vous utilisez un plugin de cache (WP Rocket, LiteSpeed Cache, etc.), n’oubliez pas de le vider après chaque modification de traduction. Sinon, vous ne verrez pas vos changements.
• Ignorer les variables : Les chaînes comme Bonjour %s ou {count} éléments trouvés contiennent des variables. Vous devez inclure ces variables dans votre traduction, sinon le plugin affichera des erreurs ou des textes incomplets.
• Utiliser des traductions automatiques sans relecture : Les outils de traduction automatique peuvent être un point de départ, mais ils manquent souvent de contexte et de nuances. Relisez toujours attentivement pour garantir la pertinence et la qualité de votre franciser extension wp.
• Ne pas vérifier la langue du site : Assurez-vous que la langue de votre site WordPress est bien réglée sur « Français » dans Réglages > Général. Si ce n’est pas le cas, vos traductions ne seront pas chargées.