WPML peut lire un fichier de configuration qui lui indique ce qui doit être traduit dans les thèmes et les extensions. Le fichier s’appelle wpml-config.xml et il est placé dans le dossier racine de l’extension ou du thème.
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 tout ce qui se trouve sur votre site WordPress, mais vous devez lui indiquer ce qui doit être traduit. C’est ce que fait ce dossier.
Rendez-vous sur la page WPML → Paramètres.
Page des paramètres du WPML
Cette page indique à WPML tout ce qu’il doit savoir, y compris les champs personnalisés à traduire ou à synchroniser, les posts personnalisés et les taxonomies qui doivent être multilingues et même les textes d’administration à traduire.
Le fichier de configuration de la langue inclut cette information afin que chaque utilisateur n’ait pas à la 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 voir une liste ici. Il est défini pour écraser le fichier de configuration de la langue locale qui est placé dans le dossier racine du thème ou de l’extension.
Définition des options de traduction pour les thèmes et extensions tiers
WPML est compatible avec de nombreux thèmes et extensions populaires et pour eux, vous n’avez pas besoin de créer un fichier de configuration de la langue.
Cependant, si vous utilisez un thème ou une extension dont le contenu n’apparaît pas correctement dans l’éditeur de traduction avancé de WPML, vous devrez peut-être configurer leurs options de traduction manuellement.
Pour configurer les options de traduction pour les thèmes et les 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 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éé l’extension Multilingual Tools qui facilite cette tâche. Bien qu’il ait été initialement conçu comme un outil destiné à aider les auteurs de thèmes et d’extensions à rendre leurs produits multilingues, 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 de l’extension Multilingual Tools. Plus précisément, consultez la section Comment générer des fichiers de configuration de langue à 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 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 les sites de 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 à l’aide du fichier wpml-config.xml. Utilisez les guides suivants pour trouver des informations et des instructions supplémentaires sur la manière de rendre traduisibles des éléments spécifiques du site :
Utilisation du fichier de configuration de la langue de WPML avec les thèmes enfants
Si vous utilisez un thème enfant, le fichier de configuration de la langue du thème parent écrase celui du thème enfant. WPML propose une page de configuration qui vous permet d’écraser facilement ces paramètres personnalisés.
Prenons un exemple où le fichier de configuration de la langue du thème parent définit le type de publication personnalisé « Propriété » comme étant traductible.
Le fichier de configuration de la langue parentale définit la propriété du type de publication personnalisé à traduire.
Si vous utilisez un thème enfant et que vous souhaitez définir le type de publication personnalisé « Propriété » comme non traductible, naviguez vers la page WPML → Paramètres et cliquez sur l’onglet Configuration XML. 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.
Écraser les paramètres de configuration de la langue du thème parent
Les paramètres de l’onglet Configuration XML Personnalisée sont prioritaires sur les paramètres du fichier de configuration de la langue dans le thème parent.
