Comprendre le problème
Quand la bibliothèque de médias WordPress ne se charge pas, l'écran reste vide ou figé sur l'icône de chargement. La cause est généralement un conflit JavaScript dû à un plugin ou un thème, une erreur de l'API REST, ou un cache obsolète qui bloque l'affichage des fichiers.
La piste à vérifier
Videz le cache du navigateur, désactivez les plugins un par un, basculez sur un thème par défaut, et vérifiez la console du navigateur pour repérer l'erreur JavaScript.
Comment reconnaître ce bug
- La bibliothèque de médias affiche un écran vide ou une animation de chargement infinie
- Les miniatures n'apparaissent pas dans la fenêtre d'insertion de média
- La console du navigateur affiche une erreur JavaScript
- Le mode liste fonctionne alors que le mode grille reste bloqué
Qu’est-ce que ce bug ?
La bibliothèque de médias en mode grille s'appuie sur du JavaScript et l'API REST de WordPress pour charger les fichiers. Si un script échoue ou si l'API REST est inaccessible, la grille reste vide. Le problème ne touche pas les fichiers eux-mêmes, mais leur affichage dans l'interface d'administration.
Pourquoi ce problème apparaît
Conflit JavaScript
Un plugin ou un thème charge un script en erreur qui interrompt l'exécution de la bibliothèque.
API REST inaccessible
L'API REST de WordPress est bloquée par un plugin de sécurité ou une règle serveur.
Cache obsolète
Un cache navigateur ou serveur sert des fichiers JavaScript périmés.
Fichiers du cœur corrompus
Une mise à jour incomplète a laissé des fichiers d'administration endommagés.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Vider les caches
Effacez le cache du navigateur et celui des plugins de cache, puis rechargez la bibliothèque.
Consulter la console du navigateur
Ouvrez les outils de développement : l'onglet Console révèle le script ou la ressource en erreur.
Tester plugins et thème
Désactivez les extensions une par une et basculez sur un thème par défaut pour isoler le conflit.
Vérifier l'API REST
Assurez-vous que l'API REST répond et qu'aucun plugin de sécurité ne la bloque.
Comment éviter qu’il revienne
- Testez les mises à jour de plugins et de thèmes sur un site de préproduction
- Évitez les plugins qui désactivent ou restreignent l'API REST sans raison
- Maintenez WordPress, thèmes et extensions à jour
- Limitez le nombre de plugins actifs
Questions fréquentes
Mes fichiers sont-ils perdus si la bibliothèque ne charge pas ?
Non. Le problème est un blocage d'affichage côté interface : vos images et documents restent stockés sur le serveur et en base de données. Ils réapparaissent une fois le conflit résolu.
Comment savoir quel plugin est responsable ?
Désactivez toutes les extensions, vérifiez que la bibliothèque se charge, puis réactivez-les une par une jusqu'à ce que le problème revienne : le dernier plugin réactivé est le coupable.
Pourquoi le mode liste marche mais pas le mode grille ?
Le mode grille dépend du JavaScript et de l'API REST, contrairement au mode liste qui se charge classiquement. Un conflit de script ou une API REST bloquée affecte donc uniquement la grille.
L'API REST peut-elle vraiment bloquer la bibliothèque ?
Oui. La bibliothèque en mode grille interroge l'API REST pour récupérer les fichiers. Si un plugin de sécurité ou une règle serveur la bloque, la grille ne peut rien afficher.