Cómo solucionar errores comunes con temas en WordPress

Los errores en temas de WordPress pueden deberse a incompatibilidades, configuraciones incorrectas o problemas con actualizaciones.

Te explicamos cómo solucionar los errores más comunes paso a paso.

1. Error de pantalla en blanco (White Screen of Death - WSOD)

Causa: Puede deberse a conflictos con plugins, errores en el tema o falta de memoria en PHP.

Solución:

1. Activa el modo debug de WordPress

   • Edita el archivo wp-config.php y añade:

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

   • Luego, revisa el archivo wp-content/debug.log para ver qué está causando el error.

2. Cambia a un tema predeterminado

   • Accede a Apariencia > Temas y activa un tema por defecto de WordPress, como Twenty Twenty-Four.
   • Si no puedes acceder al panel, cambia el tema manualmente desde la base de datos o FTP:
     • Conéctate a phpMyAdmin, entra en la tabla wp_options, busca template y stylesheet, y cambia sus valores a twentytwentyfour.

3. Aumenta el límite de memoria PHP

   • Agrega esta línea en wp-config.php:

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

   • También puedes modificarlo desde el archivo php.ini o .htaccess.

2. Error “Stylesheet is Missing” (Falta la hoja de estilos del tema)

Causa: Ocurre cuando subes un tema incorrectamente o falta el archivo style.css.

Solución:

1. Verifica la estructura de la carpeta del tema

   • La ruta correcta debe ser:

     wp-content/themes/tu-tema/style.css
     

   • Si subiste un archivo ZIP, asegúrate de extraerlo correctamente y que dentro de la carpeta del tema esté el style.css.

2. Sube el tema manualmente vía FTP

   • Conéctate al servidor con FTP y súbelo a wp-content/themes/.

3. Error “El tema está roto” o “El tema carece de una hoja de estilos”

Causa: Puede ser que el tema esté incompleto o dañado.

Solución:

1. Reinstala el tema

   • Descarga el tema desde su fuente oficial y vuelve a subirlo.

2. Revisa el archivo style.css

   • Abre wp-content/themes/tu-tema/style.css y asegúrate de que contiene información del tema como esta:

     /*
     Theme Name: Nombre del Tema
     Theme URI: http://example.com
     Author: Autor del Tema
     */
     

4. Error tras actualizar el tema

Causa: La actualización puede haber cambiado archivos importantes o generado incompatibilidades con plugins.

Solución:

1. Restaura una versión anterior del tema

   • Si tienes una copia de seguridad, restáurala.
   • También puedes descargar una versión anterior del tema e instalarla manualmente.

2. Habilita el modo de depuración

   • Sigue los pasos del Error 1 para activar WP_DEBUG y ver detalles del problema.

3. Revisa el archivo functions.php

   • A veces, una función personalizada en functions.php puede estar generando el error.
   • Intenta desactivarlas temporalmente comentando las líneas de código problemáticas con //.

5. Cambios en el tema no se reflejan en el sitio

Causa: Puede ser por caché, permisos incorrectos o problemas en la hoja de estilos.

Solución:

1. Borra la caché

   • Si usas un plugin de caché como WP Rocket o W3 Total Cache, vacía la caché.
   • También borra la caché del navegador (Ctrl + Shift + R en Windows o Cmd + Shift + R en Mac).

2. Verifica los permisos de archivos

   • Accede vía FTP y asegúrate de que los archivos del tema tengan permisos 644 y las carpetas 755.

3. Revisa la hoja de estilos CSS

   • Asegúrate de que style.css no tenga errores y prueba añadiendo !important en los estilos que no se aplican.

6. Error “No se puede personalizar el tema” en el personalizador

Causa: Puede ser un conflicto con un plugin o un error de JavaScript.

Solución:

1. Desactiva los plugins

   • Ve a Plugins > Plugins instalados y desactívalos uno por uno para identificar el que causa el problema.

2. Revisa la consola de errores en el navegador

   • En Google Chrome, presiona F12, ve a la pestaña Consola y revisa si hay errores de JavaScript.

3. Activa el modo de depuración en el personalizador

   • Agrega esto en wp-config.php:

     define('SCRIPT_DEBUG', true);
     

7. Problemas con la imagen de cabecera o fondo

Causa: Puede deberse a un problema de permisos o una configuración incorrecta en el personalizador.

Solución:

1. Verifica los permisos de la carpeta uploads

   • Asegúrate de que wp-content/uploads/ tenga permisos 755 y que los archivos tengan 644.

2. Sube la imagen manualmente

   • Accede a Medios > Biblioteca, sube la imagen y usa su URL en el personalizador del tema.

8. Error 500 después de instalar un tema

Causa: Generalmente es un conflicto con un plugin o falta de memoria en PHP.

Solución:

1. Desactiva todos los plugins

   • Accede por FTP a wp-content/plugins/ y cambia el nombre de la carpeta de cada plugin para desactivarlos.

2. Aumenta la memoria de PHP

   • Sigue los pasos mencionados en el Error 1 para aumentar la memoria.

3. Revisa el archivo .htaccess

   • Accede por FTP y renómbralo a .htaccess_old para regenerarlo automáticamente.

Si tienes problemas con tu tema en WordPress, sigue estos pasos y revisa cada posible causa. Siempre haz una copia de seguridad antes de modificar archivos o hacer cambios importantes.

Si el problema persiste, prueba con otro tema y revisa la documentación del desarrollador (autor) o foros de soporte del tema.

¡Esperamos que esta guía te ayude a solucionar cualquier error con temas en WordPress!