WPML peut lire un fichier de configuration qui lui indique ce qui doit être traduit dans les thèmes et les extensions. Le fichier se nomme wpml-config.xml et il est placé dans le dossier racine de l’extension ou du thème.
L’objectif du fichier de configuration de langue
Pour assurer la compatibilité avec WPML, vous devez également créer un fichier de configuration qui vous aidera à la maintenir dans vos futures versions publiées. WPML peut tout traduire sur votre site WordPress, mais vous devez lui indiquer ce qui doit être traduit. C’est le rôle de ce fichier.
Accédez à la page WPML → Paramètres.
Cette page indique à WPML tout ce qu’il a besoin de savoir, y compris quels champs personnalisés traduire ou synchroniser, quels types de publication personnalisés et taxonomies 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 à les saisir manuellement dans la page d’administration.
Pour certains thèmes et extensions, nous hébergeons les fichiers de configuration de langue sur nos serveurs. Vous pouvez en voir une 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 de l’extension.
WPML vous permet également de remplacer manuellement tous les paramètres chargés par les fichiers de configuration de langue des thèmes et des extensions. Cela s’applique à la fois aux fichiers de configuration de langue situés dans le dossier racine du thème ou de l’extension et aux fichiers de configuration de langue hébergés sur nos serveurs.
Définir les options de traduction pour les thèmes et extensions tiers
WPML est compatible avec de nombreux thèmes et extensions 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 une extension dont le contenu ne s’affiche pas correctement dans l’Éditeur de traduction avancé de WPML, vous devrez peut-être configurer manuellement ses options de traduction.
Pour configurer les options de traduction des thèmes et extensions tiers, accédez à WPML → Paramètres et cliquez sur l’onglet Configuration XML personnalisée. Utilisez l’éditeur de texte de cette page pour saisir le code, exactement comme si vous créiez un fichier wpml-config.xml.
Générer automatiquement le fichier wpml-config.xml
Si vous n’êtes pas habitué à créer des fichiers XML, notre équipe a créé l’extension Multilingual Tools qui facilite cette tâche. Bien qu’elle ait été initialement conçue comme un outil pour aider les auteurs de thèmes et d’extensions à rendre leurs produits Multilingual Ready (compatibles avec le multilinguisme), elle peut facilement être utilisée 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 de l’extension Multilingual Tools. Plus précisément, consultez la section Comment générer des fichiers de configuration de langue à l’aide de Multilingual Tools ?
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. Modifiez plutôt votre fichier XML d’origine et ajoutez le code généré avec l’extension Multilingual Tools.
Veuillez noter que cette extension n’est pas destinée à être utilisée sur des sites de production en ligne.
Pour lire ce tutoriel et créer 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 à l’aide du fichier wpml-config.xml. Utilisez les guides suivants pour trouver des informations supplémentaires et des instructions sur la façon de rendre traduisibles des éléments spécifiques du site :
- Traduire des shortcodes personnalisés avec WPML
- Enregistrer le contenu du constructeur de pages pour la traduction
- Enregistrer les widgets personnalisés du constructeur de pages pour la traduction
- Définir les options de traduction pour les champs personnalisés à l’aide du fichier de configuration de WPML
- Enregistrer des termes, types et taxonomies personnalisés comme traduisibles
- Rendre les blocs personnalisés de l’éditeur Gutenberg traduisibles
- Traduire les textes que le thème et les extensions enregistrent dans wp_options
- Personnaliser le sélecteur de langue de WPML à l’aide du fichier de configuration de WPML
- Activer les valeurs numériques pour la traduction
Utiliser le fichier de configuration de langue de 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 qui se trouve dans le thème enfant. WPML fournit une page de configuration qui vous permet de remplacer facilement cela par des 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é « Property » comme traduisible.
Si vous utilisez un thème enfant et que vous souhaitez définir le type de publication personnalisé « Property » comme non traduisible, accédez à 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é « Property » comme non traduisible. Définissez simplement la valeur de l’attribut translate sur 0 au lieu de 1.
Les paramètres de l’onglet Configuration XML personnalisée sont prioritaires par rapport aux paramètres du fichier de configuration de langue du thème parent.
