Solución de problemas comunes en WordPress con cPanel

¿Tu sitio web en WordPress ha dejado de funcionar y no sabes por dónde empezar? No te preocupes, es más común de lo que crees. La mayoría de los problemas tienen solución desde el propio panel de control de tu hosting, ya sea cPanel o Syspanel (anteriormente conocido como HestiaCP). En esta guía extensa y detallada, te explicaré paso a paso cómo solucionar los errores más frecuentes en WordPress utilizando las herramientas que te ofrece tu panel de hosting. Al final, serás capaz de diagnosticar y resolver muchos problemas por ti mismo, ahorrando tiempo y evitando dolores de cabeza.

¿Por qué ocurren los errores en WordPress?

WordPress es un gestor de contenidos muy potente, pero también es sensible a ciertos factores. Los errores más comunes suelen deberse a:

Conflictos entre plugins o temas: Al actualizar o instalar algo nuevo, puede generar incompatibilidades.
Problemas de memoria (PHP Memory Limit): Cuando un script consume más memoria de la permitida.
Base de datos dañada: Por cortes de energía, migraciones fallidas o plugins defectuosos.
Archivos corruptos del núcleo de WordPress: Tras una actualización interrumpida o un ataque.
Permisos de archivos incorrectos: Que impiden que WordPress lea o escriba en el servidor.
Configuración de DNS o servidor web mal hecha.

La buena noticia es que, desde tu panel de control (cPanel o Syspanel), puedes acceder a herramientas clave para solucionar casi todos estos escenarios.

Primeros pasos: Accede a tu panel de hosting

Antes de empezar a solucionar problemas, necesitas acceder a tu panel de control. Aquí te explico cómo hacerlo en los dos entornos más comunes:

Acceder a cPanel

Abre tu navegador y escribe la URL de acceso. Normalmente es algo como: https://tudominio.com/cpanel o https://tudominio.com:2083.
Introduce tu nombre de usuario y contraseña de cPanel. Estos datos los recibiste al contratar tu hosting.
Una vez dentro, verás un escritorio con muchos iconos. No te asustes, solo necesitaremos unos pocos.

Acceder a Syspanel (antes HestiaCP)

Si tu hosting utiliza Syspanel, el proceso es ligeramente diferente:

Abre tu navegador y escribe la URL: https://tudominio.com:2106 (recuerda, el puerto es el 2106).
Introduce tu usuario y contraseña de Syspanel.
La interfaz es más minimalista. Busca el apartado de "Web" o "WordPress" para acceder a las herramientas de gestión.

## Solucionar el error "Error de conexión a la base de datos"

Este es uno de los errores más temidos. Aparece una pantalla blanca con el mensaje: "Error establishing a database connection". Las causas pueden ser varias, pero las más comunes son:

Contraseña de la base de datos incorrecta.
Base de datos caída o corrupta.
Servidor MySQL sobrecargado.

### Paso 1: Verifica las credenciales en wp-config.php

El archivo wp-config.php contiene los datos de conexión a tu base de datos. Si se han modificado accidentalmente, WordPress no podrá conectar.

Desde cPanel, busca la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta donde tienes instalado WordPress (normalmente public_html).
Busca el archivo wp-config.php. Haz clic derecho sobre él y selecciona "Editar".

Busca las siguientes líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Importante: Asegúrate de que el nombre de la base de datos, el usuario y la contraseña sean exactamente los mismos que aparecen en tu panel de cPanel (en la sección "Bases de datos MySQL"). El host casi siempre es localhost.
Si todo está correcto, pasa al siguiente paso.

### Paso 2: Reparar la base de datos desde cPanel

A veces la base de datos se corrompe parcialmente. cPanel tiene una herramienta para repararla.

Vuelve al escritorio de cPanel.
Busca la sección "Bases de datos" y haz clic en "phpMyAdmin".
En la ventana que se abre, selecciona tu base de datos en el menú de la izquierda.
Verás una lista de tablas. Marca la casilla de "Seleccionar todo" en la parte inferior de la lista.
En el menú desplegable que dice "Con seleccionadas:", elige la opción "Reparar tabla".
phpMyAdmin ejecutará un comando REPAIR TABLE. Si todo sale bien, verás un mensaje de éxito. Luego, vuelve a tu web y recarga.

## Solucionar el "Error 500 – Internal Server Error"

Este error es muy genérico y puede deberse a muchas causas: un plugin conflictivo, un archivo .htaccess dañado o incluso un tema defectuoso. Vamos a atajarlo por partes.

### Paso 1: Aumenta el límite de memoria PHP

A menudo, un error 500 se debe a que un script se queda sin memoria. Desde cPanel puedes aumentarlo fácilmente.

En cPanel, busca la sección "Software" y haz clic en "Seleccionar versión de PHP".
Se abrirá una nueva ventana. Haz clic en la pestaña "Opciones" (o "Switch to PHP Options").
Busca la opción memory_limit. Por defecto suele estar en 128M o 256M. Cámbiala a 512M o incluso 1024M si tu plan lo permite.
Haz clic en "Apply" (Aplicar) y espera unos segundos. Luego recarga tu web.

### Paso 2: Restaura un archivo .htaccess de respaldo

Un .htaccess corrupto es otra causa común.

Ve al "Administrador de archivos" de cPanel.
Localiza el archivo .htaccess en la raíz de tu WordPress (carpeta public_html).
No lo borres aún. Primero, haz clic derecho sobre él y selecciona "Cambiar nombre". Ponle _old.htaccess (por ejemplo, _old.htaccess).
Ahora, crea un archivo nuevo. Haz clic en "+ Archivo", nómbralo .htaccess y guárdalo.

Edita este nuevo archivo y pega el siguiente contenido:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Guarda los cambios. Si tu web vuelve a funcionar, el problema era el .htaccess anterior. Luego puedes regenerar los enlaces permanentes desde Ajustes > Enlaces permanentes en tu WordPress.

### Paso 3: Desactiva todos los plugins (vía FTP o cPanel)

Si el error persiste, probablemente sea un plugin conflictivo. Como no puedes acceder al panel de administración, lo desactivaremos manualmente.

En el "Administrador de archivos", navega a public_html/wp-content/plugins/.
Verás una lista de carpetas, una por cada plugin instalado.
No borres las carpetas. Simplemente, renombra la carpeta del plugin que sospechas que causa el problema. Por ejemplo, si tienes un plugin llamado "mi-plugin", renómbralo a mi-plugin-desactivado.
Si no sabes cuál es, renombra todas las carpetas de plugins añadiéndoles un guion bajo al inicio (por ejemplo, _akismet, _contact-form-7, etc.).
Recarga tu web. Si funciona, el problema está en uno de los plugins. Ve renombrándolos uno a uno (quitando el guion bajo) para identificar al culpable. Una vez identificado, puedes eliminarlo o contactar al desarrollador.

## Solucionar el "Error de actualización fallida" o "Error al descomprimir el paquete"

A veces, al intentar actualizar WordPress, un plugin o un tema, aparece un error como "Error al descomprimir el paquete" o "No se pudo crear el directorio". Esto suele deberse a permisos de archivos incorrectos.

### Paso 1: Verifica los permisos de las carpetas y archivos

WordPress necesita permisos específicos para leer y escribir archivos. Desde cPanel:

Ve al "Administrador de archivos".
Navega a la raíz de tu WordPress (public_html).
Haz clic derecho sobre la carpeta wp-content y selecciona "Cambiar permisos".
Asegúrate de que esté configurada con 755 (o 750 en algunos servidores seguros). Marca la casilla "Recursivo" para aplicar a todas las subcarpetas.
Haz lo mismo con la carpeta wp-admin y wp-includes, también con permisos 755.
Para los archivos individuales (como wp-config.php), el permiso correcto suele ser 644.
Si después de esto el error persiste, es posible que el dueño del archivo no sea el usuario del servidor web. En ese caso, ponte en contacto con tu soporte de hosting.

### Paso 2: Libera espacio en disco

A veces el error aparece simplemente porque no hay espacio libre en el servidor.

Desde cPanel, busca la sección "Métricas" y haz clic en "Uso de disco".
Revisa cuánto espacio estás utilizando. Si estás cerca del límite, borra archivos temporales, copias de seguridad antiguas o contenido multimedia que no uses.
También puedes instalar un plugin como "WP-Optimize" para limpiar la base de datos y archivos innecesarios.

## Solucionar el "Error de SSL" o "Contenido mixto"

Si has instalado un certificado SSL pero tu web sigue mostrando "No seguro" o ves un candado roto, es porque hay contenido mixto (HTTP y HTTPS).

### Paso 1: Forzar HTTPS desde cPanel

En cPanel, busca la sección "Dominios" y haz clic en "SSL/TLS".
Luego, en "Forzar HTTPS" (o "Force HTTPS Redirect"), activa la opción para tu dominio principal.
Esto añadirá una regla en el .htaccess para redirigir todo el tráfico HTTP a HTTPS.

### Paso 2: Actualiza la URL del sitio en WordPress

A veces WordPress guarda la URL del sitio con HTTP en la base de datos.

Ve a phpMyAdmin desde cPanel.
Selecciona tu base de datos.
Busca la tabla wp_options (el prefijo puede variar, por ejemplo tu_prefijo_options).
Localiza las filas con option_name = siteurl y home. Edítalas y cambia http:// por https://.
Guarda los cambios. Luego, desde el panel de WordPress, ve a Ajustes > Generales y verifica que ambas URLs comiencen con https://.

## Solucionar el problema de "No se puede conectar al servidor FTP" al instalar plugins

Si al intentar instalar un plugin desde el panel de WordPress te pide credenciales FTP, es porque el servidor web no tiene permisos de escritura directa.

### Paso 1: Añade la constante FS_METHOD en wp-config.php

Edita el archivo wp-config.php como vimos antes.
Justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, añade la siguiente línea:
```
define('FS_METHOD', 'direct');
```
Guarda el archivo. Esto le dice a WordPress que use el sistema de archivos directo, evitando la petición FTP.
Si después de esto sigues teniendo problemas, verifica que los permisos de la carpeta wp-content y sus subcarpetas sean correctos (paso descrito anteriormente).

## Solucionar el "Error de memoria agotada" (Allowed memory size exhausted)

Este error suele aparecer como una línea larga en la pantalla: "Fatal error: Allowed memory size of 134217728 bytes exhausted".

### Paso 1: Aumenta el límite de memoria PHP (ya lo vimos)

Repite el Paso 1 de la sección del Error 500. Aumenta memory_limit a 512M o 1024M.

### Paso 2: Añade la constante WP_MEMORY_LIMIT

Si el cambio desde cPanel no es suficiente, puedes forzar un límite aún mayor desde el propio WordPress.

Edita wp-config.php.
Añade la siguiente línea justo antes del cierre:
```
define('WP_MEMORY_LIMIT', '512M');
```
Guarda el archivo. Esto establece un límite de 512 MB solo para WordPress.

## Solucionar el error "El enlace que has seguido ha caducado" al subir archivos grandes

Este error es muy común al intentar subir temas, plugins o imágenes de gran tamaño. Se debe a que el servidor tiene un límite de tiempo de ejecución o de tamaño de archivo muy bajo.

### Paso 1: Aumenta los límites de subida desde cPanel

Ve a "Seleccionar versión de PHP" (en la sección Software).
Busca las opciones:
- upload_max_filesize: (por ejemplo, cámbialo a 64M o 128M).
- post_max_size: (debe ser igual o mayor que upload_max_filesize, por ejemplo 128M).
- max_execution_time: (aumenta a 300 segundos).
Aplica los cambios.

### Paso 2: Sube archivos vía FTP o cPanel

Si el error persiste, usa el "Administrador de archivos" de cPanel para subir el archivo directamente a la carpeta correcta (por ejemplo, wp-content/plugins/ para un plugin, o wp-content/uploads/ para imágenes). Luego, desde el panel de WordPress, actívalo o insértalo manualmente.

## Solucionar el problema de "Página en blanco" (White Screen of Death)

Este es uno de los errores más frustrantes porque no ves ningún mensaje. La pantalla se queda completamente en blanco.

### Paso 1: Activa el modo de depuración (WP_DEBUG)

Edita wp-config.php.
Busca la línea que dice define('WP_DEBUG', false); (si no existe, la añades).

Cámbiala a:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Guarda el archivo. Ahora, WordPress escribirá los errores en un archivo llamado debug.log dentro de la carpeta wp-content.
Accede a ese archivo desde el "Administrador de archivos" de cPanel (ruta: public_html/wp-content/debug.log). Ábrelo y lee el mensaje de error. Te dirá exactamente qué archivo o plugin está causando el problema.
Una vez solucionado, no olvides desactivar el modo debug volviendo a poner false en las líneas, para que tu web no muestre información sensible a los visitantes.

### Paso 2: Desactiva el tema actual (vía cPanel)

Si el