22.1 Choix du domaine de localisation

Puisqu'un site WordPress utilise différents thèmes et extensions qui peuvent tous être internationalisés, WordPress utilise un domaine de localisation pour permettre à chacun de définir les chaînes à localiser.

Le domaine de localisation est en fait une chaîne de caractères qui identifie l'endroit où les localisations doivent être retrouvées. Il s'agit d'un mot ou d'un groupe de mots spécifiques pour le thème ou l'extension.

Le domaine de localisation sera écrit entièrement en lettres minuscules. On utilisera un préfixe qui assurera que le domaine de localisation soit unique parmi le thème enfant, le thème parent et les extensions utilisées.

Bien que la documentation de WordPress ne soit pas claire à ce sujet, il est conseillé de séparer les mots du domaine de localisation par des traits d'union (ex : christiane-mon-extension).

Le domaine de localisation d'un thème enfant pose rarement problème puisqu'il ne sera généralement pas distribué pour d'autres sites. On peut simplement utiliser le nom du thème enfant (ex : christiane).

Celui d'un thème parent ou d'une extension est plus à risque de conflit de nom puisque le thème ou l'extension peut être utilisé sur de nombreux sites. On utilisera généralement un ou plusieurs mots représentant l'entreprise qui a créé le thème ou l'extension suivis d'un ou plusieurs mots représentant le thème ou l'extension en tant que tel (ex : mon-entreprise-mon-extension). Si c'est un particulier qui développe le thème ou l'extension, l'utilisation de son nom est un choix intéressant (ex : christiane-mon-extension).

Il est d'usage de déclarer le domaine de localisation dans l'entête du fichier style.css d'un thème ou encore dans l'entête du fichier principal d'une extension, à la ligne Text Domain.

ou, pour une extension :

Vous pouvez maintenant utiliser le domaine de localisation pour écrire du code internationalisé.