La biblioteca de medios de WordPress no muestra imágenes ¿qué hago?

Te puede suceder, sobre todo después de una migración, pero también tras actualizaciones, que, de repente, accedas a la biblioteca de medios y no veas ninguna imagen, a pesar de que existan, y de que se muestren correctamente en las entradas o páginas en las que estén adjuntas. ¿A qué es debido?

¿Por qué de repente no se ven las imágenes en la biblioteca de medios?

Los motivos por los que repentinamente dejes de ver tus fotos en la biblioteca de medios de WordPress (media library en inglés) pueden ser varios, y cito:

• Permisos de archivo incorrectos : cada archivo que subes a tu web se almacena en el servidor del hosting. En lo que respecta a los servidores, necesitas diferentes permisos para diferentes tipos de archivos. La falta de los permisos necesarios puede causar problemas relacionados con las imágenes de la biblioteca de medios de WordPress.
• Plugins defectuosos o antiguos : en la mayoría de las web, un plugin defectuoso o antiguo es el culpable de que la biblioteca multimedia de WordPress no muestre imágenes. Es más probable que te enfrentes a este problema si un plugin está mal programado o es incompatible con tu instalación de WordPress, con otros plugins, con el tema, o con códigos personalizados.
  La integración con software de terceros y problemas de codificación accidentales en los plugins también pueden ser responsables de que la biblioteca de medios de WordPress no muestre imágenes.
• Actualización incompleta de WordPress : puede haber dejado una instalación rota, en la que falte algún fichero del sistema imprescindible para que se muestren correctamente las imágenes en la biblioteca de medios.
• Temas incompatibles : antes de seleccionar un tema, debes asegurarte de que sea compatible con tu web. A menudo, la gente se olvida de esto y ahí es donde empieza el problema.
  Debido a la incompatibilidad con los temas, las imágenes no se muestran en la biblioteca de medios de WordPress. Los temas incompatibles también reducen la eficiencia de tu sitio web.
• Configuraciones incorrectas: hay ajustes y funcionalidades de WordPress que, en según qué situaciones, podrían estar interfiriendo, y provocar que no se vean las imágenes de la biblioteca de medios, o que no se vean en según qué situaciones.

Así que, una vez conocidos los posibles motivos, vamos a por las soluciones…

Permisos de archivo incorrectos

Como unos permisos de archivo incorrectos en el servidor podrían, entre otras cosas, impedir que ciertos archivos se puedan visualizar en la biblioteca de medios, o incluso que no sean accesibles, lo primero que te recomiendo es revisar que los permisos sean los adecuados para WordPress:

• 644 para archivos.
• 755 para carpetas.

Esto puedes hacerlo manualmente, desde el gestos de archivos del hosting o mediante FTP, modificando los permisos.

Es especialmente importante, y lo primero que debes comprobar, revisar permisos de la carpeta wp-content, uploads, y las que hay dentro de esta, así como de todos los archivos de imagen de todas estas carpetas.

Y si tienes alojada tu web en SiteGround, puedes restaurar los permisos de todos los archivos y carpetas de WordPress a los adecuados en un solo clic, desde el menú desplegable en el listado de instalaciones de WordPress.

Cuando hayas restablecido los permisos comprueba a ver si ya se ven los archivos en la biblioteca de medios. Si no fuera así, seguimos…

Plugins defectuosos o antiguos

Puede ser, que un plugin (o varios) entren en conflicto con otros, o con el tema, o que la versión actual de algún plugin no sea del todo compatible con tu versión de WordPress y todas las variables que se te ocurran al respecto, y que por eso no se vean las imágenes en tu biblioteca de medios.

Para descartar este tipo de problemas con los plugins el procedimiento es el de siempre, sí, ese que siempre se te olvida hacer aunque te lo sabes de memoria:

1. Desactiva TODOS los plugins. Si con todos inactivos vuelves a ver los medios en la biblioteca ya sabes que alguno de ellos es el culpable.
2. Si así fuera ve activando uno a uno hasta dar con el culpable.
3. Una vez detectado puedes hacer varias cosas:
   • Dejarlo desactivado si no es imprescindible.
   • Por su fuese una actualización la culpable, y con las versiones anteriores no pasaba, temporalmente puedes instalar una versión más antigua del plugin, como expliqué en esta guía.
   • Revisar si existe alguna actualización que solucione el problema, o pedirla al desarrollador.
   • Abrir una consulta de soporte al desarrollador para que sea consciente del problema y actualice el plugin para solucionarlo.
   • Buscar un plugin alternativo, que haga lo mismo sin romper la biblioteca de medios.

Tema incompatible

El mismo escenario puede suceder al contrario, y que sea en realidad el tema quien es incompatible con las últimas versiones de WordPress, con alguno de los plugins activos o con alguna configuración actual.

En este caso el procedimiento estándar, y que todo (o casi) lo cura es este:

1. Activa un tema por defecto oficial de WordPress, los denominados Twenty-xxx, pues siempre están al día con las últimas novedades de WordPress.
2. Si se soluciona el problema con la biblioteca de medios ya sabes que hay un problema con el tema actual, en cuyo caso puedes hacer algo de esto:
   • Por su fuese una actualización la culpable, y con las versiones anteriores no pasaba, temporalmente puedes instalar una versión más antigua del plugin, como expliqué en esta guía.
   • Abrir una consulta de soporte al desarrollador para que sea consciente del problema y actualice el tema para solucionarlo.
   • Revisar si existe alguna actualización que solucione el problema, o pedirla al desarrollador.
   • Buscar un tema alternativo, que cumpla con tus necesidades, pero que no rompa la biblioteca de medios.

Actualización incompleta de WordPress

Si has actualizado recientemente WordPress podría haberse realizado una instalación incompleta, y la falta de algún archivo o carpeta del sistema provocar este comportamiento anómalo. Mi consejo en este caso es que te asegures y realices una actualización completa de WordPress al viejo estilo, para asegurarte de que no queda nada sin actualizar correctamente.

Configuraciones incorrectas que impidan la visualización de medios en la biblioteca

Si ya hemos descartado los posibles culpables anteriores, hay aún algunas cosas que podemos comprobar, por el problema tuviese una causa distinta, y hay unas cuantas posibles.

Caché y cookies del navegador

Son muchas más veces de las que recuerdo en las que un error aparentemente irresoluble en la web de un cliente era debido a problemas de la caché o las cookies de su navegador.

Para comprobar que sea este el problema puedes probar con otro usuario de Google si usas Chrome, o pidiendo a un colega que compruebe si ve o no los medios en la biblioteca con otro usuario, perfil y/o navegador.

Si en estas pruebas resulta que el problema está solo en un navegador/usuario la solución pasa por borrar las cookies, datos de navegación y caché del navegador, que en Chrome y Firefox están en sus correspondientes secciones de privacidad.

Tras este proceso suele ser recomendable reiniciar el navegador y volver a acceder a WordPress, para comprobar si ya funciona correctamente la biblioteca de medios.

Las imágenes se ven en el modo lista pero no en el modo cuadrícula

Hay un caso especial de este problema en el que en modo lista se ven perfectamente los medios, pero al cambiar al modo cuadrícula dejan de verse.

Si fuese este tu caso, y los procedimientos anteriores no te han funcionado, puedes probar a desactivar la carga diferida de medios nativa de WordPress, añadiendo esta línea de código al archivo functions.php del tema hijo activo, un plugin especializado o usando un plugin de fragmentos de código, lo que gustes:

add_filter( 'wp_lazy_loading_enabled', '__return_false' );

Tras guardar los cambios revisa si se solucionó el problema. En caso contrario, y para este problema en concreto, podría ayudar este otro código:

add_filter('wp_prepare_attachment_for_js', 'ayudawp_ver_miniaturas_medios', 10, 3 );
function ayudawp_ver_miniaturas_medios($response, $attachment, $meta) {
if ($response['context'] == 'custom-header') $response['context'] = ''; 
return $response;
}

Aumenta el límite de memoria disponible para WordPress

También, podría ser que no se muestran las imágenes porque el proceso, en un alojamiento escaso de recursos debido a otros consumos, no es capaz de ejecutarse por disponer de poca memoria disponible.

Puedes intentar forzar que WordPress tenga más memoria del servidor disponible añadiendo lo siguiente al archivo wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

Revisa a ver si ahora consigues ver las imágenes en la biblioteca, sino, pues seguimos probando otras cosas.

Desactiva mod_security

El módulo de PHP mod_security puede provocar efectos indeseados en webs WordPress si está activo. Puedes probar a ver si fuese el culpable de este problema desactivándolo añadiendo lo siguiente al archivo .htaccess:

<IfModule mod_security.c>
SecFilterEngine Off
SecFilterScanPOST Off
</IfModule>

Regenera las miniaturas

Un plugin que hace maravillas, siempre, pero también en estas situaciones, es Regenerate Thumbnails. Instálalo y actívalo, es gratis, y regenera todas las miniaturas – que es lo que no se ve en la biblioteca de medios – asegurándote de desmarcar las opciones de los ajustes, como en la siguiente captura:

Fuerza la carpeta de subidas con una constante

También podría ser útil forzar la carpeta a donde debe WordPress subir los archivos de imagen, y que de paso registre esta información para todas las tablas de opciones de WordPress. Esto se hace añadiendo la siguiente constante al archivo wp-config.php:

define('UPLOADS', 'wp-content/uploads');

Tras este cambio, prueba a ver si ya lo conseguiste. ¡Ah! ¿qué no?, seguimosssss… no desesperes.

Bloquea los hotlinks o enlaces directos externos

Pues sí, resulta que he visto en alguna ocasión que el exceso de hotlinking puede llegar a provocar tal exceso de consumo de recursos en el servidor afectado que este empiece a mostrar malos funcionamientos, y uno de ellos puede ser que deje de mostrar las imágenes en la biblioteca de medios.

Te animo encarecidamente a que bloquees esta mala práctica, y que impidas que usen las imágenes alojadas en tu servidor para mostrarlas en el contenido de otras webs, usando los recursos de tu servidor.

Si tu hosting usa CPanel o Plesk, ambos paneles disponen de herramientas para protección del hotlinking, que puedes activar fácilmente.

En caso contrario, aquí tienes un tutorial…

Qué es hotlinking y cómo protegerte

No queda espacio de alojamiento en el servidor

Podría pasar, y es causa de este y muchos otros problemas, aparentemente sin solución, en WordPress.

Comprueba si has agotado todo el espacio de alojamiento contratado en tu hosting o si estás cerca del total, en ambos casos podrías sufrir de este y otros muchos fallos en tu web.

Si así fuera, libera espacio ocupado innecesariamente o contrata más. No hay misterios.

Vuelve a sincronizar las imágenes con la biblioteca de medios

Para finalizar, si todo, todo, todo lo anterior ha fallado, hay una posible solución más, y es forzar una sincronización de WordPress, de la biblioteca de medios, con los archivos de imagen (existentes) en la carpeta de medios.

Y digo para finalizar, porque aunque esto que te voy a contar ahora podría ser la solución que quieras usar antes que las otras, podrías no haber corregido el problema de base, que casi siempre es uno de los primeros que hemos visto antes, y que deberás solucionar sí o sí, aunque arregles este problema concreto de los medios usando lo siguiente. Ten en cuenta que los problemas de permisos,  malas actualizaciones, etc., pueden provocar montones de problemas, no solo este de medios que no se visualizan en la biblioteca, y que deberías ver como un síntoma de que pasa algo más en tu web, repito, aunque esto en concreto lo corrijas sincronizando las subidas.

Dicho lo anterior, puedes re-sincronizar la carpeta de subidas con la biblioteca de medios usando alguno de los siguientes plugins:

• Add from server – Aunque hace ya 4 años que no se actualiza, podría funcionar en tu instalación y ayudarte a poder volver a visualizar los medios en la biblioteca.
• Media Sync – Actualizado bastante a menudo es muy eficaz tanto en sincronización completa de la biblioteca de medios como en el filtrado de archivos concretos que falten.

Ambos plugins son muy sencillos de usar, pero si te tengo que recomendar uno de ellos mejor usa Media Sync, está más actualizado y no falla, el otro en ocasiones ya no va.

¿Ya? ¿conseguiste solucionar el problema con la biblioteca de medios que no muestra las imágenes?

Si lo has arreglado creo que nos sería a todos de ayuda contarnos – abajo en los comentarios – cómo lo lograste, y si aún no lo has conseguido cuéntanos también qué has intentado y qué no y lo mismo podemos ayudarte entre todos.

¿Te gustó este artículo? ¡Ni te imaginas lo que te estás perdiendo en YouTube!