WPML peut lire un fichier de configuration qui lui indique ce qui doit être traduit dans les thèmes et les plugins. Le fichier s’appelle wpml-config.xml et il est placé dans le dossier racine du plugin ou du thème.
Objectif du fichier de configuration linguistique
Dans le cadre de la réalisation de la compatibilité avec WPML, vous devez également créer un fichier de configuration qui vous aidera à maintenir la compatibilité dans vos futures versions. WPML peut traduire n’importe quoi sur votre site WordPress, mais vous devez lui indiquer ce qui doit être traduit. C’est ce que fait ce fichier.
Allez à la page WPML → Paramètres.
Page des paramètres de WPML
Cette page indique à WPML tout ce qu’il doit savoir, y compris quels champs personnalisés traduire ou synchroniser, quels types de publications et taxonomies personnalisés doivent être multilingues et même quels textes d’administration traduire.
Le fichier de configuration de langue inclut ces informations afin que chaque utilisateur n’ait pas besoin de les saisir manuellement dans la page d’administration.
Pour certains thèmes et extensions, nous hébergeons les fichiers de configuration de la langue sur nos serveurs. Vous pouvez en consulter la liste ici. Il est configuré pour remplacer le fichier de configuration de langue local qui est placé dans le dossier racine du thème ou du plugin.
Définition des options de traduction pour les thèmes et extensions tiers
WPML est compatible avec de nombreux thèmes et plugins populaires et pour ceux-ci, vous n’avez pas besoin de créer un fichier de configuration de langue.
Cependant, si vous utilisez un thème ou un plugin dont le contenu n’apparaît pas correctement dans l’éditeur de traduction avancé de WPML, vous devrez peut-être configurer manuellement leurs options de traduction.
Pour configurer les options de traduction pour les thèmes et plugins tiers, allez à WPML → Paramètres et cliquez sur l’onglet Configuration XML personnalisée. Utilisez l’éditeur de texte sur cette page pour entrer le code comme vous le feriez si vous créiez un fichier wpml-config.xml.
Définition des options de traduction pour les thèmes et extensions tiers dans l’onglet Configuration XML personnalisée.
Génération automatique du fichier wpml-config.xml
Si vous n’êtes pas familier avec la création de fichiers XML, notre équipe a créé le plugin Multilingual Tools qui rend cette tâche plus facile. Bien qu’il ait été initialement conçu comme un outil pour aider les auteurs de thèmes et de plugins à rendre leurs produits prêts pour le multilinguisme, il peut facilement être utilisé pour générer votre propre fichier wpml-config.xml.
Pour en savoir plus sur la génération de votre fichier wpml-config.xml, visitez la page du plugin Multilingual Tools. Plus précisément, consultez la section Comment générer des fichiers de configuration linguistique à l’aide des outils multilingues ?
Une fois que vous avez le fichier de configuration, ajoutez-le à la racine du dossier de votre thème. Si vous en avez déjà un, ne l’écrasez pas. Au lieu de cela, modifiez votre fichier XML original et ajoutez le code généré avec le plugin Multilingual Tools.
Veuillez noter que ce plugin n’est pas destiné à être utilisé sur des sites en production.
Pour lire ce tutoriel et construire des fichiers de configuration de langue pour vos thèmes et extensions, vous pouvez commencer par cet exemple – wpml-config.zip.
Vous devrez le modifier, mais vous pouvez utiliser les sections et la structure de ce fichier.
Structure et syntaxe
WPML vous permet de configurer un certain nombre d’éléments en utilisant le fichier wpml-config.xml. Utilisez les guides suivants pour trouver des informations supplémentaires et des instructions sur la façon de rendre certains éléments du site traduisibles :
Utilisation du fichier de configuration de langue WPML avec des thèmes enfants
Si vous utilisez un thème enfant, le fichier de configuration de langue du thème parent remplace celui trouvé dans le thème enfant. WPML fournit une page de configuration qui vous permet de facilement remplacer cela avec n’importe quels paramètres personnalisés.
Prenons un exemple où le fichier de configuration de langue du thème parent définit le type de publication personnalisé « Propriété » comme étant traduisible.
Le fichier de configuration de langue parent définit le type de publication personnalisé propriété à traduire
Si vous utilisez un thème enfant et souhaitez définir le type de publication personnalisé « Propriété » comme non traduisible, allez à la page WPML → Paramètres et cliquez sur l’onglet Configuration XML personnalisée. Utilisez l’éditeur pour définir le type de publication personnalisé « Propriété » comme non traduisible. Il suffit de fixer la valeur de l’attributs translate à 0 au lieu de 1.
Remplacement des paramètres de configuration de langue du thème parent
Les paramètres dans l’onglet Configuration XML personnalisée sont prioritaires sur les paramètres du fichier de configuration de langue dans le thème parent.
