Si vous êtes un développeur de plugins WordPress souhaitant élargir la portée de votre plugin à un public international, le rendre compatible avec la traduction est une étape essentielle. Les plugins compatibles avec la traduction permettent aux utilisateurs de les traduire facilement dans leur langue maternelle, les rendant ainsi accessibles à un public plus large. Dans cet article, nous allons expliquer comment rendre votre plugin WordPress compatible avec la traduction afin de toucher un public mondial.
4 étapes simples pour créer un plugin compatible avec la traduction
- Utiliser les fonctions d’internationalisation
- Utiliser un domaine de texte
- Créer les fichiers de traduction
- Inclure les fichiers de traduction dans votre plugin
Utiliser les fonctions d’internationalisation :
Ces fonctions vous permettent d’encapsuler les chaînes de texte de votre plugin avec des fonctions de traduction, afin qu’elles soient prêtes à être traduites. Les fonctions d’internationalisation les plus couramment utilisées dans WordPress sont :
- __() et _e(): Ces fonctions sont utilisées pour traduire les chaînes dans le code PHP. La fonction __() renvoie la chaîne traduite, tandis que la fonction _e() affiche directement la chaîne traduite.
- _x(): Cette fonction est utilisée pour traduire des chaînes avec un contexte. Elle accepte un argument supplémentaire pour le contexte, ce qui est utile lorsqu’une même chaîne peut avoir des traductions différentes selon le contexte.
- esc_html__(), esc_html_e(), esc_attr__() et esc_attr_e(): Ces fonctions sont utilisées respectivement pour traduire et échapper les attributs HTML ainsi que les chaînes de texte HTML. Elles garantissent que les chaînes traduites sont correctement échappées afin d’éviter les failles de sécurité.
Utiliser un domaine de texte :
Un domaine de texte est un identifiant unique pour les traductions de votre plugin. Il permet à WordPress d’identifier les traductions à charger pour votre plugin. Pour définir un domaine de texte pour votre plugin, vous devez utiliser la fonction load_plugin_textdomain() dans le fichier principal de votre plugin. Voici un exemple :
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘my_plugin_load_textdomain’ );Créer les fichiers de traduction :
Les fichiers de traduction contiennent les chaînes traduites de votre plugin. Ils sont généralement stockés dans un dossier distinct du répertoire de votre plugin, généralement nommé « languages ». WordPress suit une convention de nommage spécifique pour les fichiers de traduction, basée sur le domaine de texte et la langue cible. Par exemple, si le domaine de texte de votre plugin est « my-plugin » et que vous souhaitez le traduire en espagnol, le fichier de traduction doit être nommé « my-plugin-es_ES.mo » (pour l’Espagne) ou « my-plugin-es_MX.mo » (pour le Mexique).
Les fichiers de traduction sont compilés à partir de fichiers sources portant l’extension « .po » (Portable Object). Vous pouvez créer des fichiers « .po » à l’aide d’un éditeur de traduction, tel que Poedit, qui vous permet de définir les chaînes d’origine et leurs traductions. Une fois les fichiers « .po » créés, vous devez les compiler en fichiers « .mo » (Machine Object) à l’aide d’un plugin comme Automatic Translate Addon For Loco Translate.
Inclure les fichiers de traduction dans votre plugin :
Après avoir créé les fichiers de traduction, vous devez les inclure dans votre plugin afin que WordPress puisse les charger lorsque cela est nécessaire. Vous pouvez le faire en plaçant les fichiers « .mo » dans le dossier « languages » de votre plugin et en utilisant la fonction load_plugin_textdomain() pour spécifier le chemin vers ce dossier. Voici un exemple :
function my_plugin_load_textdomain()
{
load_plugin_textdomain( ‘my-plugin’, false, dirname( plugin_basename( __FILEConclusion
En conclusion, rendre votre plugin WordPress compatible avec la traduction est une étape essentielle pour garantir qu’il puisse être facilement traduit dans différentes langues et répondre aux besoins d’un public international. En suivant les étapes décrites dans cet article, notamment l’utilisation des fonctions d’internationalisation, la définition d’un domaine de texte, la création de fichiers de traduction et leur intégration dans votre plugin, vous rendrez votre plugin prêt pour la traduction et améliorerez son utilisation par des utilisateurs du monde entier.
Proposer des traductions pour votre plugin vous permet de toucher un public plus large et de rendre votre plugin plus convivial pour les utilisateurs non anglophones. Cela montre que vous accordez de l’importance à l’inclusion et à l’accessibilité, ce qui peut contribuer au succès et à la popularité de votre plugin. Ainsi, si vous développez un plugin WordPress, veillez à investir les efforts nécessaires pour le rendre compatible avec la traduction et l’ouvrir à une base d’utilisateurs mondiale.
