Un plugin de WordPress ha roto mi web: ¿qué debo hacer?

Si su web dejó de funcionar justo después de instalar, activar o actualizar un plugin, es natural sospechar de ese plugin. Muy a menudo tiene razón, aunque no siempre por el motivo que cree.

Un problema con un plugin puede afectar a:

• toda la web
• solo el escritorio de WordPress
• una página o un diseño concretos
• el checkout, los formularios o el acceso
• algo menos visible, como los emails, la búsqueda o las tareas en segundo plano

La buena noticia es que un problema con un plugin rara vez significa que se hayan perdido sus contenidos o sus datos. En la mayoría de los casos la información sigue en la base de datos: simplemente la web no puede mostrarla mientras se ejecuta el código defectuoso.

Lo importante es identificar el plugin con calma, cambiar una sola cosa cada vez y comprobar qué más depende de él antes de desactivarlo.

Esta guía explica cómo suelen producirse los problemas con plugins, cómo averiguar qué plugin está implicado, qué puede probar con seguridad y cuándo es mejor pedir soporte técnico.

¿Qué significa que un plugin rompa una web?

Un plugin añade código a su web. Cada vez que se carga una página, WordPress ejecuta el código de todos los plugins activos junto con el del tema y el del propio WordPress.

Si una parte de ese código falla, o dos partes intentan hacer cosas incompatibles, el resultado puede ser:

• un mensaje como "Ha habido un error crítico en esta web" ("There has been a critical error on this website")
• una página en blanco
• una página que carga sin su diseño o sus estilos
• botones, menús o formularios que dejan de responder
• un escritorio que se vuelve lento o inaccesible
• errores solo para los usuarios conectados, o solo para los visitantes

El plugin del que sospecha no tiene por qué estar mal hecho. Puede funcionar perfectamente en miles de webs y, aun así, fallar en la suya por la combinación concreta de herramientas, ajustes y servidor que usa.

¿Por qué los plugins rompen las webs?

La mayoría de los problemas con plugins encajan en una de estas tres categorías. Saber cuál se aplica le ayuda a elegir el siguiente paso adecuado.

Un conflicto con otro plugin o con el tema

Dos plugins pueden intentar cambiar lo mismo, cargar versiones distintas de la misma librería o depender el uno del otro de formas que sus desarrolladores no previeron.

Un conflicto suele aparecer cuando:

• se instala un plugin nuevo en una web que ya tiene muchos plugins
• dos plugins ofrecen funciones parecidas, como caché, seguridad o SEO
• el tema incluye funciones que se solapan con las de un plugin

En este caso, ningún plugin está roto por sí solo. El problema solo existe cuando ambos están activos.

Una actualización defectuosa o incompleta

Una nueva versión de un plugin puede contener un error, eliminar una función de la que dependía o cambiar la forma en que guarda los ajustes.

Una actualización también puede interrumpirse a medias, por ejemplo por un tiempo de espera agotado o por falta de espacio en disco. El plugin queda entonces con archivos que faltan o que no coinciden.

Si el problema empezó inmediatamente después de una actualización, la actualización es lo primero que hay que revisar. Nuestra guía sobre qué hacer cuando WordPress deja de funcionar tras una actualización trata esta situación con más detalle.

Incompatibilidad con PHP o con WordPress

Los plugins se escriben para versiones concretas de PHP, el lenguaje de programación que usa su servidor, y de WordPress.

Un problema puede aparecer cuando:

• el proveedor de hosting actualiza la versión de PHP
• la actualización de un plugin requiere una versión de PHP más reciente que la que ofrece su servidor
• un plugin antiguo no se ha actualizado para las versiones recientes de WordPress o de PHP
• un código a medida construido en torno a un plugin depende de funciones que ya no existen

Este tipo de problema puede aparecer de repente, aunque nadie haya tocado el plugin, porque ha cambiado algo a su alrededor.

¿Cómo saber qué plugin está implicado?

No necesita leer código para reunir pistas útiles. Empiece por las más sencillas.

El momento

Piense en lo que ocurrió justo antes de que apareciera el problema:

• ¿Se instaló, activó o actualizó un plugin?
• ¿Estaban activadas las actualizaciones automáticas?
• ¿Alguien cambió un ajuste de un plugin?
• ¿El proveedor de hosting hizo cambios en el servidor?
• ¿El problema empezó mientras usaba una función concreta?

Si la web se rompió a los pocos minutos de un cambio concreto, ese cambio es su pista más sólida. Anote la hora y el nombre del plugin.

El email de recuperación de WordPress

Cuando WordPress detecta determinados errores fatales, puede enviar un email a la dirección del administrador del sitio. El asunto suele indicar que su sitio está teniendo un problema técnico.

Este email a menudo indica el plugin o el tema que causó el error. También puede incluir un enlace al modo de recuperación (Recovery Mode), que permite a un administrador entrar en el escritorio mientras WordPress pone en pausa el plugin problemático.

Revise:

• la bandeja de entrada del administrador
• las carpetas de spam y correo no deseado
• cualquier dirección compartida que se use para gestionar la web

Desde el modo de recuperación puede desactivar correctamente el plugin en pausa. Le ayuda a entrar, pero no resuelve el problema de fondo.

Trate el enlace al modo de recuperación como información sensible. No lo reenvíe a quien no lo necesite y no lo publique.

El propio mensaje de error

A veces el error que aparece en pantalla, en el email de recuperación o en un log incluye la ruta de un archivo. Si esa ruta contiene algo como:

wp-content/plugins/plugin-folder-name/

el nombre de la carpeta suele indicar qué plugin se estaba ejecutando cuando se produjo el error.

Tenga en cuenta que el plugin que aparece en el error es donde el problema se hizo visible. No siempre es el plugin que lo causó. En un conflicto, un segundo plugin puede haber cambiado algo que el primero no esperaba.

Dónde aparece el problema

Si solo falla el checkout, revise primero los plugins relacionados con pagos, envíos o la tienda. Si solo falla el formulario de contacto, revise los plugins de formularios, de protección antispam y de email. La zona afectada suele ser una buena pista.

Primeras comprobaciones que cualquiera puede hacer con seguridad

Antes de desactivar nada, dedique unos minutos a entender la situación:

1. Abra la web en una ventana privada o de incógnito del navegador.
2. Revise la página de inicio, una página interior y la página de acceso.
3. Intente acceder al escritorio de WordPress.
4. Pruebe las funciones importantes del negocio: checkout, formularios, reservas, áreas de socios.
5. Haga capturas de pantalla de cualquier mensaje de error.
6. Anote la hora a la que notó el problema por primera vez.

Estos pasos no cambian nada en la web, pero le dan a usted, o a quien le ayude, una imagen clara de lo que funciona y lo que no.

¿Desactivar los plugins de uno en uno o todos a la vez?

Es la decisión más importante al resolver problemas con plugins, y ambos enfoques tienen riesgos.

Desactivar un plugin cada vez

Suele ser el enfoque más seguro cuando tiene un sospechoso claro. Desactiva un plugin, prueba la web y decide qué hacer a continuación.

Lleva más tiempo si no tiene ni idea de qué plugin es el responsable, pero le da una respuesta clara y limita los efectos secundarios.

Desactivar todos los plugins a la vez

Es una sugerencia habitual en los foros, y puede confirmar rápidamente si hay algún plugin implicado. Sin embargo, en una web de negocio en producción puede causar problemas nuevos.

Los plugins pueden controlar:

• formularios: las consultas pueden perderse o no entregarse mientras el plugin está desactivado
• pagos y suscripciones: el checkout puede dejar de funcionar o las renovaciones pueden fallar
• seguridad: las reglas del firewall, la protección del acceso y la autenticación en dos pasos pueden dejar de funcionar
• contenido multilingüe: las páginas traducidas pueden desaparecer o mostrarse en el idioma equivocado
• caché: los visitantes pueden ver páginas desactualizadas, o la web puede volverse mucho más lenta
• redirecciones y SEO: URL importantes pueden dejar de redirigir correctamente

Algunos plugins también ejecutan tareas cuando se desactivan o se reactivan, como borrar ajustes o reconstruir datos. Reactivar veinte plugins en el orden correcto no siempre es tan sencillo como desactivarlos.

Si tiene que probar todos los plugins a la vez, use preferiblemente un método que no afecte a los visitantes, como el modo de resolución de problemas descrito más abajo, o una copia de staging de la web.

¿Qué puede probar con seguridad?

La opción adecuada depende de si puede acceder al escritorio y de lo importante que sea la web para su negocio.

Opción 1: use el modo de resolución de problemas de Health Check

El plugin gratuito Health Check & Troubleshooting, mantenido por colaboradores de WordPress, incluye un modo de resolución de problemas.

Cuando se activa, desactiva todos los plugins y cambia a un tema predeterminado solo para su sesión de administrador conectado. Los visitantes siguen viendo la web con normalidad.

Después puede volver a activar los plugins uno a uno dentro de su sesión y ver cuándo reaparece el problema. Es una de las formas más seguras de buscar conflictos en una web en producción.

Algunas cosas que conviene tener en cuenta:

• necesita acceso al escritorio para usarlo
• instalar un plugin nuevo ya es un cambio, así que hágalo cuando la web esté, por lo demás, suficientemente estable
• algunos problemas solo aparecen para los visitantes o durante las tareas en segundo plano, y pueden no verse en su sesión
• recuerde desactivar el modo de resolución de problemas cuando termine

Opción 2: desactive el plugin sospechoso desde el escritorio

Si puede acceder a WordPress y tiene un sospechoso claro, vaya a:

Plugins → Installed Plugins (Plugins → Plugins instalados)

Desactive solo ese plugin y después pruebe la página afectada y las funciones importantes de la web.

Si el problema desaparece, ha encontrado una pista sólida. De momento deje el plugin desactivado en lugar de borrarlo: borrar un plugin también puede eliminar sus ajustes y sus datos.

Opción 3: vuelva a la versión anterior

Si el problema empezó después de actualizar un plugin, volver a la versión anterior puede restablecer la web mientras el desarrollador corrige el fallo.

Hágalo con cuidado:

• la nueva versión puede haber modificado la base de datos, y la versión anterior puede no funcionar correctamente con ella
• la actualización puede haber incluido una corrección de seguridad, y volver atrás podría reintroducir una vulnerabilidad
• use solo versiones descargadas de la fuente oficial o del desarrollador del plugin

Si tiene dudas, es mejor pedir ayuda antes de volver atrás con un plugin que gestiona pagos, usuarios o seguridad.

Opción 4: restaure un backup

Un backup puede devolver toda la web a un estado conocido que funcionaba. Sin embargo, en una web de ecommerce, de socios o de reservas, también puede sobrescribir los pedidos, registros y mensajes recibidos después de hacer el backup.

Compruebe la fecha del backup y piense en lo que ha pasado desde entonces antes de restaurar.

¿Qué debe evitar?

Cuando una web no funciona, es tentador probarlo todo rápidamente. Evite:

• actualizar todos los plugins a la vez con la esperanza de que una actualización lo arregle
• borrar plugins en lugar de desactivarlos
• desactivar plugins de seguridad, de pagos o de formularios sin comprobar las consecuencias
• instalar varios plugins de sustitución para ver cuál funciona
• descargar versiones de plugins desde webs no oficiales
• editar directamente los archivos de los plugins, ya que los cambios se pierden en la siguiente actualización
• publicar en foros públicos logs de errores, capturas con datos personales o datos de acceso
• hacer varios cambios antes de probar el resultado

Cambie una sola cosa cada vez y lleve un breve registro de lo que ha hecho y de lo que ha ocurrido.

¿Debe informar del problema al desarrollador del plugin?

Sí, si puede identificar el plugin y el problema parece venir de él. Muchos desarrolladores dependen de los avisos para descubrir errores en las nuevas versiones.

Un aviso útil incluye:

• la versión del plugin y la versión que funcionaba antes, si la conoce
• sus versiones de WordPress y de PHP
• una descripción clara de lo que ocurre y de cómo reproducirlo
• el mensaje de error pertinente, sin información personal o sensible

Use el canal de soporte oficial, como el foro de soporte del plugin en WordPress.org o el sistema de soporte del propio desarrollador en el caso de los plugins premium.

No comparta datos de acceso, logs completos ni datos de clientes en un foro público. Si el desarrollador necesita acceder a su web, acuerden un método seguro y retire ese acceso cuando termine la investigación.

¿Mantener el plugin desactivado o buscar una alternativa?

Una vez que la web vuelve a funcionar, tiene que decidir qué hacer con el plugin.

Mantenerlo desactivado durante un tiempo breve puede ser razonable cuando:

• el desarrollador ha reconocido el problema y se espera una corrección
• la función que ofrece no es imprescindible durante unos días
• puede arreglárselas sin la función que falta

Buscar una alternativa puede ser mejor cuando:

• el plugin lleva mucho tiempo sin actualizarse
• el desarrollador no responde a las solicitudes de soporte
• el mismo plugin ha causado problemas más de una vez
• duplica funciones que ya ofrece otro plugin o el tema

Sustituir un plugin no siempre es sencillo. Puede que haya que migrar ajustes, contenidos, shortcodes y datos, y el nuevo plugin debe probarse antes de ponerlo en producción. Planifique la sustitución en lugar de hacerla bajo presión.

Si el problema es un conflicto entre dos plugins, la solución puede ser un cambio de configuración en lugar de eliminar uno de ellos.

¿Cuándo debe pedir soporte técnico?

Se recomienda pedir soporte técnico cuando:

• no se puede acceder a toda la web o al escritorio
• el problema afecta al checkout, a los pagos o a las suscripciones
• no puede identificar qué plugin está implicado
• el problema vuelve después de una solución temporal
• el plugin implicado gestiona la seguridad, los usuarios o los pagos
• hay código a medida que depende del plugin
• sospecha un problema de compatibilidad con PHP
• no tiene un backup reciente y verificado
• no se siente cómodo trabajando con archivos o con el panel del hosting

No necesita diagnosticar el problema antes de pedir ayuda. Basta con explicar qué ha cambiado y qué ha dejado de funcionar para empezar.

¿Qué información debe reunir?

Resultan útiles los siguientes datos:

• la URL de la web
• el nombre del plugin sospechoso y, si la conoce, su versión
• qué cambió justo antes de que empezara el problema
• la hora aproximada en que empezó el problema
• capturas de pantalla de cualquier mensaje de error
• cualquier email recibido de WordPress
• qué páginas o funciones están afectadas
• si se puede acceder al escritorio
• lo que ya ha probado, en orden
• si dispone de un backup reciente

No se preocupe si no puede reunirlo todo. D4Hub puede ayudarle a entender qué información o accesos adicionales hacen falta. No envíe contraseñas por email normal.

Cómo puede ayudarle D4Hub

El objetivo no es solo que la web vuelva a cargar, sino entender por qué falló el plugin y asegurarse de que la solución no rompa otra cosa.

Según la situación, D4Hub puede ayudarle a:

• identificar el plugin, el tema o el código a medida implicado
• distinguir un conflicto entre plugins de una actualización defectuosa o de una incompatibilidad con PHP
• revisar los logs de errores y los emails de recuperación
• desactivar el plugin o volver a una versión anterior con seguridad
• probar los conflictos en una copia de staging en lugar de en la web en producción
• revisar los formularios, el checkout, el acceso y otras funciones clave después de la corrección
• informar del problema al desarrollador del plugin con los datos técnicos adecuados
• valorar y configurar un plugin alternativo
• reducir los plugins que se solapan para disminuir el riesgo de conflictos futuros

Puede solicitar ayuda en cualquier momento. D4Hub puede guiarle en una comprobación sencilla, confirmar si una acción es segura, hacerse cargo cuando no se puede acceder al escritorio o revisar la web después de una solución temporal.

wp plugin list --status=active

wp --info

wp plugin list --skip-plugins

wp plugin list --skip-plugins=plugin-slug

wp plugin deactivate plugin-slug

wp plugin activate plugin-slug

Preguntas frecuentes

¿Desactivar un plugin borra sus datos?

Normalmente no. Desactivar un plugin impide que se ejecute su código, mientras que sus ajustes suelen permanecer en la base de datos.

Borrar un plugin es distinto: algunos plugins eliminan sus datos cuando se borran. Por eso desactivar es el primer paso más seguro.

La web vuelve a funcionar después de desactivar un plugin. ¿Está resuelto el problema?

No necesariamente. La función que ofrecía ese plugin ya no está disponible, y la causa de fondo puede seguir ahí.

Pruebe los formularios, el checkout, el acceso y otras funciones clave, y después decida si esperar una corrección, volver a una versión anterior o buscar una alternativa.

¿Por qué el plugin funcionó durante meses y de repente se rompió?

Probablemente cambió algo a su alrededor: una actualización de WordPress, de otro plugin, del tema o de la versión de PHP del servidor. Puede que el plugin no haya cambiado en absoluto.

¿La culpa es del plugin que aparece en el mensaje de error?

No siempre. El error muestra dónde se hizo visible el problema. En un conflicto, la causa real puede ser otro plugin o el tema.

¿Puedo usar el modo de resolución de problemas de Health Check en una web en producción?

Por lo general sí, porque solo afecta al administrador conectado que lo activa. Los visitantes siguen viendo la web normal. Aun así, haga antes un backup y desactive el modo de resolución de problemas cuando termine.

¿Debo evitar actualizar los plugins en el futuro?

No. Las actualizaciones suelen incluir correcciones de seguridad, y saltárselas crea otros riesgos. Es más seguro actualizar con un backup reciente, probar a ser posible las actualizaciones importantes antes en una copia de staging y revisar la web después de cada actualización.

¿Puede ayudarme D4Hub si ya he intentado arreglarlo?

Sí. Explique qué plugins ha desactivado, actualizado o eliminado, y en qué orden. Esto ayuda a reconstruir lo ocurrido y a identificar el siguiente paso seguro.