Créez votre site WordPress avec Elementor.Découvrir Elementor Lien partenaire

LANGUES DE BLOGPASCHER

Langues de ce guide

Ouvrez une autre édition du guide ou consultez une archive.

Éditions de ce guide

Archives disponibles

Traductions prévues (32)
  • Englishanglais
  • Españolespagnol
  • Deutschallemand
  • Portuguêsportugais
  • Italianoitalien
  • Nederlandsnéerlandais
  • Polskipolonais
  • Українськаukrainien
  • Češtinatchèque
  • Slovenčinaslovaque
  • Hrvatskicroate
  • Românăroumain
  • Magyarhongrois
  • Ελληνικάgrec
  • Türkçeturc
  • العربيةarabe
  • עבריתhébreu
  • हिन्दीhindi
  • বাংলাbengali
  • ไทยthaï
  • Tiếng Việtvietnamien
  • Bahasa Indonesiaindonésien
  • 简体中文chinois simplifié
  • 日本語japonais
  • 한국어coréen
  • Danskdanois
  • Svenskasuédois
  • Norsknorvégien
  • Suomifinnois
  • Eestiestonien
  • Latviešuletton
  • Lietuviųlituanien

Apparence du site

Images et médias · Débutant à intermédiaire

Bibliothèque de médias WordPress vide ou vignettes absentes : retrouver le bon diagnostic

Retrouvez vos médias WordPress : vérifiez les filtres, comparez grille et liste, puis distinguez un chargement bloqué de fichiers ou de données manquants.

Publié le · Mis à jour le · Méthode éditoriale

Distinguer une bibliothèque vide d’images qui ne s’affichent pas

Vous ouvrez Médias et la bibliothèque semble vide, le chargement tourne sans fin ou des cases grises remplacent les photos. Pourtant, certaines images apparaissent encore sur le site. Le premier objectif est de déterminer ce qui manque : les résultats affichés, les fiches des médias ou les fichiers nécessaires à leurs aperçus.

Une fiche de média est un enregistrement dans WordPress, avec un titre, un identifiant et des informations sur le fichier. Une vignette est une petite version utilisée pour l’affichage. La fiche peut exister alors que cette variante ne se charge plus. À l’inverse, un fichier peut rester présent sur l’hébergement sans fiche correspondante dans la bibliothèque.

Ce guide traite la consultation de médias déjà attendus. Si un nouvel envoi annonce un format interdit, une taille excessive, une erreur de traitement ou d’écriture sur le disque, relevez ce message : il demande un diagnostic d’importation distinct. Répéter les envois ne réparera pas nécessairement l’affichage des anciens médias.

Préparer une comparaison sans modifier les originaux

Enregistrez ou copiez hors de WordPress tout texte encore en cours de rédaction. Notez le nom d’une image attendue, une page qui l’utilise et la dernière date où la bibliothèque fonctionnait. Gardez également le détail d’une migration, d’une mise à jour ou d’un changement de stockage récent.

Relevez la version de WordPress et le type d’environnement. Sur WordPress.com, certains accès techniques dépendent de l’offre ; utilisez l’assistance lorsque les fichiers ou les journaux ne sont pas accessibles. Dans un réseau multisite, vérifiez le site choisi dans l’administration : chaque site ne présente pas nécessairement les médias de ses voisins.

N’effacez aucune case vide. Elle peut correspondre à une image utilisée. Les premières comparaisons se font sans supprimer de fichier, changer les permissions ni restaurer une sauvegarde. Avant une correction des données ou des fichiers, conservez une sauvegarde adaptée et faites préciser le retour arrière.

Choisir entre les trois approches

Commencez par la première approche pour tout écran vide : elle retire les restrictions d’affichage et compare les vues disponibles. Un filtre oublié se corrige immédiatement, sans intervention sur l’hébergement.

La deuxième approche convient si la liste fonctionne mais pas la grille, si le sélecteur d’un article reste vide ou si le chargement tourne indéfiniment. Il faut observer la demande de médias envoyée par l’écran, puis la réponse reçue.

La troisième devient prioritaire lorsque les fiches sont présentes mais leurs images cassées, ou lorsque les deux vues restent vides après une migration. Elle distingue l’adresse demandée, le fichier réellement disponible et les données qui inscrivent ce média dans WordPress. Ne lancez pas les trois parcours comme une série de réparations obligatoires.

Approche 1 : remettre les filtres à zéro

Cette manipulation s’effectue avec le compte autorisé à consulter les médias. Conservez les valeurs initiales des filtres ou réglages ; le résultat se vérifie sur le même média témoin. Annulez l’essai en rétablissant la sélection ou la session habituelle si la comparaison ne confirme pas la piste.

  1. Depuis l’administration, ouvrez Médias puis Bibliothèque. Effacez entièrement la recherche. Choisissez Tous les médias et Toutes les dates, ou leurs équivalents dans votre interface. En vue liste, appliquez les filtres avec le bouton prévu et revenez à la première page des résultats.
  2. Si une extension ajoute des dossiers, des catégories ou un filtre d’auteur, retirez aussi cette sélection depuis son interface. Notez sa valeur avant de la changer pour pouvoir la remettre ensuite. Un dossier virtuel sélectionné ne prouve pas que le fichier a été déplacé sur le serveur.
  3. Vérifiez notamment que vous n’affichez pas uniquement les médias associés au document ouvert ou les éléments non attachés. La notion de média attaché décrit une association dans WordPress ; elle ne constitue pas un inventaire de tous les endroits où une image est utilisée.
  4. Lorsque les médias réapparaissent, recherchez votre fichier témoin par un élément simple de son nom. Vous avez corrigé un affichage limité. Si les résultats restent vides sans filtre, poursuivez avec les vues grille et liste.

Comparer la grille, la liste et les pages suivantes

Utilisez les icônes de vue placées au-dessus de la bibliothèque. Dans la liste, cherchez les titres et les lignes, même si leurs petites images sont cassées. Des lignes présentes montrent que cet écran retrouve des fiches ; elles ne garantissent pas que les fichiers correspondants sont lisibles.

Si la liste fonctionne alors que la grille reste en chargement, conservez provisoirement la liste pour consulter les détails. Passez à l’approche suivante pour comprendre le chargement de la grille. Ce contraste ne suffit pas à désigner une extension précise comme responsable.

Ne confondez pas la première série d’images et la bibliothèque entière. En liste, parcourez les pages. Depuis WordPress 7.1, la grille et le sélecteur chargent par défaut les médias au défilement. Dans Utilisateurs > Profil, la préférence Infinite Scrolling permet de revenir au bouton de chargement ; son libellé anglais est Disable infinite scrolling in the Media Library grid view. Enregistrez le profil et réessayez, puis rétablissez votre préférence si l’essai n’aide pas. L’option dépend du droit d’envoi de fichiers, et un filtre imposé par un composant peut la remplacer. Les versions plus anciennes peuvent avoir un autre comportement.

Si seules les images suivantes ne viennent pas, notez cette limite. Une recherche directe du fichier et la pagination de la liste permettent de vérifier s’il existe sans charger toute la photothèque.

Comparer l’administration et le sélecteur de l’éditeur

Ouvrez ensuite un brouillon de contrôle, sans publier. Dans un bloc Image, choisissez la médiathèque et cherchez le même fichier. N’effectuez pas un nouvel envoi pour cette comparaison. Si vous utilisez un constructeur de pages ou une fiche produit, notez précisément le sélecteur concerné.

Une bibliothèque normale dans Médias et vide dans un seul sélecteur oriente vers ce parcours d’édition, ses filtres ou ses requêtes. Vous pouvez continuer à relever les informations depuis la bibliothèque principale, mais ne concluez pas que l’enregistrement d’une page utilisant cette image fonctionnera.

Si seul votre compte rencontre le problème, demandez à une personne déjà autorisée de comparer le même écran. Des règles d’accès peuvent limiter la consultation. Ne partagez pas de mot de passe et ne donnez pas le rôle Administrateur uniquement pour essayer. Un administrateur doit examiner la restriction réelle avant de la modifier.

Approche 2 : repartir d’une session utilisable

Ce parcours ne change pas les médias. Il demande seulement votre compte et un navigateur de comparaison. Le résultat attendu est le retour du même média témoin après une reconnexion ou dans un profil propre. Si rien ne change, conservez ce constat et observez la demande ; ne répétez pas le nettoyage de session.

  1. Après avoir préservé le travail ouvert, reconnectez-vous par l’adresse habituelle de l’administration. Rouvrez la bibliothèque depuis son menu, sans reprendre un ancien onglet resté ouvert depuis plusieurs jours. Comparez le même fichier et la même vue. Une session renouvelée peut corriger une demande dont l’authentification n’est plus valable.
  2. Essayez ensuite un autre profil de navigateur à jour, sans extension supplémentaire, avec le même compte. Une fenêtre privée n’exclut pas forcément toutes les extensions. Si le résultat change, comparez les réglages du navigateur avant de toucher au serveur.
  3. Cette méthode ne demande ni suppression de tous vos cookies ni désactivation générale de la sécurité. Si vous changez un réglage ciblé pour ce site, notez sa valeur et rétablissez-la après un essai sans amélioration. Quand plusieurs navigateurs et utilisateurs rencontrent la même panne, relevez la requête en échec plutôt que de répéter les reconnexions.

Observer la demande de médias qui échoue

Dans Chrome, ouvrez les outils de développement depuis le menu du navigateur, puis Réseau. Laissez cet outil ouvert et rechargez seulement l’écran Médias. Pour un sélecteur, ouvrez-le à nouveau après avoir sécurisé votre brouillon. Cherchez les requêtes apparues au moment du chargement ; le filtre Fetch/XHR aide à repérer les échanges de données.

La grille classique utilise notamment admin-ajax.php avec l’action query-attachments. D’autres parcours d’éditeur utilisent l’API REST, une interface de communication dont les routes médias comprennent /wp/v2/media. Ne supposez pas que tous les écrans emploient la même route : observez celle réellement demandée. Dans Réseau, le volet Payload ou Charge utile de la requête admin-ajax permet de lire son action : ne confondez pas query-attachments, qui consulte les fiches, avec un envoi de fichier. Ne modifiez aucun paramètre pour cette lecture.

Sélectionnez la requête et relevez son heure, son statut et son adresse. Consultez Aperçu ou Réponse pour distinguer une liste de médias d’une page de connexion ou d’un message de blocage. Ne modifiez pas la requête et ne collez aucun script dans la console. Des captures nettoyées suffisent pour transmettre le constat au support.

Interpréter la réponse sans confondre code et cause

Un statut 401 ou une redirection vers la connexion invite à vérifier l’authentification. Un 403 indique un refus : droits du compte, protection de la requête ou règle du pare-feu doivent être examinés. Ce code ne démontre pas un défaut de permission du dossier des images.

Un 404 sur la route de consultation demande de vérifier cette route et les adresses. Il ne signifie pas que toutes les photos ont disparu. Une erreur 500 ou 503 nécessite les journaux du serveur à l’heure relevée. Évitez de conclure immédiatement à un manque de mémoire.

Même avec un statut 200, examinez la réponse : une page HTML, un message PHP ou une erreur applicative ne remplace pas les données structurées attendues. Une réponse valide mais vide demande de reprendre filtres, contexte du compte et présence des fiches.

Ouvrir manuellement une adresse REST dans un nouvel onglet ne reproduit pas forcément la demande authentifiée de l’éditeur. Celle-ci peut inclure un jeton de validation, appelé nonce, et des paramètres absents de votre essai. Appuyez le diagnostic sur l’échange observé, sans diffuser cookies ni jetons.

Corriger seulement le composant identifié

Avec ces éléments, demandez au responsable du site de rapprocher la requête des journaux et des changements récents. Une règle de sécurité déclenchée doit être corrigée pour l’appel légitime concerné, pas désactivée pour toute l’administration. Une réponse mise en cache à tort demande de corriger cette règle de cache.

Si un composant est suspect, comparez son activation sur une copie isolée disposant de ses propres données. Neutralisez les envois, paiements et autres effets externes. Notez son réglage initial, changez un seul élément, reprenez la même consultation puis rétablissez-le si l’essai ne résout rien.

Après correction, vérifiez grille, liste et sélecteur. Une nouvelle extension de médiathèque peut modifier l’écran sans résoudre la requête défectueuse. Gardez le diagnostic centré sur le chargement existant. Si les fiches reviennent mais que leurs images restent cassées, poursuivez vers l’accès aux fichiers.

Approche 3 : comparer l’adresse du fichier et celle de la vignette

Ce parcours part d’une fiche visible dans la liste. Il demande les droits de consultation, pas l’accès au serveur. Le résultat recherché est une paire d’adresses observées : fichier principal et vignette en échec. Aucune modification n’est nécessaire à ce stade, donc rien ne doit être supprimé ou restauré pour annuler cette comparaison.

  1. Depuis la liste, ouvrez la fiche du média témoin et relevez l’URL du fichier. Ouvrez cette adresse dans un nouvel onglet. Vérifiez que vous consultez bien le fichier, pas une page de pièce jointe entourée du thème. Pour une image destinée à être publique, comparez aussi son accès sans connexion ; respectez les restrictions prévues pour les contenus privés.
  2. Revenez à l’écran cassé et regardez dans Réseau la requête de l’image, avec le filtre Img si nécessaire. La vignette demandée peut avoir une autre adresse que le fichier principal. Comparez le domaine, le dossier, le nom et l’extension, sans modifier l’URL au hasard pour fabriquer une variante supposée.
  3. Par exemple, le fichier principal peut s’ouvrir alors que seule une version redimensionnée manque. À l’inverse, la fiche peut pointer vers un ancien domaine. Ces deux situations demandent des corrections différentes. Conservez les adresses exactes et le résultat de chaque ouverture avant de lancer une réparation.

Distinguer fichier absent, refus d’accès et adresse obsolète

Un 404 sur l’image indique que cette adresse ne fournit pas la ressource attendue ; le fichier peut manquer, avoir changé de chemin ou être masqué par une règle. Un 403 appelle une vérification d’accès. Demandez à l’hébergeur de comparer le chemin réel, le propriétaire et les permissions, sans imposer un réglage universel ni ouvrir les dossiers en 777.

Si le site est en HTTPS mais demande encore une image en HTTP, relevez les avertissements du navigateur. Selon la ressource, le navigateur tente une adresse HTTPS ou bloque le chargement. La correction consiste à rétablir une adresse sécurisée valide, sans autoriser globalement le contenu non sécurisé.

Un CDN est un service intermédiaire qui distribue des copies des médias. Si les fichiers passent par ce service ou un stockage externe, son adresse et ses règles font partie du diagnostic. Faites vérifier l’origine autorisée avant une purge ciblée ; vider un cache ne recrée pas un fichier absent.

Vérifier la taille que WordPress demande réellement

Dans Médias > Bibliothèque, ouvrez en vue Liste la fiche du média importé. Notez son identifiant et ouvrez l’URL du fichier principal. Revenez à l’écran où la miniature manque. Dans l’onglet Réseau du navigateur, relevez la requête de l’image effectivement choisie. Si la page utilise une image adaptative, elle peut demander une taille différente de celle choisie dans l’éditeur. Comparez le nom, le code HTTP et le type de contenu des deux réponses.

Faites ensuite lire la taille attendue dans les métadonnées du même identifiant. Une taille déclarée dans les réglages du site, une ligne enregistrée dans les métadonnées et un fichier accessible à son URL sont trois éléments distincts. Si la ligne de taille manque, vérifiez que la taille est encore déclarée et que les dimensions de l’original permettent sa création. Si elle existe, relevez le nom exact qu’elle donne et vérifiez ce fichier. Ne déduisez pas son nom uniquement des dimensions.

Lorsque l’original répond 200 mais que le dérivé échoue, gardez l’original et les métadonnées actuelles. Comparez d’abord le stockage et l’accès à cette seule variante. Un blocage d’accès peut persister après une régénération réussie.

Lire la taille déclarée et la taille enregistrée

Avec un terminal autorisé, remplacez le chemin de la copie, son domaine et l’identifiant 123 dans les commandes ci-dessous. La première lit la taille enregistrée pour ce média. Recherchez la clé thumbnail dans sizes ou la clé réellement demandée par le thème. Relevez son champ file et ses dimensions. La deuxième commande donne les tailles que le site déclare actuellement. Ces commandes ne régénèrent aucun fichier. Conservez le résultat en privé. En multisite, l’argument --url doit désigner le sous-site vérifié.

Si la ligne manque dans les métadonnées, WordPress peut proposer l’original ou une autre taille selon la demande. Un aperçu visible ne prouve donc pas que le fichier de la taille attendue existe. Si la ligne est présente, relevez l’adresse du dérivé réellement sélectionné et vérifiez le fichier correspondant au stockage d’origine. Un chemin de stockage distant, un filtre de médias ou un générateur d’images peut changer l’adresse exposée. Demandez au mainteneur de rapprocher cette adresse et le nom attendu avant de déplacer un fichier.

wp --path="/chemin/recette" --url="https://recette.example.test" post meta get 123 _wp_attachment_metadata --format=json
wp --path="/chemin/recette" --url="https://recette.example.test" media image-size --format=json

Observer trois causes sur une copie

Premier cas à distinguer sur votre copie : l’original existe, une taille est déclarée par le site, mais sa ligne manque dans les métadonnées du média. Vérifiez que les dimensions et le format permettent cette génération et qu’aucun composant ne l’exclut. Une régénération ciblée peut alors être appropriée après sauvegarde. Conservez l’état initial des métadonnées et des fichiers pour comparer ce qui est ajouté.

Deuxième cas : les métadonnées indiquent une variante, mais le fichier correspondant ne répond plus. Rapprochez son nom exact du stockage réel ; ne concluez pas à sa présence à partir de la seule ligne enregistrée. Un fichier sauvegardé peut être rétabli après comparaison, ou une régénération ciblée peut être envisagée. L’option --only-missing ne dispense jamais de vérifier ce qui a réellement été créé sur votre version de WP-CLI et votre intégration de stockage.

Troisième cas : le fichier existe, mais une règle de diffusion ou d’accès empêche sa lecture HTTP. Une régénération ne corrige pas nécessairement cette règle. Faites comparer l’URL réellement demandée, le chemin d’origine et la réponse du service de diffusion, puis corrigez uniquement le refus injustifié. Le critère final reste l’accès à la bonne variante dans la page concernée, pas seulement un message de régénération réussi.

Générer une seule taille ou rétablir son fichier

Si le fichier sauvegardé correspond exactement à la ligne et à l’adresse attendues, rétablissez-le d’abord sur la copie. Contrôlez son contenu et une page qui l’utilise. Si le fichier doit être recréé, préservez l’original, les variantes et les métadonnées de cet identifiant. La commande suivante écrit une taille unique pour ce média. Remplacez thumbnail par la taille vérifiée si elle diffère. --skip-delete garde les anciennes variantes, mais une génération peut écrire un fichier sous le même nom. Comparez les fichiers et la métadonnée avant et après. Si le résultat ne convient pas, restaurez les seuls fichiers et données de ce média depuis la copie préparée.

wp --path="/chemin/recette" --url="https://recette.example.test" media regenerate 123 --image_size=thumbnail --only-missing --skip-delete

Régénérer un seul média avec ou sans SSH

Ce parcours convient uniquement à une variante manquante confirmée, avec une source lisible. Il ne répare ni une grille dont la requête échoue ni un original perdu. Avec un stockage externe, faites d’abord confirmer la méthode de l’intégration. Ouvrez la fiche du média depuis la vue liste : le nombre après post= dans l’adresse d’édition est son identifiant. Faites confirmer cet identifiant et la bonne installation. Préservez les fichiers et métadonnées du média avant toute écriture, avec un moyen de les restaurer ; à défaut, faites préparer la sauvegarde par l’hébergeur.

Si WP-CLI est déjà disponible avec un accès SSH autorisé, placez-vous dans le répertoire de cette installation. L’exemple en fin de section régénère les tailles du média 123 ; remplacez 123 par l’identifiant vérifié, sans le retirer pour traiter toute la bibliothèque. La commande écrit immédiatement, sans simulation. En multisite, sélectionnez aussi le bon sous-site avec --url=https://sous-site.exemple, en remplaçant ce domaine fictif par son adresse exacte. Un même nombre peut désigner un autre média sur un autre site du réseau.

L’option --skip-delete conserve les anciennes miniatures qui pourraient encore être référencées. Elle n’annule pas les modifications des fichiers régénérés ni celles des métadonnées : la sauvegarde reste nécessaire. N’ajoutez pas d’option de suppression ou de mise à jour automatique des références pour ce premier essai ciblé.

Après l’un ou l’autre parcours, contrôlez la fiche, la vignette attendue et une page utilisant l’image. Si l’original ne peut pas être lu ou traité, arrêtez les régénérations : cette cause doit être résolue d’abord. En cas de résultat dégradé, faites restaurer uniquement les fichiers et métadonnées associés au média depuis la copie de contrôle. Désactiver une extension n’annule pas ses écritures. Une fois l’opération vérifiée, une extension ajoutée seulement pour ce dépannage peut être désactivée.

Sans SSH, reGenerate Thumbnails Advanced de ShortPixel fournit une action individuelle dans son édition gratuite. Vérifiez le nom et l’auteur : son identifiant dans le répertoire officiel est regenerate-thumbnails-advanced, différent de Regenerate Thumbnails et de Force Regenerate Thumbnails. L’accès requis permet d’installer une extension et de gérer ce média ; en multisite ou sur une offre gérée, passez par le responsable si ces droits manquent. Le moteur d’images doit pouvoir traiter la source et le dossier accepter les fichiers générés. Cette extension n’est pas nécessaire pour les autres diagnostics du guide.

Le parcours ci-dessous utilise l’édition gratuite 2.5.0. Sa fiche déclare WordPress 4.0 et PHP 5.6 au minimum et une compatibilité vérifiée par l’éditeur jusqu’à WordPress 7.1.4 ; ces minima ne sont pas des versions recommandées pour votre hébergement. Confirmez les prérequis de la version proposée au moment de l’installation. Si une extension d’optimisation ou de stockage externe intervient déjà sur les images, vérifiez ses interactions avant ce contrôle, idéalement sur une copie. N’ajoutez pas de second optimiseur pour régénérer une vignette.

  1. Sans SSH, ouvrez Extensions > Ajouter une extension. Recherchez reGenerate Thumbnails Advanced, confirmez ShortPixel, puis installez et activez cette seule extension.
  2. Ouvrez Outils > Regenerate Thumbnails. Dans Regenerate these thumbnails, relevez la sélection actuelle, puis sélectionnez uniquement la taille dont l’absence a été confirmée. Laissez Force regeneration décoché pour ne pas remplacer les variantes déjà présentes. Ne changez ni les dimensions ni la qualité JPEG pour ce diagnostic, puis cliquez sur Save Settings.
  3. Laissez désactivées les options de nettoyage ou suppression : Delete Unselected Thumbnails, Remove non-existent images et Clean unknown metadata. Ces options sont signalées Pro dans cette édition ; elles ne sont pas nécessaires. Ne lancez pas le bouton de traitement de toute la bibliothèque.
  4. Revenez à Médias > Bibliothèque en vue liste. Vérifiez le titre, la date, le fichier et le nombre post= de la fiche choisie. Sur cette seule ligne, cliquez sur Regenerate Thumbnails. Ce clic déclenche l’écriture pour cet identifiant ; il ne s’agit pas d’un simple aperçu.
  5. Attendez le retour de la page et son message de résultat, sans recliquer ni lancer une deuxième opération. Si un échec survient, relevez le message et contrôlez le média avant de décider d’une nouvelle tentative.
  6. Vérifiez la variante, la fiche et la page qui utilise l’image. Rétablissez ensuite les réglages temporaires de l’extension si vous la conservez. Pour revenir sur les fichiers ou métadonnées modifiés, utilisez la sauvegarde ciblée, pas une suppression de la fiche média.
wp media regenerate 123 --skip-delete

Après une migration, vérifier ce qui a réellement été transféré

Comparez un média ancien et un média récent, ainsi que leurs dates et chemins. Si seuls les fichiers d’une période manquent, vérifiez si les dossiers correspondants ont été transférés. Un dossier de médias peut avoir été personnalisé ou externalisé ; ne supposez pas que tout se trouve forcément au même endroit que sur l’ancien hébergement.

Si les adresses pointent vers l’ancien domaine, faites distinguer les URL présentes dans les articles, celles calculées pour les médias et celles produites par un service de stockage. Changer le titre d’une image ou réenregistrer les permaliens ne corrige pas automatiquement ces trois sources.

Une correction d’adresses en base doit préserver les données structurées de WordPress. Confiez au responsable une opération limitée, précédée d’une sauvegarde et d’une simulation avec un outil adapté. Ne remplacez pas aveuglément du texte dans un export SQL. Contrôlez les occurrences proposées avant toute écriture et vérifiez ensuite les médias témoins.

Des fichiers présents ne suffisent pas à remplir la bibliothèque

Déposer des images par SFTP dans un dossier ne crée pas automatiquement leurs fiches WordPress. Une migration peut transférer les fichiers sans les enregistrements qui les décrivent. Une image encore visible dans un article ne prouve donc pas qu’elle figure dans la bibliothèque de la nouvelle installation.

La personne qui dispose déjà de WP-CLI et d’un terminal autorisé peut consulter un échantillon de pièces jointes. Depuis le répertoire confirmé de la bonne installation, la commande ci-dessous lit vingt fiches de type attachment avec le statut inherit. En multisite, ajoutez --url avec l’adresse du sous-site vérifié.

Le résultat attendu est un relevé d’identifiants, titres et dates à comparer avec la bibliothèque. Ce n’est pas un inventaire complet : les médias plus anciens ou avec un autre état peuvent ne pas apparaître, et des filtres de composants peuvent encore agir. Une fiche présente ne prouve pas non plus que son fichier existe.

Si le média attendu manque dans cet échantillon, poursuivez la recherche dans la liste administrative, ses dates et ses fiches, puis avec les données de l’ancienne copie selon le contexte. N’importez pas un fichier sur la seule base de ces vingt lignes. Il faut confirmer le site, l’absence réelle de fiche et les associations à préserver avant une écriture.

  1. Vérifiez le dossier WordPress et le sous-site avec le responsable de l’environnement.
  2. Exécutez ce relevé sans commande de création ou de suppression.
  3. Comparez un identifiant trouvé avec sa fiche dans Médias et l’adresse de son fichier.
  4. Recherchez séparément le média manquant par son nom, sa période et l’ancienne référence disponible ; vérifiez qu’un filtre ne le masque pas.
  5. Si une récupération ou un import est nécessaire, commencez par un seul fichier autorisé avec une copie préservée.
wp post list --post_type=attachment --post_status=inherit --posts_per_page=20 --fields=ID,post_title,post_date --format=table

Importer un seul fichier dont la fiche manque réellement

Cette action s’adresse au technicien disposant déjà de WP-CLI et des droits adaptés, de préférence sur copie. Elle crée une nouvelle fiche et copie le fichier dans le stockage d’envoi prévu par cette installation. Elle ne restaure pas l’ancien identifiant, les liens insérés ni toutes les associations des pages. Dans un réseau multisite, sélectionnez ici aussi le sous-site avec --url ; le chemin du terminal ne le distingue pas à lui seul.

Préparez un original autorisé dans un chemin privé et vérifiez qu’une fiche existante ne représente pas déjà ce même fichier. Comparez le nom, l’URL et les références connues ; les titres seuls peuvent différer. Si la migration doit conserver les anciens identifiants et relations, utilisez plutôt sa récupération ciblée sur copie que ce nouvel import.

Remplacez /CHEMIN_PRIVE_CONFIRME/photo-temoin.jpg par le chemin absolu réel du fichier local et adaptez le titre. Gardez un seul chemin, sans joker ni dossier entier. N’ajoutez pas --skip-copy pour un original privé : cette option laisse le fichier à son emplacement. L’option de dédoublonnage --skip-duplicates n’appartient pas encore à une version stable selon la documentation consultée ; le contrôle préalable reste nécessaire.

Le résultat attendu est un nouvel identifiant, puis une fiche, un fichier et des variantes vérifiés. Si l’opération s’arrête, cherchez ce qui a déjà été créé avant de recommencer. Pour annuler sur copie, retrouvez ce nouvel identifiant dans Médias > Bibliothèque et contrôlez ses usages avant toute suppression de cette seule fiche et de ses fichiers. Gardez l’original privé et la sauvegarde : supprimer une fiche est une action distincte de la fin de l’import. Ne supprimez pas un média ancien pour faire correspondre les noms.

Sans terminal, si une copie autorisée du fichier est disponible sur votre ordinateur, utilisez Médias, Ajouter un fichier, puis sélectionnez ce seul fichier. Attendez la fin de l’envoi et ouvrez sa fiche pour contrôler l’adresse et la vignette. Ce parcours natif crée également une nouvelle fiche : les mêmes contrôles de doublon, d’association et de retour arrière s’appliquent.

  1. Conservez la base et les fichiers concernés, puis confirmez absence de doublon et associations attendues.
  2. Depuis la bonne installation, exécutez l’import unique adapté ci-dessous et relevez l’identifiant retourné.
  3. Ouvrez Médias, Bibliothèque et retrouvez cette fiche ; vérifiez URL, fichier, vignette et date.
  4. Complétez les informations utiles, notamment texte alternatif et légende, puis sélectionnez le média dans un brouillon de contrôle sans publier.
  5. Comparez les pages anciennes séparément : elles ne changent pas automatiquement de référence grâce à cet import.
wp media import "/CHEMIN_PRIVE_CONFIRME/photo-temoin.jpg" --title="Photo temoin" --porcelain

Récupérer les éléments manquants sans remplacer le site actuel

Si un fichier a disparu, cherchez une copie locale, l’ancien stockage ou une sauvegarde contenant exactement cet élément. Si ses données WordPress manquent aussi, une archive de fichiers seule ne suffit pas. Demandez une inspection de la sauvegarde dans un environnement séparé, avec une base distincte et un accès protégé.

Récupérez uniquement les éléments identifiés. Avant de replacer un fichier au même chemin, vérifiez qu’il n’écrase pas une version actuelle différente. Avant de réintégrer des données, faites préserver les identifiants et associations nécessaires sans remplacer les autres contenus. Un ancien identifiant déjà réattribué sur le nouveau site ne doit pas être écrasé pour forcer cette correspondance.

Ne restaurez pas toute la base ni toute la préproduction pour retrouver quelques vignettes : les articles, comptes, commentaires et commandes récents pourraient être affectés. Si aucune copie exploitable n’existe, indiquez cette limite. Ni un nettoyage de cache ni une extension installée après la disparition ne garantit le retour du média original.

Confirmer le résultat et transmettre un dossier utile

Recherchez à nouveau le média témoin, sans filtre, en grille puis en liste. Ouvrez sa fiche, contrôlez le fichier et sa vignette, puis sélectionnez-le dans un brouillon. Vérifiez l’aperçu et une page déjà publiée qui l’utilise. Une bibliothèque redevenue visible ne suffit pas si ses images restent inaccessibles aux lecteurs.

Reprenez ensuite un deuxième média d’une autre date pour vérifier la portée de la correction. Rétablissez les réglages temporaires et conservez la sauvegarde jusqu’à validation. Notez la cause constatée et la modification retenue plutôt que de conserver plusieurs changements dont l’effet reste inconnu.

Pour le support, transmettez les écrans touchés, la version, l’heure, le média témoin et les résultats grille, liste, sélecteur et URL directe. Ajoutez le statut de la requête concernée et les changements récents. Nettoyez les captures et ne partagez pas un export réseau complet contenant une session privée. Ces éléments permettent de travailler sur le bon niveau, sans recommencer une série d’essais destructifs.

Sources et références

Ces références permettent de vérifier les fonctions, les prérequis et les limites décrits. Une documentation consultée ne constitue pas un essai pratique.

Consulter les 24 références

Ces guides peuvent aussi vous aider