API des hooks de WPML
WPML propose des hooks d’action et de filtre qui peuvent être utilisés dans votre thème ou extension WordPress pour fournir une prise en charge multilingue correcte. Consultez l’API de référence des hooks pour obtenir des détails sur chaque hook.
Shortcodes de WPML
WPML fournit des shortcodes que vous pouvez utiliser à la fois dans le contenu et dans votre code PHP. Ils sont répertoriés sur la page Shortcodes de WPML.
Constantes de WPML
WPML fournit des constantes définies par l’extension noyau de WPML et nos modules complémentaires. Vous pouvez les utiliser dans les fichiers PHP et les modèles de votre thème ou de votre extension. Pour une liste complète, consultez notre page sur les constantes de WPML.
Constantes de langue
WPML définit les constantes suivantes qui peuvent être utilisées dans le thème :
| Constante | Description | Exemple |
|---|---|---|
| ICL_LANGUAGE_CODE | Code de la langue actuelle | fr |
| ICL_LANGUAGE_NAME | Nom de la langue actuelle, dans la langue actuelle | Français |
| ICL_LANGUAGE_NAME_EN | Nom de la langue actuelle en anglais | French |
Nous ne recommandons pas d’utiliser ces constantes pour obtenir la langue actuelle de votre site, car elles sont obsolètes. Veuillez plutôt consulter notre article de FAQ expliquant comment obtenir la langue actuelle avec WPML.
Désactiver les fichiers CSS et JS de WPML
WPML est fourni avec ses propres fichiers CSS et JS qui mettent en forme sa navigation et le style du sélecteur de langue.
Le chargement de la feuille de style et des fichiers javascript pour le style du sélecteur de langue dépend du sélecteur choisi. Si vous n’en avez pas besoin dans votre thème, vous pouvez indiquer à WPML de ne pas charger ces fichiers.
Ces fichiers se trouvent dans le dossier suivant :
../wp-content/plugins/sitepress-multilingual-cms/templates/language-switchers/YOUR_CHOSEN_LANGUAGE_SWITCHER_THEME/
Pour ce faire, définissez les constantes suivantes dans votre thème :
| Constante | Le fichier qu’elle désactive |
|---|---|
| ICL_DONT_LOAD_NAVIGATION_CSS | Feuilles de style de navigation – cms-navigation-base.css et cms-navigation.css |
| ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS | style.css?ver=1 |
| ICL_DONT_LOAD_LANGUAGES_JS | script.js?ver=1 |
Pour configurer ces constantes, définissez-les dans le fichier functions.php du thème. Par exemple :
define('ICL_DONT_LOAD_NAVIGATION_CSS', true);
Désactiver les communications critiques avec les services de traduction pour les sites de test
Dans le cadre du flux de travail habituel de développement de sites web, vous pouvez avoir besoin de dupliquer votre site de production et de travailler sur un emplacement différent ou un environnement de préproduction. Il s’agit d’une pratique courante et tout à fait recommandée. Cependant, ce site de test distinct se connecterait par défaut au service de traduction exactement comme le site de production principal. Cela peut créer des incohérences dans les communications du site principal avec le service de traduction.
Voici un exemple typique pour vous aider à illustrer ce problème :
- Votre site de test récupère une traduction terminée auprès du service de traduction.
- Le service de traduction marque ces éléments comme « livrés ».
- Vous ne pouvez plus récupérer ces traductions livrées sur votre site de production.
Pour éviter ce type de problème, nous recommandons d’« indiquer » à WPML qu’un site de préproduction est uniquement destiné à des fins de test. Vous pouvez le faire en ajoutant la ligne suivante au fichier wp-config.php de votre site :
define( 'WPML_ENVIRONMENT', 'test' );Remarque : Cela bloquera uniquement les requêtes critiques, mais la plupart des requêtes seront toujours disponibles. Par exemple, la liste des services de traduction s’affichera comme d’habitude.