Syntax error WordPress: cómo solucionar un error de sintaxis

Acabas de pegar un fragmento de código en WordPress, actualizar un tema, tocar un plugin o editar el archivo functions.php. Recargas la web y aparece un mensaje que asusta bastante: syntax error, parse error, unexpected token o algo parecido.

En ese momento la web puede dejar de cargar, el panel de administración puede quedar bloqueado y el mensaje suele enseñar una ruta de archivo con una línea concreta. La buena noticia es que, muchas veces, este error tiene una causa bastante clara: hay un fallo de sintaxis en algún archivo PHP.

La mala noticia es que si no sabes dónde tocar, puedes empeorarlo. Por eso conviene actuar con orden: localizar el archivo, revisar la línea del error, deshacer el último cambio y recuperar la web sin borrar cosas al azar.

Qué es un syntax error en WordPress

Un syntax error es un error de sintaxis. En lenguaje sencillo: hay una parte del código PHP que WordPress no puede interpretar porque está mal escrita, incompleta o colocada donde no toca.

Puede ser algo tan pequeño como una coma, una llave, un paréntesis, una comilla o un punto y coma. Pero aunque el fallo sea pequeño, puede dejar la web completamente caída.

Algunos mensajes habituales son:

• Parse error: syntax error.
• Unexpected token.
• Unexpected end of file.
• Unclosed {.
• Unexpected ‘<‘.
• Fatal error.

Por qué aparece un error de sintaxis en WordPress

Este error suele aparecer después de tocar código. A veces ocurre al pegar un snippet en functions.php, editar un plugin, cambiar una plantilla, actualizar un tema o copiar código desde una web externa.

Causa habitual	Qué suele pasar
Código pegado en functions.php	Falta una llave, punto y coma, comilla o el fragmento no está completo.
Edición de un plugin	Se modifica un archivo PHP del plugin y queda un error de sintaxis.
Edición del tema	Una plantilla o archivo del tema queda mal cerrado o con código incompatible.
Actualización fallida	Un archivo se queda incompleto o se mezcla código antiguo con nuevo.
Código copiado de internet	El fragmento no está adaptado, tiene caracteres raros o se pega en el sitio incorrecto.
Versión PHP incompatible	El código usa sintaxis no compatible con la versión PHP del servidor.

La pista más importante casi siempre está en el propio mensaje de error. WordPress suele indicar la ruta del archivo y el número de línea donde se ha detectado el problema.

Diferencia entre syntax error, parse error y error crítico

Estos errores están relacionados, pero no siempre significan exactamente lo mismo.

Mensaje	Qué indica	Qué hacer
Syntax error	Hay un problema de sintaxis en el código PHP.	Revisar archivo y línea indicados.
Parse error	PHP no puede interpretar correctamente el archivo.	Buscar comillas, llaves, paréntesis o código incompleto.
Unexpected token	PHP encuentra un carácter o elemento que no esperaba.	Revisar el fragmento justo antes de la línea indicada.
Error crítico	WordPress detecta un fallo grave y puede bloquear la web.	Revisar email de recuperación o desactivar plugin/tema.

Si el mensaje muestra una ruta concreta, esa ruta es tu punto de partida. No empieces desactivando todo si el error ya te está diciendo dónde mirar.

Paso 1: lee bien el mensaje de error

Un mensaje de syntax error puede parecer muy técnico, pero suele contener tres datos clave:

• Tipo de error.
• Archivo afectado.
• Línea aproximada del problema.

Un ejemplo podría ser:

Parse error: syntax error, unexpected token "}" in /home/usuario/public_html/wp-content/themes/tema/functions.php on line 128

Esto nos dice que el problema está en el archivo:

wp-content/themes/tema/functions.php

Y que WordPress lo detecta cerca de la línea 128.

Paso 2: entra por FTP, Plesk o cPanel

Si el error te impide entrar al panel de WordPress, tendrás que acceder a los archivos desde fuera.

Las opciones más habituales son:

• FTP o SFTP.
• Administrador de archivos del hosting.
• Plesk.
• cPanel.
• SSH, si tienes experiencia técnica.

Una vez dentro, busca la ruta que aparece en el mensaje de error. Por ejemplo:

wp-content/themes/tema/functions.php

Antes de editar nada, descarga una copia del archivo original. Así podrás volver atrás si algo sale mal.

Paso 3: corrige o elimina el último código añadido

Si sabes qué fragmento pegaste antes de que apareciera el error, empieza por ahí. Muchas veces basta con eliminar ese último bloque y guardar el archivo.

Errores típicos al pegar código en WordPress:

• Falta un punto y coma al final de una línea.
• Hay una llave de apertura sin cierre.
• Hay una comilla sin cerrar.
• Se ha pegado código PHP dentro de otro bloque PHP de forma incorrecta.
• Se ha copiado también la etiqueta <?php donde no tocaba.
• El fragmento está incompleto.
• El código usa comillas “raras” copiadas desde un editor visual.

Después de corregir, guarda el archivo y recarga la web.

Error en functions.php

El archivo functions.php es uno de los lugares donde más errores de sintaxis se producen en WordPress. Se usa mucho para añadir pequeños fragmentos de código, pero también es muy fácil romper la web si se pega algo mal.

Si el error está en functions.php, normalmente puedes corregirlo entrando en:

wp-content/themes/tu-tema/functions.php

O, si usas un tema hijo:

wp-content/themes/tu-tema-hijo/functions.php

Busca el último fragmento añadido y revisa si está completo.

Error por copiar código con <?php

Uno de los errores más comunes ocurre al copiar un fragmento que empieza por:

<?php

Si lo pegas dentro de un archivo PHP que ya estaba abierto, puedes provocar un error. En muchos casos, dentro de functions.php no necesitas volver a añadir esa etiqueta si el archivo ya la tiene al principio.

Por ejemplo, esto puede romper la web si se pega en el sitio equivocado:

<?php
function mi_funcion_personalizada() {
  // código
}

La solución puede ser eliminar la etiqueta <?php del fragmento, siempre que estés pegándolo dentro de un bloque PHP ya abierto.

Error por llaves, paréntesis o comillas sin cerrar

Otro caso muy habitual es dejar algo sin cerrar. En PHP, una llave, paréntesis o comilla mal colocada puede provocar un parse error.

Ejemplos típicos:

function ejemplo_error() {
  echo 'Hola mundo';

Aquí falta cerrar la llave final:

}

Otro ejemplo:

echo 'Texto sin cerrar;

Falta la comilla de cierre.

Cuando veas un error de tipo unexpected end of file, muchas veces significa que falta cerrar algo antes del final del archivo.

Error después de editar un plugin

Editar directamente archivos de plugins no suele ser buena idea. Cuando el plugin se actualice, perderás los cambios. Y si cometes un error, puedes dejar la web rota.

Si el mensaje apunta a una carpeta como:

wp-content/plugins/nombre-del-plugin/archivo.php

puedes recuperar la web desactivando ese plugin temporalmente.

Para hacerlo sin entrar al panel:

1. Entra por FTP, Plesk o cPanel.
2. Abre wp-content/plugins.
3. Busca la carpeta del plugin afectado.
4. Renómbrala, por ejemplo: plugin-desactivado.
5. Recarga la web.

Si la web vuelve a cargar, el problema está en ese plugin o en el cambio realizado dentro de él.

Error después de editar un tema

Si el error apunta a un archivo del tema, como functions.php, header.php, footer.php o una plantilla personalizada, revisa el último cambio realizado.

Si no puedes encontrar el fallo y la web está caída, puedes renombrar temporalmente la carpeta del tema activo para obligar a WordPress a cargar otro tema disponible.

La ruta suele ser:

wp-content/themes/nombre-del-tema

Esto puede ayudarte a recuperar acceso, pero no siempre es la mejor solución definitiva. Si la web depende de ese tema, habrá que corregir el archivo afectado.

Qué hacer si no puedes entrar a wp-admin

Cuando hay un syntax error, es bastante normal no poder entrar al panel de WordPress. En ese caso, no insistas desde el navegador. Entra por archivos.

Orden recomendado:

1. Lee el mensaje de error y apunta archivo y línea.
2. Accede por FTP, Plesk o cPanel.
3. Descarga copia del archivo afectado.
4. Elimina o corrige el último cambio.
5. Guarda el archivo.
6. Recarga la web.
7. Si vuelve, entra al panel y revisa que todo funcione.

Si el error no muestra archivo ni línea, puede ser necesario activar depuración o revisar logs del servidor.

Activar WP_DEBUG para ver mejor el error

Si la web muestra un error genérico o una pantalla en blanco, puedes activar la depuración en WordPress para obtener más información.

En el archivo wp-config.php, busca esta línea:

define('WP_DEBUG', false);

Y cámbiala temporalmente por:

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

Así WordPress puede guardar errores en:

wp-content/debug.log

Después revisa ese archivo para localizar el problema.

Revisar logs del servidor

Si WordPress no muestra el error con claridad, los logs del servidor pueden darte la pista. En Plesk, cPanel o el panel del hosting suele haber una sección de registros.

Busca errores recientes justo a la hora en la que se rompió la web.

Algunas pistas habituales:

• Parse error.
• Syntax error.
• Unexpected token.
• Fatal error.
• Ruta de un plugin.
• Ruta del tema activo.
• Número de línea.

Si el log menciona una ruta concreta, empieza por ahí. No hace falta desmontar toda la web si el servidor ya te está señalando el archivo afectado.

Cuándo restaurar una copia

Restaurar una copia puede ser útil si no sabes qué se tocó o si el archivo afectado quedó demasiado modificado. Pero conviene hacerlo con cuidado.

Restaurar puede tener sentido si:

• el error apareció justo después de tocar código;
• no sabes qué fragmento se añadió;
• no encuentras una versión limpia del archivo;
• la web no es una tienda online con datos recientes;
• tienes una copia completa y reciente;
• sabes qué perderías al restaurar.

En WooCommerce o webs con formularios importantes, restaurar sin revisar puede hacerte perder pedidos, contactos o datos recientes.

Qué no deberías hacer

Cuando una web se rompe por un error de sintaxis, es fácil ponerse nervioso. Pero hay varias cosas que conviene evitar.

• No borres plugins al azar.
• No elimines el tema completo sin copia.
• No pegues más código encima para “arreglar” sin entender el error.
• No edites wp-config.php si el error está en functions.php.
• No restaures una copia antigua sin revisar qué perderás.
• No cambies versión PHP a ciegas.
• No ignores la ruta y línea que muestra el mensaje.

Ejemplo práctico: web rota al pegar código en functions.php

Imagina que quieres añadir una función personalizada a WordPress. Copias un fragmento de una web, lo pegas al final de functions.php y al guardar aparece un error:

Parse error: syntax error, unexpected end of file in wp-content/themes/mi-tema/functions.php on line 245

En ese caso, el proceso lógico sería:

1. Entrar por FTP o administrador de archivos.
2. Abrir wp-content/themes/mi-tema/functions.php.
3. Descargar una copia del archivo.
4. Ir al final del archivo o cerca de la línea indicada.
5. Eliminar el último fragmento añadido.
6. Guardar y recargar la web.
7. Si la web vuelve, revisar el código antes de volver a intentarlo.

Muchas veces no hace falta más. El problema no era WordPress entero, sino un fragmento mal pegado.

Checklist para solucionar un syntax error en WordPress

Antes de dar el error por resuelto, revisa esta lista:

• ¿Has leído el mensaje completo?
• ¿Has localizado el archivo afectado?
• ¿Has apuntado la línea indicada?
• ¿Sabes qué cambio se hizo antes del error?
• ¿Has descargado copia del archivo antes de editar?
• ¿Has revisado llaves, paréntesis, comillas y punto y coma?
• ¿Has eliminado el último fragmento añadido si no estaba claro?
• ¿Has probado la web después de guardar?
• ¿Puedes entrar de nuevo a wp-admin?
• ¿Has desactivado WP_DEBUG si lo activaste?

Cuándo pedir ayuda para reparar un syntax error

Un error de sintaxis puede resolverse rápido si sabes qué archivo se ha tocado. Pero si no tienes claro qué ha pasado, mejor no seguir improvisando.

Pide ayuda si:

• no sabes acceder por FTP, Plesk o cPanel;
• el error no muestra una ruta clara;
• la web es una tienda online;
• has tocado varios archivos;
• el error aparece después de actualizar un tema o plugin;
• no tienes copia de seguridad;
• la web muestra varios errores encadenados;
• no sabes interpretar la línea del error.

Mantenimiento WordPress para evitar errores al tocar código

Muchos syntax error aparecen por hacer cambios rápidos directamente en producción. Un fragmento mal copiado, una edición desde el editor de temas o una modificación de plugin pueden dejar la web caída.

Un servicio de mantenimiento WordPress ayuda a trabajar con más seguridad: copias, actualizaciones controladas, revisión de errores y soporte cuando algo falla.

Si la web es importante para tu negocio, no conviene experimentar directamente sobre ella sin copia ni plan de vuelta atrás.

Qué deberías tener claro sobre los syntax error en WordPress

Un syntax error suele deberse a código PHP mal escrito, incompleto o pegado en el lugar incorrecto. Puede parecer grave porque tira la web, pero muchas veces se resuelve localizando el archivo afectado y deshaciendo el último cambio.

La clave es no actuar a ciegas. Lee el mensaje, busca la ruta, revisa la línea, descarga copia del archivo y corrige con calma.

Y si no sabes qué se ha tocado o la web es crítica, es mejor pedir ayuda antes de empeorar el problema.

Preguntas frecuentes sobre syntax error en WordPress

¿Qué es un syntax error en WordPress?

Es un error de sintaxis en el código, normalmente PHP. WordPress no puede interpretar correctamente un archivo porque falta una llave, comilla, paréntesis, punto y coma o hay código mal colocado.

¿Por qué aparece un parse error en WordPress?

Suele aparecer después de editar un archivo, pegar código en functions.php, modificar un plugin, tocar una plantilla o usar código incompatible con la versión PHP del servidor.

¿Cómo soluciono un syntax error en functions.php?

Entra por FTP, Plesk o cPanel, abre el archivo functions.php del tema activo, descarga una copia, localiza el último código añadido y corrige o elimina el fragmento que provoca el error.

¿Puedo arreglarlo desde el panel de WordPress?

Normalmente no, porque el error puede bloquear el acceso al panel. Lo habitual es corregirlo desde los archivos del servidor.

¿Qué significa unexpected token?

Significa que PHP ha encontrado un elemento que no esperaba: una llave, comilla, paréntesis, etiqueta o carácter colocado de forma incorrecta.

¿Debo desactivar plugins para solucionar un syntax error?

Solo si el mensaje indica que el error está dentro de un plugin o si no puedes localizar el origen. En ese caso puedes renombrar la carpeta del plugin desde FTP para desactivarlo.

¿Puede un tema causar un syntax error?

Sí. Un tema puede provocar este error si se ha editado mal un archivo, si la actualización quedó incompleta o si el código no es compatible con la versión PHP del servidor.

¿Qué hago si el mensaje no muestra la línea del error?

Puedes activar WP_DEBUG, revisar el archivo debug.log o consultar los logs del servidor para obtener más información sobre el archivo afectado.

¿Es seguro restaurar una copia?

Puede serlo si la copia es reciente y sabes qué perderás al restaurar. En tiendas online o webs con datos recientes, conviene revisar antes para no perder pedidos o formularios.

¿ideaWeb puede reparar un syntax error en WordPress?

Sí. Podemos revisar el archivo afectado, corregir el error de sintaxis, recuperar el acceso al panel y dejar WordPress funcionando correctamente.