Traduire le header d’un plugin WordPress

Traduire le header d'un plugin WordPress

Bon, après avoir trop longtemps délaissé cette rubrique sur mon site, il est grand temps de reprendre les choses en main.

Aujourd’hui je vous présente une astuce qui va vous permettre de traduire les headers d’un plugin WordPress.

Pour rappel, il faut déclarer à WordPress un minimum d’info pour que celui-ci considère votre code comme un plugin. Je passe donc sur comment créer un plugin, c’est très bien expliqué sur le codex.

Un header de plugin c’est :

<?php
/**
 * Plugin Name: Name Of The Plugin
 * Plugin URI: http://URI_Of_Page_Describing_Plugin_and_Updates
 * Description: A brief description of the Plugin.
 * Version: The Plugin's Version Number, e.g.: 1.0
 * Author: Name Of The Plugin Author
 * Author URI: http://URI_Of_The_Plugin_Author
 * License: GPL2
 */

Nous allons donc créer un plugin de test : tp-test. Le minimum à mettre est le Plugin Name et la Description. Voici donc le header de mon plugin :

<?php
/**
 * Plugin Name: Thierry Pigot - A awesome plugin !
 * Plugin URI: https://www.thierry-pigot.fr/tutoriel/722/traduire-header-plugin-wordpress/
 * Description: A brief description of the Plugin.
 * Version:1.0
 * Author: Thierry Pigot
 * Author URI: https://www.thierry-pigot.fr/
 * License: GPL2
 */

Et voici le résultat dans mon gestionnaire d’extensions :

Traduire le header d’un plugin WordPress

Titre et description en anglais

Nous ajoutons maintenant à notre header, la déclaration du text domain et le Domain Path, qui permet de spécifier à WordPress le contexte et le fichier de langue à utiliser ainsi que la localisation de ces fichiers. Et j’ajoute le dossier languages dans le répertoire de mon thème.

Voici donc le nouveau header :

<?php
/**
 * Plugin Name: Thierry Pigot - A awesome plugin !
 * Plugin URI: https://www.thierry-pigot.fr/tutoriel/722/traduire-header-plugin-wordpress/
 * Description: A brief description of the Plugin.
 * Version:1.0
 * Author: Thierry Pigot
 * Author URI: https://www.thierry-pigot.fr/
 * License: GPL2
 * Text Domain: tp-test
 * Domain Path: /languages
 */

Il reste maintenant à rendre traduisible le nom de mon plugin et sa description :

<?php
/**
 * Plugin Name: Thierry Pigot - A awesome plugin!
 * Plugin URI: https://www.thierry-pigot.fr/tutoriel/722/traduire-header-plugin-wordpress/
 * Description: A brief description of the Plugin.
 * Version:1.0
 * Author: Thierry Pigot
 * Author URI: https://www.thierry-pigot.fr/
 * License: A "Slug" license name e.g. GPL2
 * Text Domain: tp-test
 * Domain Path: /languages
 */

__( 'Thierry Pigot - A awesome pluginle ', 'tp-test' );
__( 'A brief description of the Plugin', 'tp-test' );

Via Poedit  je crée mes fichiers de langue, dans mon cas tp-test-fr_FR.po & tp-test-fr_FR.mo.

Il me détecte bien mes chaines :

Traduire le header d’un plugin WordPress - Poedit

Poedit

Reste à traduire les textes, enregistrer et ça marche !

Titre et description en Français !

Titre et description en Français !

Voilà, j’espère que cela vous sera utile et voici le lien pour télécharger les fichiers sources : https://gist.github.com/thierrypigot/00f07fe72d27c934dd91