# Fichier de traduction

> Fichier qui associe chaque chaîne d'origine d'une extension ou d'un thème à sa version traduite dans une langue donnée, sous un format lisible ou compilé.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/fichier-de-traduction/

Le texte d'une extension écrite en anglais ou en français ne devient pas magiquement compréhensible pour un utilisateur italien : il faut un fichier séparé, propre à chaque langue, qui fait correspondre chaque chaîne source à sa traduction.

## Deux formats complémentaires

Le format `.po` (Portable Object) est un fichier texte modifiable par un traducteur, par exemple avec l'outil Poedit ou l'éditeur de traduction intégré à WordPress. Il est ensuite compilé en un fichier `.mo` (Machine Object) binaire, plus rapide à lire pour PHP à chaque affichage de page :

```
msgid "Réglages enregistrés."
msgstr "Impostazioni salvate."
```

Depuis WordPress 6.5, un format supplémentaire au format JSON est aussi généré pour les traductions utilisées côté JavaScript, afin d'éviter de charger inutilement des chaînes destinées uniquement au PHP.

## Nommage et emplacement

Le nom du fichier associe le domaine de traduction au code de langue, par exemple `mon-extension-it_IT.mo`, placé dans le dossier `languages` de l'extension ou dans `wp-content/languages/plugins/` pour les traductions officielles distribuées séparément.

## Bon à savoir

- WP-CLI propose la commande `wp i18n make-mo` pour compiler automatiquement des fichiers `.po` en `.mo` sans outil graphique.
- Une traduction incomplète n'empêche jamais l'affichage : les chaînes manquantes retombent simplement sur le texte d'origine du code.
- Depuis la mise en place des traductions communautaires sur translate.wordpress.org, une extension du répertoire officiel peut recevoir des fichiers de langue à jour sans que son auteur n'ait lui-même traduit une seule chaîne.