Come risolvere l'errore 'jQuery is not defined' di WordPress (6 modi)

Quando qualcosa si rompe in WordPress, può sembrare di sbattere contro un muro, specialmente quando il messaggio di errore non ha molto senso. Uno di questi problemi criptici è il temuto errore 'jQuery non definito'.

Abbiamo visto questo errore apparire su tutto, dai moduli di contatto agli slider di immagini che improvvisamente rifiutano di funzionare. Di solito coglie gli utenti di sorpresa, specialmente se non stai controllando attivamente la console del browser.

Abbiamo aiutato innumerevoli proprietari di siti a risolvere questo esatto problema. E la parte migliore? Non devi essere uno sviluppatore per seguirci.

In questa guida, spiegheremo cosa significa l'errore, perché si verifica e ti guideremo attraverso le soluzioni passo passo che funzionano davvero, anche se non hai mai toccato una riga di codice prima.

Cosa causa l'errore 'jQuery non definito'?

jQuery è una libreria JavaScript ampiamente utilizzata in WordPress che aiuta a eseguire molte funzionalità interattive. Tuttavia, a volte, potrebbe non caricarsi correttamente, il che potrebbe influire sulla funzionalità del tuo sito web.

L'errore appare negli strumenti per sviluppatori nella scheda Console, quindi molti utenti potrebbero non notarlo finché qualcosa non si rompe sul loro sito.

Se vedi l'errore 'jQuery non definito', significa che WordPress sta avendo problemi a caricarlo correttamente. Nel corso degli anni, abbiamo aiutato innumerevoli utenti a risolvere questo problema e abbiamo imparato che di solito deriva da alcune cause comuni:

1. Temi o plugin obsoleti: Molti utenti riscontrano questo errore quando i loro temi o plugin non sono aggiornati per corrispondere all'ultima versione di WordPress. Abbiamo spesso visto che ciò accade dopo importanti aggiornamenti di WordPress.
2. Caricamento errato degli script: jQuery deve essere caricato prima di altri file JavaScript. In caso contrario, gli script che dipendono da jQuery si interromperanno. Ciò si verifica spesso se temi o plugin non sono codificati correttamente per accodare gli script.
3. Conflitti JavaScript: Altri script in esecuzione sul tuo sito potrebbero entrare in conflitto con jQuery, specialmente se non vengono caricati correttamente. Questo conflitto può interrompere jQuery, causando l'errore.
4. Errori CDN: Alcuni siti si basano su jQuery ospitato su una Content Delivery Network (CDN). Se la CDN non è disponibile o è bloccata, il sito non sarà in grado di caricare jQuery, con conseguente errore.

Tutti questi problemi possono impedire a jQuery di funzionare correttamente. Ma non preoccuparti: con la nostra esperienza, possiamo guidarti attraverso le soluzioni per risolvere il problema.

Come correggere l'errore 'jQuery is not defined'

Ci sono diversi modi per correggere questo errore quando lo incontri. Di seguito sono riportati i metodi più efficaci che abbiamo utilizzato per risolvere questo problema.

Ti consigliamo di provare queste strategie in ordine, ma puoi utilizzare i collegamenti rapidi qui sotto se desideri iniziare con uno particolare:

• Aggiorna WordPress, temi e plugin
• Verifica se jQuery è caricato correttamente
• Aggiungi un fallback per jQuery
• Correggi l'ordine di caricamento degli script (Avanzato)
• Modifica wp-config.php per correggere i problemi di caricamento di jQuery
• Domande frequenti sull'errore 'jQuery is not defined'
• Risorse bonus: Risoluzione dei problemi degli errori di WordPress

Esamineremo ciascuno di questi metodi e poi ti forniremo alcune risorse aggiuntive per la risoluzione dei problemi degli errori di WordPress. Iniziamo!

1. Aggiorna WordPress, temi e plugin

Il software obsoleto è una delle cause più comuni dell'errore 'jQuery non è definito'. Temi o plugin obsoleti potrebbero non essere compatibili con l'ultima versione di WordPress, il che può causare conflitti di script. Per risolvere questo problema:

Innanzitutto, assicurati che il tuo core di WordPress sia aggiornato. Naviga su Dashboard » Aggiornamenti e fai clic su 'Aggiorna alla versione X.X.X' se è disponibile un aggiornamento.

Consulta la nostra guida completa su come aggiornare WordPress in modo sicuro a una nuova versione per maggiori dettagli.

I tuoi aggiornamenti dei plugin di WordPress saranno elencati sotto l'aggiornamento principale.

Puoi selezionarli tutti e fare clic su 'Aggiorna plugin'.

Infine, vedrai gli aggiornamenti per i tuoi temi WordPress.

Selezionali semplicemente tutti e fai clic su 'Aggiorna temi'.

Se sei preoccupato per le modifiche apportate al tuo tema, segui la nostra guida su come aggiornare il tuo tema WordPress senza perdere le personalizzazioni.

2. Verifica se jQuery è caricato correttamente

Prima di esplorare soluzioni più avanzate, è importante verificare se jQuery viene effettivamente caricato sul tuo sito. Questo passaggio ti aiuta a confermare se jQuery è disponibile e funziona come dovrebbe.

Fai semplicemente clic destro in un punto qualsiasi del tuo sito WordPress e seleziona 'Visualizza sorgente pagina'.

Questo ti mostrerà l'HTML e JavaScript grezzi della tua pagina.

Successivamente, premi Ctrl + F (o Cmd + F su Mac) per aprire la barra di ricerca e digita 'jquery.min.js'.

Se jQuery è caricato correttamente, dovresti vedere un riferimento ad esso nel codice.

Un altro modo per cercare jQuery è utilizzare lo strumento Ispeziona elemento del tuo browser. Vai semplicemente alla scheda ‘Network’ e ricarica la pagina.

Filtra l'attività di rete digitando ‘jquery’ nella barra di ricerca. Se jQuery è caricato, lo vedrai elencato qui.

Se non vedi jQuery caricato con nessuno dei due metodi, il problema potrebbe essere il modo in cui viene accodato in WordPress. Nei passaggi seguenti, ti guideremo nella risoluzione di questo problema.

3. Aggiungi un fallback per jQuery

A volte, uno script sul tuo sito potrebbe caricare jQuery utilizzando una CDN che presenta problemi di connettività. In tal caso, non riuscirebbe a caricare jQuery e causerebbe l'errore.

Per risolvere il problema, puoi aggiungere un fallback per jQuery al tuo sito WordPress. Questo garantisce che jQuery venga sempre caricato.

Devi aggiungerlo alla sezione head del tuo sito per assicurarti che venga caricato per primo. Tuttavia, non consigliamo di modificare direttamente i file del tema. Abbiamo visto persone perdere le loro modifiche quando aggiornano il tema e il codice che hanno aggiunto.

Il modo migliore per aggiungere codice personalizzato in WordPress è utilizzare il plugin WPCode. È un gestore di snippet di codice che ti consente di aggiungere codice personalizzato in modo sicuro senza interrompere il tuo sito.

Innanzitutto, installa e attiva il plugin WPCode. Per i dettagli, consulta il nostro tutorial su come installare un plugin di WordPress.

Una volta attivato, vai su Code Snippets » + Add Snippet. Quindi, fai clic sul pulsante ‘Use snippet’ sotto ‘Add Your Custom Code (New Snippet).’

Nell'editor di codice, dai al tuo snippet un nome come ‘jQuery Fallback’.

Dopodiché, seleziona ‘HTML Snippet’ per il ‘Code Type’.

Successivamente, incolla il seguente codice nella casella ‘Code Preview’:

<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>

Quindi, scorri verso il basso fino alla sezione ‘Insertion’.

Qui, puoi dire a WPCode dove caricare questo codice. Assicurati di selezionare ‘Intestazione sito intero’.

Infine, fai clic sul pulsante ‘Salva snippet’ in alto per salvare il tuo codice personalizzato.

Dopodiché, non dimenticare di attivare lo snippet spostando l'interruttore su ‘Attivo’.

4. Correggi l'ordine di caricamento degli script (Avanzato)

Un altro motivo comune per l'errore ‘jQuery non è definito’ è che jQuery viene caricato dopo altri script che ne dipendono. Correggere l'ordine di caricamento degli script garantisce che jQuery venga sempre caricato per primo, prevenendo conflitti.

Se sai quale script dipende da jQuery, puoi accodare correttamente quello script aggiungendo jQuery come dipendenza.

Se l'errore ‘jQuery non è definito’ è causato dal caricamento di jQuery dopo altri script che dipendono da esso, puoi correggere l'ordine di caricamento degli script utilizzando WPCode.

Innanzitutto, installa e attiva il plugin WPCode, oppure opta per la versione gratuita chiamata WPCode Lite.

Una volta attivato, vai su Code Snippets » + Add Snippet e fai clic sul pulsante ‘Use snippet’ sotto ‘Add Your Custom Code (New Snippet)’.

Nell'editor di codice, dai al tuo snippet un nome come ‘Fix Script Loading Order’ e seleziona ‘PHP snippet’ come tipo di codice.

Quindi, aggiungi il seguente codice per assicurarti che jQuery venga accodato come dipendenza per eventuali script personalizzati:

wp_enqueue_script( 'your-script-handle', get_template_directory_uri() . '/js/your-script.js', array( 'jquery' ), null, true );

Non dimenticare di sostituire ‘your-script-handle’ con un nome significativo per identificare lo script. E sostituisci ‘/js/your-script.js’ con il nome effettivo del file dello script nella cartella /js/ del tuo tema.

La parte array('jquery') nel codice garantisce che jQuery venga caricato per primo.

Una volta aggiunto il codice, scorri verso il basso fino alle opzioni ‘Inserimento’ e seleziona ‘Intestazione sito’ per assicurarti che lo script venga caricato nella parte corretta dell’HTML del tuo sito.

Infine, fai clic sul pulsante ‘Salva snippet’ in alto per salvare il tuo codice personalizzato.

Dopodiché, non dimenticare di attivare lo snippet spostando l'interruttore su ‘Attivo’.

L’utilizzo di WPCode per accodare correttamente gli script garantisce che jQuery venga caricato nell’ordine corretto. Se questo era il problema principale, questo dovrebbe risolvere l’errore.

5. Modifica wp-config.php per correggere i problemi di caricamento di jQuery

Se gli altri metodi non hanno funzionato, modificare il file wp-config.php può aiutare controllando come WordPress gestisce il caricamento degli script.

Questo metodo è utile se problemi di concatenazione di script o di percorso file stanno causando l’errore ‘jQuery is not defined’.

Ecco come applicare questo metodo:

Innanzitutto, accedi al tuo file wp-config.php. Puoi farlo utilizzando un client FTP come FileZilla o accedendo al file manager nel pannello di controllo del tuo hosting.

Il file wp-config.php si trova nella directory principale della tua installazione di WordPress (solitamente nella cartella public_html).

Una volta individuato il file, aprilo per la modifica e aggiungi il seguente codice appena prima della riga che dice /* Fine, smetti di modificare! Buona scrittura. */:

/** Absolute path to the WordPress directory. */
if ( !defined('ABSPATH') )
define('ABSPATH', dirname(FILE) . '/');
define('CONCATENATE_SCRIPTS', false);

Ecco cosa fa questo codice:

• La definizione ABSPATH assicura che WordPress conosca il percorso corretto ai suoi file principali, il che può prevenire problemi di caricamento di jQuery.
• La riga CONCATENATE_SCRIPTS disabilita la concatenazione degli script. Questo forza WordPress a caricare ogni script separatamente, prevenendo conflitti che sorgono quando gli script vengono uniti.

Dopo aver aggiunto questo codice, salva le modifiche e ricarica il tuo sito per vedere se l’errore è stato risolto.

Disabilitare la concatenazione degli script può essere una soluzione semplice ma efficace per i problemi di jQuery, specialmente quando altri metodi non funzionano.

Domande frequenti sull'errore 'jQuery non definito'

Risorse bonus: Risoluzione dei problemi degli errori di WordPress

Se tutti i passaggi precedenti non aiutano o desideri leggere ulteriormente, le seguenti risorse potrebbero essere buoni punti di partenza:

• Guida per principianti alla risoluzione degli errori di WordPress (passo dopo passo)
• Come aggiungere correttamente JavaScript e stili in WordPress
• Errori più comuni di WordPress e come risolverli
• Come risolvere JavaScript e CSS che bloccano il rendering in WordPress

Speriamo che questo articolo ti abbia aiutato a risolvere l'errore 'jQuery is not defined' in WordPress. Potresti anche voler consultare la nostra guida su come aggiornare jQuery all'ultima versione in WordPress o la nostra selezione dei migliori tutorial jQuery per principianti di WordPress.

Se ti è piaciuto questo articolo, iscriviti al nostro canale YouTube per tutorial video su WordPress. Puoi anche trovarci su Twitter e Facebook.