Si estás viendo el error ‘jQuery is not defined’ en tu área de administración de WordPress (o en cualquier otro lugar), no te preocupes – no estás solo. Se trata de un problema habitual con el que se encuentran muchos usuarios de WordPress. Dicho esto, puede ser frustrante que tu sitio no funcione como esperabas.
Llevamos más de una década trabajando con WordPress y, durante ese tiempo, hemos aprendido a solucionar algunos de los errores más comunes de WordPress. Esto incluye el error ‘jQuery is not defined’.
En esta guía, explicaremos por qué se produce este error y, lo que es más importante, cómo solucionarlo. Explicaremos todo en términos sencillos, por lo que incluso si usted no es un desarrollador, usted será capaz de seguir y resolver el problema rápidamente.
¿Cuál es la causa del error “jQuery is not defined” (jQuery no está definido)?
jQuery es una librería JavaScript muy utilizada en WordPress que ayuda a ejecutar muchas funciones interactivas. Sin embargo, a veces, puede fallar al cargar correctamente, lo que podría afectar a la funcionalidad de su sitio web.
El error aparece en las herramientas para desarrolladores, en la pestaña Consola, por lo que muchos usuarios pueden no darse cuenta hasta que algo se rompe en su sitio.
Si ves el error ‘jQuery is not defined’, significa que WordPress está teniendo problemas para cargarlo correctamente. A lo largo de los años, hemos ayudado a innumerables usuarios a solucionar este problema y hemos aprendido que suele deberse a algunas causas comunes:
- Temas o plugins desactualizados: Muchos usuarios se encuentran con este error cuando sus temas o plugins no están actualizados a la última versión de WordPress. A menudo hemos visto que esto ocurre después de actualizaciones importantes de WordPress.
- Carga incorrecta de scripts: jQuery debe cargarse antes que otros archivos JavaScript. Si no lo está, los scripts que dependen de jQuery se romperán. Esto ocurre a menudo si los temas o plugins no están codificados correctamente para poner en cola los scripts.
- Conflictos de JavaScript: Otros scripts que se ejecutan en su sitio pueden entrar en conflicto con jQuery, especialmente si no se cargan correctamente. Este conflicto puede romper jQuery, causando el error.
- Fallos de CDN: Algunos sitios dependen de jQuery alojado en una red de distribución de contenidos (CDN). Si la CDN no está disponible o está bloqueada, el sitio no podrá cargar jQuery, lo que provocará el error.
Todos estos problemas pueden impedir que jQuery funcione correctamente. Pero no te preocupes – con nuestra experiencia, podemos guiarte a través de las soluciones para resolver el problema.
Cómo corregir el error “jQuery no está definido
Existen varias formas de solucionar este error cuando se encuentra con él. A continuación se presentan los métodos más eficaces que hemos utilizado para solucionar este problema.
Te recomendamos que pruebes estas estrategias en orden, pero puedes utilizar los enlaces que aparecen a continuación si quieres empezar por alguna en concreto:
Repasaremos cada uno de estos métodos y, a continuación, le proporcionaremos algunos recursos adicionales para solucionar los errores de WordPress. ¡Manos a la obra!
1. Actualizar WordPress, temas y plugins
El software desactualizado es una de las causas más comunes del error ‘jQuery is not defined’. Los temas o plugins obsoletos pueden no ser compatibles con la última versión de WordPress, lo que puede provocar conflictos de script. Para solucionarlo:
En primer lugar, asegúrese de que el núcleo de WordPress está actualizado. Vaya a Panel de control ” Actualizaciones y haga clic en “Actualizar a la versión X.X.X” si hay una actualización disponible.
Consulte nuestra guía completa sobre la actualización segura de WordPress a una nueva versión para obtener más información.
Las actualizaciones de sus plugins de WordPress aparecerán debajo de la actualización del núcleo.
Puede seleccionarlos todos y hacer clic en “Actualizar plugins”.
Por último, verá las actualizaciones de sus temas de WordPress.
Basta con seleccionarlos todos y hacer clic en “Actualizar temas”.
Si te preocupan los cambios que has realizado en tu tema, sigue nuestra guía sobre cómo actualizar tu tema de WordPress sin perder las personalizaciones.
2. Compruebe si jQuery está cargado correctamente
Antes de explorar soluciones más avanzadas, es importante comprobar si jQuery se está cargando realmente en su sitio. Este paso le ayuda a confirmar si jQuery está disponible y funciona como debería.
Sólo tienes que hacer clic con el botón derecho del ratón en cualquier parte de tu sitio de WordPress y seleccionar “Ver fuente de la página”.
Consejo: Como alternativa, puede pulsar Ctrl + U en Windows o Cmd + Opción + U en Mac para acceder a la fuente de la página.
Esto le mostrará el HTML y JavaScript sin procesar de su página.
A continuación, pulsa Ctrl + F (o Cmd + F en Mac) para abrir la barra de búsqueda y escribe “jquery.min.js”.
Si jQuery se ha cargado correctamente, debería ver una referencia a él en el código.
Otra forma de buscar jQuery es utilizar la herramienta de inspección de su navegador. Simplemente vaya a la pestaña ‘Red’ y vuelva a cargar la página.
Consejo: En un dispositivo Windows, puede acceder a la herramienta Inspeccionar pulsando F12 en el teclado. En Mac, pulsa Opciones + Cmd + I.
Filtra la actividad de la red escribiendo ‘jquery’ en la barra de búsqueda. Si jQuery está cargado, lo verás listado aquí.
Si no ves jQuery cargado en ninguno de los dos métodos, el problema puede ser cómo está en cola en WordPress. En los siguientes pasos, te guiaremos para solucionarlo.
3. Añadir un jQuery Fallback
A veces, un script en su sitio puede estar cargando jQuery usando un CDN que está teniendo problemas de conectividad. En ese caso, no se cargaría jQuery y se produciría el error.
Para solucionar el problema, puede añadir un jQuery fallback a su sitio WordPress. Esto garantiza que jQuery se cargue siempre.
Debes añadirlo a la sección head de tu sitio para asegurarte de que se carga primero. Sin embargo, no recomendamos editar los archivos del tema directamente. Hemos visto gente perder sus cambios al actualizar el tema y el código que añadieron.
La mejor manera de añadir código personalizado en WordPress es utilizar el plugin WPCode. Es un gestor de fragmentos de código que te permite añadir código personalizado de forma segura sin romper tu sitio.
En primer lugar, instale y active el plugin WPCode. Para más detalles, consulte nuestro tutorial sobre la instalación de un plugin de WordPress.
Nota: También existe una versión gratuita llamada WPCode Lite.
Una vez activado, vaya a Fragmentos de código ” + Añadir fragmento. A continuación, haga clic en el botón “Usar fragmento” situado debajo de “Añada su código personalizado (nuevo fragmento)”.
En el editor de código, dale a tu fragmento un nombre como ‘jQuery Fallback’.
A continuación, seleccione “Fragmento HTML” como “Tipo de código”.
A continuación, pegue el siguiente código en el cuadro “Vista previa del código”:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script>
window.jQuery || document.write('<script src="/wp-includes/js/jquery/jquery.js"><\/script>')
</script>
A continuación, desplácese hasta la sección “Inserción”.
Aquí, puedes decirle a WPCode dónde cargar este código. Asegúrate de seleccionar ‘Site Wide Header’.
Por último, haz clic en el botón “Guardar fragmento” de la parte superior para guardar tu código personalizado.
Después, no olvides activar el fragmento cambiando el conmutador a “Activo”.
4. Corrección: Orden de carga del script (Avanzado)
Otra razón común para el error ‘jQuery is not defined’ es que jQuery se carga después de otros scripts que dependen de él. Corregir el orden de carga de los scripts garantiza que jQuery se cargue siempre en primer lugar, evitando conflictos.
Si sabe qué script depende de jQuery, puede ponerlo en cola correctamente añadiendo jQuery como dependencia.
Si el error ‘jQuery is not defined’ es causado porque jQuery se carga después de otros scripts que dependen de él, puedes arreglar el orden de carga de los scripts usando WPCode.
En primer lugar, instala y activa el plugin WPCode, o elige la versión gratuita llamada WPCode Lite.
Una vez activado, vaya a Fragmentos de código ” + Añadir fragmento y haga clic en el botón “Usar fragmento” situado debajo de “Añadir su código personalizado (nuevo fragmento)”.
En el editor de código, dé a su fragmento un nombre como ‘Fix Script Loading Order’ y seleccione ‘PHP snippet’ como tipo de código.
A continuación, añada el siguiente código para asegurarse de que jQuery está en cola como dependencia para cualquier script personalizado:
wp_enqueue_script( 'your-script-handle', get_template_directory_uri() . '/js/your-script.js', array( 'jquery' ), null, true );
No olvides sustituir ‘your-script-handle’ por un nombre significativo para identificar el script. Y sustituye ‘/js/tu-script.js’ por el nombre real del archivo de script en la carpeta /js/ de tu tema.
La parte array('jquery') en el código asegura que jQuery se carga primero.
Una vez que haya añadido el código, desplácese hacia abajo hasta las opciones de “Inserción” y seleccione “Encabezado de todo el sitio” para asegurarse de que el script se carga en la parte correcta del HTML de su sitio.
Por último, haz clic en el botón “Guardar fragmento” de la parte superior para guardar tu código personalizado.
Después, no olvides activar el fragmento cambiando el conmutador a “Activo”.
El uso de WPCode para poner en cola correctamente los scripts asegura que jQuery se carga en el orden correcto. Si esa era la raíz del problema, esto debería resolver el error.
5. Editar wp-config.php para solucionar problemas de carga de jQuery
Si los otros métodos no han funcionado, editar el archivo wp-config.php puede ayudar a controlar cómo WordPress gestiona la carga de scripts.
Este método es útil si la concatenación de scripts o problemas de ruta de archivos están causando el error ‘jQuery is not defined’.
A continuación se explica cómo aplicar este método:
En primer lugar, acceda a su archivo wp-config.php. Puedes hacerlo utilizando un cliente FTP como FileZilla o accediendo al gestor de archivos de tu panel de control de hosting.
El archivo wp-config.php se encuentra en el directorio raíz de su instalación de WordPress (normalmente en la carpeta public_html ).
Una vez localizado el archivo, ábrelo para editarlo y añade el siguiente código justo antes de la línea que dice /* ¡Eso es todo, deja de editar! Feliz blogueo. */:
/** Absolute path to the WordPress directory. */
if ( !defined('ABSPATH') )
define('ABSPATH', dirname(FILE) . '/');
define('CONCATENATE_SCRIPTS', false);
Esto es lo que hace este código:
- La definición
ABSPATHasegura que WordPress conoce la ruta correcta a sus archivos principales, lo que puede evitar problemas de carga de jQuery. - La línea
CONCATENATE_SCRIPTSdesactiva la concatenación de scripts. Esto fuerza a WordPress a cargar cada script por separado, evitando los conflictos que surgen cuando los scripts se fusionan.
Después de añadir este código, guarde los cambios y vuelva a cargar su sitio para ver si el error se ha resuelto.
Desactivar la concatenación de scripts puede ser una solución simple pero efectiva para los problemas de jQuery, especialmente cuando otros métodos no funcionan.
6. Obtenga Asistencia Premium para Corregir el Error por Usted
Si ninguno de los métodos anteriores funciona o simplemente prefiere que un experto eche un vistazo a su problema, entonces debería considerar utilizar nuestros servicios de Asistencia Premium WordPress.
Por una pequeña tarifa única, puede contratar a nuestros ingenieros de WordPress altamente cualificados y profesionales para que solucionen el error por usted.
Al elegir nuestros servicios de emergencia, no tendrá que lidiar con la molestia de intentar solucionar el error ‘jQuery is not defined’ por su cuenta.
De este modo, el tiempo de inactividad de su sitio web será mínimo y podrá reanudar sus operaciones comerciales en línea lo antes posible.
Además, nuestros servicios de emergencia no le obligan a firmar un contrato, por lo que pueden ser una gran opción si no está interesado en un plan de mantenimiento completo.
Dicho esto, ofrecemos Servicios de Mantenimiento más completos si desea adoptar un enfoque más proactivo y reducir el riesgo de emergencias del sitio web en el futuro.
Recursos adicionales: Solución de errores de WordPress
Si los pasos anteriores no le ayudan o desea seguir leyendo, los siguientes recursos pueden ser buenos puntos de partida:
- Guía para principiantes sobre la solución de errores de WordPress (paso a paso)
- Cómo añadir correctamente JavaScripts y estilos en WordPress
- Los errores más comunes de WordPress y cómo corregirlos
- Cómo corregir el bloqueo de JavaScript y CSS en WordPress
Esperamos que este artículo te haya ayudado a solucionar el error ‘jQuery is not defined’ en WordPress. Puede que también quieras ver nuestra guía sobre cómo actualizar jQuery a la última versión en WordPress o nuestra selección de los mejores tutoriales de jQuery para principiantes en WordPress.
If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.
¿Tiene alguna pregunta o sugerencia? Por favor, deje un comentario para iniciar la discusión.