Traduire le thème et les extensions

Introduction

La traduction est importante, si vous voulez rendre votre site, vos thèmes ou vos extensions multilingues, afin de toucher un plus large public.

Si vous avez trouvé un thème ou une extension répondant exactement à votre recherche, mais entièrement en anglais, traduire peut s’avérer très utile et vous permet un gain de temps non négligeable. Cela est souvent le cas pour certains thèmes gratuits ou payants, notamment ceux du fameux site : thème forest, permettant d’acheter des thèmes très performants, mais la plupart du temps en anglais... Ils sont pour la plupart compatibles avec les extensions de traduction comme WPML et surtout prêts à être traduit.

Pour pouvoir traduire un thème ou une extension, il faut que celui-ci le permette. Pour cela, il doit absolument utiliser les fonctions WordPress pour les textes. Si elles ne sont pas présentes, il faudra les ajouter.

Si vous modifiez les fichiers sources, il faudra répercuter cette modification lors de la mise à jour (parfois, lors de mises à jour, le développeur peut ajouter la traduction). Mais il est préférable de partir directement sur un thème qui peut se traduire.

Vous pouvez aussi, dans certains cas, utiliser des hooks pour modifier une fonction, ou le faire via un thème enfant.

Des extensions peuvent...

WordPress et les langues

La traduction sur WordPress s’effectue grâce à deux fichiers : un fichier .po ou .pot contenant le catalogue des termes à traduire, lu par le logiciel Poedit, et un fichier .mo qui est un fichier compilé, généré à partir du fichier .po ou .pot, lu par WordPress.

Utiliser le logiciel Poedit

Poedit est un logiciel permettant de traduire des thèmes et des extensions manuellement. Il peut rechercher les différentes fonctions de traduction __(), _e()... d’un thème ou d’une extension, ce qui est très pratique.

Si vous effectuez des mises à jour avec de nouvelles traductions, il suffit d’un clic pour que Poedit recherche les nouveaux textes. Vous pouvez également traduire les fichiers .po ou .mo directement dans l’administration de WordPress, grâce aux extensions WPML et WPML String Translation (voir le chapitre Les extensions et les widgets).

Utiliser les fichiers dans un thème ou une extension

Plusieurs solutions se présentent à vous.

Première méthode

Avec le commentaire Text Domain: dans le commentaire de configuration d’un thème (style.css) ou d’une extension (monextension.php).

Le commentaire Domain Path: devra être spécifié si le fichier est placé ailleurs que dans le dossier languages.

Exemple pour le fichier CSS du thème The mobility

/* 
Theme Name: The mobility 
Author: Laurent Dumoulin 
Description: Thème mobility 
Version: 1.0 
Text Domain: themobility 
Domain Path: /languages 
*/ 

Cela signifie que la chaîne des fonctions textes est themobility.

<?php _e( 'Nothing Found', 'themobility' ); ?> 

et que le fichier de traduction se situe dans le dossier languages du thème.

Pour l’extension My breadcrump du chapitre Créer une extension simple en PHP, il faut ajouter au fichier mybreadcrumb.php dans l’en-tête :

/* 
Plugin Name: My breadcrumb 
Description: Fil d'Ariane pour les articles et les pages 
Version: 1.0 
Text Domain: mybreadcrumb 
Domain Path: /languages 
[...] 
*/ 

La chaîne à rechercher sera donc de la forme :

<?php _e( 'Nothing Found', 'mybreadcrumb' ); ?> 

Deuxième méthode

Vous devez télécharger...