Errore WordPress "jQuery non definito": come risolverlo (6 metodi)

L'errore "jQuery is not defined" è un problema comune riscontrato da molti WordPress . Significa che il sito web non riesce a caricare jQuery, una libreria JavaScript fondamentale per il funzionamento di funzionalità come slider, moduli e popup. Senza di essa, il sito potrebbe non funzionare correttamente o comportarsi in modo imprevedibile. 

Questo errore si verifica spesso a causa di un caricamento errato degli script, conflitti tra plugin o temi obsoleti. È importante risolvere immediatamente questo problema, altrimenti potrebbe influire negativamente sulla funzionalità del sito e sull'esperienza utente. In questa guida, esploreremo le cause di questo errore e forniremo semplici passaggi per risolverlo rapidamente.

Che cos'è jQuery?

jQuery è una JavaScript che semplifica le attività di programmazione. Semplifica la gestione di HTML, eventi, animazioni e Ajax . In WordPress, jQuery è essenziale per molti temi e plugin. Supporta funzionalità interattive come slider di immagini, popupe convalida dei form. 

Gli sviluppatori WordPress utilizzano jQuery per aggiungere elementi dinamici ai siti WordPress senza dover scrivere codice JavaScript complesso. Grazie al suo ampio supporto, molti plugin di WordPress si basano su jQuery per funzionare correttamente.

Perché WordPress usa jQuery?

WordPress utilizza jQuery perché semplifica l'aggiunta di funzionalità interattive ai siti web. Temi, widget e plugin si basano su jQuery per attività come animazioni, gestione dei moduli e slider. È una scelta popolare perché è efficiente e ampiamente supportata. 

WordPress carica automaticamente jQuery con la sua wp_enqueue_script() , garantendo che gli script vengano caricati nell'ordine corretto. Questo aiuta a evitare conflitti e a gestire le dipendenze tra i diversi file JavaScript. Gestendo queste dipendenze dietro le quinte, WordPress garantisce un funzionamento fluido tra temi e plugin.

Informazioni su: Errori comuni di WordPress e come risolverli

Cause dell'errore "jQuery non è definito"

Diamo un'occhiata alle cause più comuni degli errori "jQuery non definito" in WordPress. Comprenderle può aiutarti a identificare e risolvere il problema sul tuo sito.

Caricamento script non corretto

Un caricamento errato degli script si verifica quando jQuery non viene caricato prima degli altri script che lo utilizzano, causando l'errore "jQuery non è definito". In WordPress, gli script devono essere caricati in un ordine specifico, con jQuery caricato per primo.

Tuttavia, i temi personalizzati o i plugin obsoleti potrebbero trascurare questo aspetto e caricare i propri script senza prima assicurarsi che jQuery sia caricato. Di conseguenza, qualsiasi script che dipenda da jQuery smetterà di funzionare. Questo problema è particolarmente comune quando gli sviluppatori aggiungono manualmente gli script senza utilizzare le funzioni integrate di WordPress per gestire correttamente le dipendenze.

Scopricome risolvere il problema "Aggiornamento del plugin di WordPress non riuscito".

Conflitti tra plugin

Plugin mal codificati o obsoleti possono causare problemi di caricamento di jQuery in WordPress. Alcuni plugin potrebbero caricare la propria versione di jQuery o non caricarla correttamente. Questo può entrare in conflitto con altri plugin o con gli script principali di WordPress, generando l'errore "jQuery non definito".

jQuery è disabilitato o non registrato

A volte, gli sviluppatori disattivano o annullano involontariamente la registrazione di jQuery mentre cercano di ottimizzare la velocità di un sito WordPress. Questo accade spesso quando sostituiscono la versione predefinita di jQuery con una personalizzata o la rimuovono completamente, pensando che non sia necessaria. 

Quando ciò accade, i plugin e i temi che si basano sulla versione predefinita di WordPress jQuery non possono funzionare correttamente, causando l'errore "jQuery non definito". Questo interrompe le funzionalità interattive del sito, compromettendo funzionalità chiave come le animazioni.

Guida definitiva per: Ottimizzazione della velocità di WordPress

Problemi di cache e CDN

del browser La memorizzazione nella cache e le reti di distribuzione dei contenuti (CDN) possono impedire il caricamento della versione corretta di jQuery. Se una vecchia versione di jQuery è memorizzata nella cache o la CDN fornisce un file obsoleto, il sito web potrebbe non riuscire a caricare lo script corretto, causando errori.

Problemi tematici

I temi personalizzati, o quelli non aggiornati per funzionare con l'ultima versione di WordPress, possono causare errori jQuery. Questi temi potrebbero non caricare correttamente jQuery o entrare in conflitto con gli script predefiniti di WordPress, causando problemi di funzionalità sul sito.

Guida a: Sviluppo di temi WordPress personalizzati

Guida passo passo per correggere l'errore "jQuery non definito"

Ora che abbiamo compreso le cause dell'errore "jQuery non definito", esploriamo una guida dettagliata per risolverlo e ripristinare la funzionalità del tuo sito.

Controlla la console per sviluppatori del tuo browser

Per iniziare a risolvere l'errore "jQuery non è definito", controlla la console per sviluppatori del tuo browser. Puoi accedervi facendo clic con il pulsante destro del mouse sulla pagina web e selezionando "Ispeziona" oppure premendo Ctrl + Maiusc + I (o Cmd + Opzione + I su Mac).

Una volta aperta la console, vai alla scheda "Console". Cerca eventuali messaggi di errore che indicano problemi con jQuery. Fai attenzione al percorso del file indicato nel messaggio di errore, poiché può indicarti l'origine del problema.

Inoltre, verifica la presenza di conflitti di versione, che potrebbero indicare l'utilizzo di una versione obsoleta o incompatibile di jQuery. Identificare questi dettagli ti aiuterà a comprendere la causa principale del problema.

Leggi di più: Che cos'è il monitoraggio del browser reale

Assicurati che jQuery sia caricato correttamente

Per garantire che jQuery venga caricato correttamente in WordPress, utilizza la wp_enqueue_script() . Questa funzione consente di caricare gli script nell'ordine corretto, evitando conflitti.

Per prima cosa, devi aggiungere il seguente codice al file functions.php del tuo tema:

function my_theme_enqueue_scripts() { // Annulla la registrazione del jQuery predefinito wp_deregister_script('jquery'); // Registra e carica l'ultima versione di jQuery wp_register_script('jquery', includes_url('/js/jquery/jquery.js'), array(), null, true); wp_enqueue_script('jquery'); } add_action('wp_enqueue_scripts', 'my_theme_enqueue_scripts');

Questo codice prima annulla la registrazione di jQuery predefinito e poi la registra nuovamente, assicurando che venga caricata la versione più recente. L'ultimo parametro (true) assicura che jQuery venga caricato nel footer, il che è consigliato per le prestazioni.

Utilizzando wp_enqueue_script(), si garantisce che jQuery venga caricato prima di qualsiasi altro script che dipenda da esso, evitando l'errore "jQuery non è definito".

Scopri: Come risolvere il problema del caricamento del sito Web WordPress

Riattiva jQuery predefinito di WordPress

Per verificare se jQuery è stato deregistrato in WordPress, controlla il file functions.php del tuo tema. Cerca eventuali righe di codice che utilizzano wp_deregister_script('jquery'). Se trovi una riga del genere, significa che jQuery è stato disabilitato.

Per registrare nuovamente il jQuery predefinito di WordPress, segui questi passaggi:

• Apri il file functions.php del tuo tema attivo nella dashboard di WordPress.
• Aggiungere il seguente codice per riattivare jQuery:

function reenable_default_jquery() { // Controlla se jQuery è stato de-registrato if (!wp_script_is('jquery', 'registered')) { // Registra nuovamente jQuery predefinito wp_register_script('jquery', includes_url('/js/jquery/jquery.js'), array(), null, true); wp_enqueue_script('jquery'); } } add_action('wp_enqueue_scripts', 'reenable_default_jquery');

Questo codice verifica se jQuery è stato de-registrato. In tal caso, registra nuovamente la versione predefinita e la mette in coda per l'uso. L'ultimo parametro assicura che venga caricata nel footer. L'aggiunta di questo codice contribuirà a prevenire l'errore "jQuery non è definito" sul tuo sito.

Leggi anche: Come risolvere gli errori PHP in WordPress

Verifica i conflitti dei plugin

Per identificare i conflitti tra plugin che causano l'errore "jQuery non è definito", segui questi passaggi:

• Nella dashboard di WordPress, vai alla sezione "Plugin". Seleziona tutti i plugin e scegli "Disattiva" dal menu delle azioni in blocco. Questo disabiliterà tutti i plugin attivi. 

• Dopo aver disattivato i plugin, verifica se l'errore "jQuery non è definito" persiste. Se l'errore scompare, indica un conflitto tra plugin.

• Successivamente, inizia a riattivare i tuoi plugin singolarmente. Dopo aver attivato ciascun plugin, testa il tuo sito per vedere se l'errore si ripresenta. Questo processo aiuta a identificare il plugin specifico che causa il conflitto.

comeScopri risolvere l'errore "Errore durante la creazione di una connessione al database" in WordPress.

Cancella cache e CDN

Svuotare la cache può essere molto utile per risolvere l'errore "jQuery non è definito". Ecco i passaggi:

Cancella la cache del browser

• Google Chrome: fai clic sui tre puntini nell'angolo in alto a destra, quindi vai su Altri strumenti ⟶ Cancella dati di navigazione. Seleziona Immagini e file memorizzati nella cache e fai clic su Cancella dati.

• Firefox: Fai clic sulle tre linee orizzontali, quindi vai su Opzioni ⟶ Privacy e sicurezza. In Cookie e dati dei siti, fai clic su Cancella dati e seleziona Contenuti web memorizzati nella cache.

• Edge: Fai clic sui tre puntini, quindi vai su Impostazioni ⟶ Privacy, ricerca e servizi. In Cancella dati di navigazione, fai clic su Scegli cosa cancellare e seleziona Immagini e file memorizzati nella cache.

Correlati: Edge Caching in WordPress per massimizzare la velocità del sito

Cancella la cache lato server

Se utilizzi un plugin di caching, accedi alle impostazioni del plugin nella bacheca di WordPress. Cerca l'opzione per svuotare completamente la cache e fai clic su di essa. In questo modo, tutti i file obsoleti verranno rimossi dal server.

Svuota la cache CDN

Accedi al tuo CDN se utilizzi una Content Delivery Network (CDN) come Cloudflare o MaxCDN. Cerca la sezione di gestione della cache e seleziona l'opzione per svuotare o cancellare la cache. Questo garantirà che tutti i visitatori carichino la versione più recente di jQuery.

Ulteriori letture: Come funziona la memorizzazione nella cache HTTP e come utilizzarla

Aggiorna temi e plugin

L'aggiornamento di temi e plugin è fondamentale per mantenere un sito WordPress efficiente. Gli aggiornamenti regolari garantiscono la compatibilità con l' ultima versione di WordPress e risolvono i bug noti. Temi o plugin obsoleti possono causare conflitti, incluso l'errore "jQuery is not defined".

Passa a un tema predefinito di WordPress, come Twenty Twenty-One, per verificare la presenza di problemi specifici del tema. Per farlo, vai su Aspetto ⟶ Temi nella bacheca di WordPress. Attiva temporaneamente il tema predefinito e testa il tuo sito.

Se l'errore scompare, significa che il problema riguarda il tema originale. Mantenere tutto aggiornato aiuta a prevenire problemi di funzionalità e migliora le prestazioni generali del sito.

Leggi: Guida all'aggiornamento di WordPress

Le migliori pratiche per prevenire gli errori jQuery in WordPress

Ecco alcune buone pratiche da seguire per prevenire errori jQuery in WordPress:

Usa sempre wp_enqueue_script()

L'utilizzo di `wp_enqueue_script()` è fondamentale quando si aggiungono script in WordPress. Questa funzione garantisce che gli script vengano caricati nell'ordine corretto e gestisce automaticamente le dipendenze. Questo metodo può prevenire i conflitti più comuni che potrebbero causare l'errore "jQuery is not defined".

Evita di annullare la registrazione di jQuery inutilmente

Annullare la registrazione degli script principali di WordPress, come jQuery, può creare problemi significativi. Molti temi e plugin si basano sulla versione predefinita di jQuery per funzionare correttamente. Rimuoverla o sostituirla rischia di compromettere funzionalità essenziali del sito, causando errori e una scarsa esperienza utente. Pertanto, è meglio lasciare intatti gli script principali, a meno che non sia assolutamente necessario.

Usa un tema figlio

L'utilizzo di un tema figlio è vantaggioso per la personalizzazione di WordPress. Permette di apportare modifiche senza alterare i file del tema principale. Questo è importante perché gli aggiornamenti al tema principale possono sovrascrivere le personalizzazioni. Utilizzando un tema figlio, è possibile aggiornare in sicurezza il tema principale preservando le modifiche apportate e riducendo il rischio di introdurre errori jQuery.

Modifiche di prova in un ambiente di staging

Un ambiente di staging è fondamentale per testare in sicurezza le modifiche prima di implementarle sul tuo sito web. Ti consente di sperimentare aggiornamenti, nuovi plugin o codice personalizzato senza influire sugli utenti. Utilizzando un sito di staging, puoi identificare e correggere potenziali errori o conflitti jQuery prima che raggiungano il tuo sito web. Questa pratica aiuta a mantenere la stabilità del sito e offre un'esperienza migliore per i visitatori.

Strumenti per correggere l'errore "jQuery non è definito"

Per correggere l'errore "jQuery non è definito", puoi utilizzare i seguenti strumenti:

Console per sviluppatori (Chrome/Firefox)

La Developer Console di browser come Chrome e Firefox è uno strumento prezioso per il debug degli errori JavaScript. È possibile accedervi cliccando con il pulsante destro del mouse sulla pagina web, selezionando "Ispeziona" e quindi accedendo alla scheda "Console".

Qui puoi visualizzare i messaggi di errore, inclusi quelli relativi a jQuery. Questi messaggi spesso forniscono dettagli sull'errore, come il percorso del file e il numero di riga, aiutandoti a identificare e risolvere rapidamente i problemi.

Plugin di debug di WordPress

I plugin di debug di WordPress, come Query Monitor, sono eccellenti per diagnosticare i problemi del tuo sito. Query Monitor ti consente di visualizzare tutte le query del database, gli errori PHP e le code di script. Fornisce informazioni su cosa potrebbe causare errori jQuery o altri problemi.

Plugin per il controllo dello stato di salute e la risoluzione dei problemi

Il plugin Health Check & Troubleshooting aiuta a identificare i conflitti tra temi o plugin. Questo plugin consente di disattivare tutti i plugin e passare a un tema predefinito senza influire sul sito live. È quindi possibile riattivare i plugin uno alla volta per verificare se l'errore jQuery si ripresenta. Questo metodo aiuta a isolare il problema e a determinare quale plugin o tema specifico sta causando il conflitto.

In sintesi

Risolvere l'errore "jQuery is not defined" è fondamentale per mantenere la funzionalità del tuo sito WordPress . Le soluzioni principali includono:

• Controllo della console per sviluppatori del browser.
• Assicurarsi che jQuery sia caricato correttamente.
• Risoluzione dei conflitti tra plugin.

Utilizza sempre wp_enqueue_script() per gestire efficacemente i tuoi script ed evitare inutili cancellazioni di jQuery. Inoltre, aggiornare regolarmente temi e plugin aiuta a prevenire problemi di compatibilità. Valuta la possibilità di utilizzare un tema figlio per personalizzazioni sicure e testa sempre le modifiche in un ambiente di staging prima di pubblicarle.

Infine, se riscontri problemi persistenti, rivolgiti per assistenza e supporto professionale su WordPress . Possiamo fornirti assistenza qualificata per garantire il corretto funzionamento del tuo sito.