Comment réparer l’erreur « Function _load_textdomain_just_in_time called incorrectly » sur WordPress ?

Pour les non-developpeurs, il existe plusieurs façons simples de masquer ou désactiver ces notices d’erreurs sans corriger le code à la main (ou très peu).

Il peut arriver qu’un site WordPress affiche un message d’erreur du type :

Notice: Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the [votre domaine] domain was triggered too early.

Cette erreur provient du système de traduction de WordPress. Techniquement, cela signifie qu’une tentative de chargement des fichiers de traduction (les fichiers .mo) a eu lieu trop tôt, avant que WordPress ne soit prêt (par exemple, avant le hook plugins_loaded).

Pourquoi cette erreur apparaît-elle ?

WordPress repose sur un système de hooks (actions et filtres) qui permet aux plugins et thèmes d’ajouter des fonctionnalités. Le chargement des traductions doit impérativement se faire au bon moment, généralement à partir du hook plugins_loaded. Si ce n’est pas respecté, WordPress génère cette notice pour avertir que la bonne pratique n’est pas suivie.

Pour les développeurs : la solution technique

Si vous développez votre propre plugin, voici comment charger votre domaine de traduction correctement :

// Hook pour charger le textdomain au bon moment
add_action('plugins_loaded', 'td_load_textdomain');

function td_load_textdomain() {
    // __DIR__ fournit le chemin absolu vers le dossier du plugin
    load_plugin_textdomain('votre-textdomain', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
    

À noter :

• Remplacez 'votre-textdomain' par le slug de votre plugin (le même que celui utilisé dans vos fonctions __(), _e(), etc.).
• Le troisième paramètre doit pointer vers le dossier où se trouvent vos fichiers .mo (habituellement /languages/).

Cette méthode garantit que les traductions sont chargées au bon moment, évitant ainsi cette erreur.

Pour les non-développeurs : que faire ?

Cette notice est une alerte technique qui n’empêche pas votre site de fonctionner. Elle est surtout utile pour les développeurs pendant la phase de débogage, mais ne devrait jamais apparaître en production (site en ligne).

1) Désactiver l’affichage des erreurs PHP

Le plus simple est de désactiver l’affichage des erreurs dans WordPress. Pour cela :

• Connectez-vous à votre site via un logiciel FTP (ou via le gestionnaire de fichiers de votre hébergeur).
• Ouvrez le fichier wp-config.php situé à la racine de votre site.
• Vérifiez que cette ligne est bien présente et définie :

define('WP_DEBUG', false);

Si votre site est en mode debug (utile parfois), vous pouvez également ajouter ceci pour masquer les notices sans désactiver le débogage :

define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

👉 Cela n’efface pas l’erreur mais la rend invisible pour les visiteurs.

2) Vérifier les plugins actifs

Certains plugins comme Query Monitor ou Debug Bar sont conçus pour afficher les erreurs et notices à l’écran. Si vous voyez cette erreur et que l’un de ces plugins est actif, vous pouvez :

• Le désactiver temporairement si vous n’en avez pas besoin.
• Ou ignorer la notice, car ces plugins sont destinés à l’analyse technique.

3) Contacter votre hébergeur ou webmaster

Si vous n’êtes pas à l’aise avec la manipulation de fichiers ou que vous n’avez pas d’accès technique, la meilleure solution est de demander à votre hébergeur ou à votre webmaster de :

• Modifier le fichier wp-config.php pour masquer les erreurs.
• Éventuellement corriger le problème à la source si besoin.

En résumé

Cette erreur est bénigne mais doit idéalement être corrigée ou masquée pour un site propre et professionnel. La solution dépend de votre profil :

• Vous êtes développeur ? Chargez vos traductions via le hook plugins_loaded.
• Vous n’êtes pas développeur ? Masquez l’erreur en ajustant la configuration ou demandez l’aide de votre webmaster.

En cas de doute, mieux vaut toujours faire appel à un professionnel pour éviter tout risque de mauvaise manipulation.