Este error indica que algún script intenta usar jQuery antes de que esté cargado o cuando ya no está disponible. En WordPress suele aparecer después de activar opciones de optimización (diferir, combinar, minificar JavaScript) o de instalar un plugin que carga scripts de forma incorrecta.
Cómo confirmarlo
- Abre la consola del navegador en la página con el problema.
- Busca «jQuery is not defined» o «$ is not a function».
- Observa qué archivo lanza el error.
- Comprueba si desaparece al desactivar la optimización de JavaScript.
Causas frecuentes
| Causa | Solución típica |
|---|---|
| Plugin de caché que difiere o combina JS | Excluir jQuery y los scripts que dependen de él |
| Tema que quita jQuery del núcleo | Cargar jQuery de WordPress de nuevo |
| Script añadido a mano en el pie sin dependencia | Registrar el script con dependencia de jQuery |
| Conflicto entre versiones | Evitar cargar una segunda copia de jQuery |
Buenas prácticas para scripts propios
- Usa el sistema de registro y encolado de scripts de WordPress.
- Declara jQuery como dependencia cuando corresponda.
- Evita pegar scripts en el editor sin controlar el orden.
- Prueba tras cada cambio de optimización.
Equilibrio entre velocidad y estabilidad
Diferir JavaScript mejora las métricas, pero puede romper funciones. Activa las optimizaciones de una en una y prueba formularios, menús y galerías. Si la mejora de velocidad vale el riesgo, deja constancia en el informe. Mira cómo mejorar el INP en WordPress y WordPress lento: causas y soluciones.
En resumen
- Cómo confirmarlo: Abre la consola del navegador en la página con el problema.; Busca «jQuery is not defined» o «$ is not a function».
- Buenas prácticas para scripts propios: Usa el sistema de registro y encolado de scripts de WordPress.; Declara jQuery como dependencia cuando corresponda.
- Equilibrio entre velocidad y estabilidad: Diferir JavaScript mejora las métricas, pero puede romper funciones.
Preguntas frecuentes
¿Es seguro cargar jQuery desde un CDN?
Es posible, pero puede crear conflictos si ya existe la versión del núcleo. Prefiere la que incluye WordPress.
¿Puedo prescindir de jQuery?
Depende del tema y los plugins; muchos aún dependen de él.
¿Cómo pruebo después de corregir?
Revisa las páginas clave en el navegador, con consola abierta, y prueba formularios y menús.
¿Afecta al SEO?
No directamente, pero puede romper funciones y la experiencia de usuario, lo que afecta a las conversiones.