Un guide pour traduire un plugin wordpress

wordpress-translation

WordPress utilise gettext que son système de traduction. Vous trouverez souvent un .po et un fichier .mo dans les plugins WordPress. Quelles sont ces fichiers? Fondamentalement, les chaînes traduites sont toutes contenues dans un fichier .mo qui est une machine (binaire) version optimisée du fichier .po correspondant. Ce fichier est un fichier texte contenant des paires (ID de la chaîne à traduire et la traduction). Nous allons expliquer comment produire ces fichiers.

Traduire un plugin existant

1 – Déterminez le « domaine de texte » du plugin

Chaque plugin à traduire doit utiliser un domaine de texte unique. Il s’agit d’un identifiant. Il ne devrait pas être trop générique pour éviter les conflits. Il est fortement probable que l’auteur du plugin a déjà défini un domaine de texte pour son plugin. Il suffit de regarder les sources et chercher les chaines « __( » ou « _e ( »
Par exemple :

Cela montre que le domaine de texte est  » domainetexte « . Bien sûr, ça sera différent pour chaque plugin.

2 – Le fichier .pot

Vous aurez besoin d’un fichier .pot pour commencer votre traduction. Le fichier .pot est un modèle qui sera utilisé plus tard pour créer votre propre traduction. Si le plugin fournit un fichier .pot dans sa source, alors vous pouvez l’utiliser et aller directement à la prochaine partie de ce chapitre. Sinon, nous expliquons comment obtenir un tel fichier ci-dessous :

Utilisation Poedit (recommandé et facile)

Poedit ( http://www.poedit.net/ ) est un outil de traduction graphique et multi-plate-forme qui a été conçu pour fonctionner avec les traductions gettext. Vous pouvez obtenir Poedit au lien précédent et l’installer. Une fois installé, suivez ces instructions:

1. Ouvrez PoEdit
2. Cliquez sur « Fichier> Nouveau catalogue » élément de menu
3. Une nouvelle fenêtre apparaît avec trois onglets:

Remplissons dans le premier onglet.

configuration du projet Poedit, onglet 1

configuration du projet Poedit, onglet 1

Dans le champ  » Nom et version du prjet « tapez le domaine de texte du plugin suivie par sa version actuelle (exemple: » domainetexte 1.0 « ). Dans le champ équipe de traduction, tapez le nom de votre équipe.  Ensuite, l’ email de l’équipe . Il est conseillé d’écrire une adresse email valide afin que les utilisateurs et les développeurs de plugins peuvent vous contacter s’ils trouvent un problème avec votre traduction. Ne pas choisir la langue et le pays de votre traduction maintenant . Puis sélectionnez le jeu de caractères (Jeu de caractères) de votre traduction (utf-8 recommandé ) et le jeu de caractères utilisé dans le code source(généralement utf-8, mais pourrait être iso-8859-1 par exemple …). Maintenant, allez à la deuxième onglet qui définit les chemins où chercher les sources:

configuration du projet Poedit, onglet 2

configuration du projet Poedit, onglet 2

configuration du projet Poedit, onglet 2

Tapez le nom du répertoire où vous avez extrait la source pour le champ «chemin de base ». Ensuite, double clique sur le sommet de la grande zone vierge. Tapez un point (« . ») Sans les guillemets, comme dans la capture d’écran ci-dessous. Maintenant, cliquez sur le dernier onglet.

configuration du projet Poedit, onglet 3

configuration du projet Poedit, onglet 3

configuration du projet Poedit, onglet 3

Nous devons définir comment trouver les chaînes à traduire. Nous devons dire à Poedit quels mots-clés pour trouver de détecter les phrases à traduire. WordPress offre deux fonctions raccourcis : « __ () » et « _e () ». Donc tapez « __ » et « _e » en deux lignes distinctes, comme on le voit dans la capture d’écran.
4. Cliquez sur le bouton « Valider ». Enregistrez le fichier sous {le domaine de texte du plugin} .po (par exemple: domainetexte.po).
5. Vous obtiendrez la fenêtre suivante:

6. Cliquez sur  » Valider « .

configuration du projet Poedit
7. Cliquez sur « Fichier> Enregistrer » du menu ou sur le bouton « Enregistrer » dans la barre d’outils.
8. Fermez Poedit et allez là où vous avez enregistré votre fichier .po.
9. Renommez le fichier .po à .pot (par exemple: de  » domainetexte.po » à  » domainetexte.pot ») et supprimez le fichier .mo correspondant s’il existe.
C’est tout! Vous avez maintenant votre fichier .pot, prêt à être traduit .

4 – Le fichier .po

Si un fichier .pot est un modèle, le fichier .po est le fichier que vous allez utiliser pour mettre vos chaînes traduites . Nous allons utiliser Poedit pour modifier le fichier .po.
Ne pas le modifier manuellement! Parceque le fichier .po ne peut pas être utilisé directement par gettext, il doit être compilé dans un fichier .mo avant. Poedit fait cela automatiquement.

Préparons notre traduction:

1. Copiez votre fichier .pot en un nouveau fichier .po. Vous devez ajouter les paramètres régionaux avant l’extension .po . Par exemple, si nous avons « domainetexte.pot », nous allons le copier sous le nom  » domainetexte -fr_FR.po ».
2. Ouvrez ce fichier (« domainetexte -fr_FR.po » par exemple) dans Poedit
3. Cliquez sur le « Catalogue> Préférences » du menu.
4. Dans le premier onglet, il suffit de saisir la langue cible de votre traduction.
5. Cliquez sur le bouton « Valider »

PoEdit projet CONFIGURATION
6. Vous êtes maintenant prêt à traduire! Cliquez sur une phrase dans la liste pour le sélectionner pour la traduction. Dans Poedit en bas, il y a deux champs: Texte original et traduction. Vous devez écrire votre traduction dans le champ traduction (celui qui est vide).
7. Sélectionnez une autre phrase et de le traduire. Répétez le processus jusqu’à ce que vous ayez traduit toutes les phrases.

5 – Le fichier .mo

Le fichier .mo est la version optimisée du fichier .po. Il n’est pas lisible par l’homme, il ne faut pas essayer de le modifier manuellement. Il faut toujours générer vos fichiers .mo en utilisant Poedit ou tout autre outil destiné pour la traduction.
1. Lorsque vous avez traduit toutes les phrases, dans la barre d’outils Poedit cliquez sur le bouton « Enregistrer » (ou « Fichier> Enregistrer » dans le menu). Vous devriez maintenant avoir un fichier .mo. Par exemple « domainetexte-FR_fr.mo« . Ce fichier est celui qui sera utilisé pour traduire le plugin.
2. Testez la traduction! Copiez et collez à la fois les fichiers .po et .mo dans le répertoire du plugin (où les autres fichiers .mo sont situés) dans votre installation de WordPress. Si votre blog utilise déjà la locale souhaitée (par exemple fr_FR), le plugin doit maintenant utiliser les chaînes traduites!

source

Articles relatifs

  1. Création d’une extension Wordpress étape par étape - SOS Wordpress

Laisser un commentaire

* Please arrange the below number in decreasing order

*