Cum să remediați eroarea WordPress „jQuery is not defined” (6 metode)

Când ceva se defectează în WordPress, poate părea că ați lovit un zid, mai ales când mesajul de eroare nu are prea mult sens. Una dintre acele probleme criptice este temuta eroare „jQuery is not defined”.

Am văzut că acest lucru apare la tot, de la formulare de contact la glisiere de imagini care refuză brusc să funcționeze. De obicei, îi ia pe utilizatori prin surprindere, mai ales dacă nu verificați activ consola browserului.

Am ajutat nenumărați proprietari de site-uri să remedieze exact această problemă. Și partea cea mai bună? Nu trebuie să fii dezvoltator pentru a urmări.

În acest ghid, vom explica ce înseamnă eroarea, de ce apare și vă vom ghida prin soluțiile pas cu pas care funcționează cu adevărat, chiar dacă nu ați atins niciodată o linie de cod.

Ce cauzează eroarea „jQuery nu este definită”?

jQuery este o bibliotecă JavaScript utilizată pe scară largă în WordPress, care ajută la rularea multor funcționalități interactive. Cu toate acestea, uneori, s-ar putea să nu se încarce corect, ceea ce ar putea afecta funcționalitatea site-ului dvs. web.

Eroarea apare în instrumentele pentru dezvoltatori sub fila Consola, așa că mulți utilizatori s-ar putea să nu o observe până când ceva nu funcționează pe site-ul lor.

Dacă vedeți eroarea „jQuery nu este definit”, înseamnă că WordPress are probleme în a o încărca corect. De-a lungul anilor, am ajutat nenumărați utilizatori să remedieze această problemă și am învățat că aceasta provine, de obicei, de la câteva cauze comune:

1. Teme sau pluginuri învechite: Mulți utilizatori întâmpină această eroare atunci când temele sau pluginurile lor nu sunt actualizate pentru a corespunde celei mai recente versiuni de WordPress. Am observat adesea că acest lucru se întâmplă după actualizări majore de WordPress.
2. Încărcare incorectă a scripturilor: jQuery trebuie încărcat înainte de alte fișiere JavaScript. Dacă nu este, scripturile care depind de jQuery se vor defecta. Acest lucru se întâmplă adesea dacă temele sau pluginurile nu sunt codificate corect pentru a înregistra scripturile.
3. Conflicte JavaScript: Alte scripturi care rulează pe site-ul dvs. pot intra în conflict cu jQuery, mai ales dacă nu sunt încărcate corect. Acest conflict poate defecta jQuery, cauzând eroarea.
4. Eșecuri CDN: Unele site-uri se bazează pe jQuery găzduit pe o Rețea de Livrare de Conținut (CDN). Dacă CDN-ul nu este disponibil sau este blocat, site-ul nu va putea încărca jQuery, rezultând în eroare.

Toate aceste probleme pot împiedica funcționarea corectă a jQuery. Dar nu-ți face griji – cu experiența noastră, te putem ghida prin soluțiile pentru a rezolva problema.

Cum să remediați eroarea „jQuery nu este definit”

Există mai multe moduri de a remedia această eroare atunci când o întâlniți. Mai jos sunt cele mai eficiente metode pe care le-am folosit pentru a rezolva această problemă.

Vă recomandăm să încercați aceste strategii în ordine, dar puteți folosi linkurile de salt de mai jos dacă doriți să începeți cu o anumită strategie:

• Actualizați WordPress, Teme și Pluginuri
• Verificați dacă jQuery este încărcat corect
• Adăugați o soluție de rezervă jQuery
• Remediați ordinea de încărcare a scripturilor (Avansat)
• Editați fișierul wp-config.php pentru a remedia problemele de încărcare jQuery
• Întrebări frecvente despre eroarea „jQuery is not defined”
• Resurse bonus: Depanarea erorilor WordPress

Vom parcurge fiecare dintre aceste metode și apoi vă vom oferi resurse suplimentare pentru depanarea erorilor WordPress. Să începem!

1. Actualizați WordPress, temele și pluginurile

Software-ul învechit este una dintre cele mai frecvente cauze ale erorii „jQuery is not defined”. Teme sau pluginuri învechite s-ar putea să nu fie compatibile cu cea mai recentă versiune de WordPress, ceea ce poate duce la conflicte de scripturi. Pentru a remedia acest lucru:

Mai întâi, asigurați-vă că nucleul WordPress este actualizat. Navigați la Panou de control » Actualizări și faceți clic pe „Actualizați la versiunea X.X.X” dacă este disponibilă o actualizare.

Consultați ghidul nostru complet despre actualizarea în siguranță a WordPress la o versiune nouă pentru mai multe detalii.

Actualizările pluginurilor WordPress vor fi listate sub actualizarea de bază.

Puteți selecta toate și faceți clic pe „Actualizați pluginurile”.

În cele din urmă, veți vedea actualizări pentru temele dvs. WordPress.

Pur și simplu selectați-le pe toate și faceți clic pe „Actualizați temele”.

Dacă sunteți îngrijorat de modificările pe care le-ați făcut temei dvs., urmați ghidul nostru despre cum să actualizați tema WordPress fără a pierde personalizările.

2. Verifică dacă jQuery este încărcat corect

Înainte de a explora soluții mai avansate, este important să verificați dacă jQuery este încărcat pe site-ul dvs. Acest pas vă ajută să confirmați dacă jQuery este disponibil și funcționează așa cum ar trebui.

Pur și simplu faceți clic dreapta oriunde pe site-ul dvs. WordPress și selectați „Vizualizați sursa paginii”.

Acest lucru vă va arăta codul HTML și JavaScript brut pentru pagina dvs.

Apoi, apăsați Ctrl +F (sau Cmd + F pe Mac) pentru a deschide bara de căutare și tastați „jquery.min.js”.

Dacă jQuery este încărcat corect, ar trebui să vedeți o referință la acesta în cod.

O altă modalitate de a căuta jQuery este să folosiți Instrumentul de inspecție al browserului dvs. Pur și simplu accesați fila „Rețea” și reîncărcați pagina.

Filtrați activitatea rețelei tastând ‘jquery’ în bara de căutare. Dacă jQuery este încărcat, îl veți vedea listat aici.

Dacă nu vedeți jQuery încărcat în niciuna dintre metode, problema ar putea fi modul în care este înregistrat în WordPress. În pașii următori, vă vom ghida prin remedierea acestei probleme.

3. Adăugați o soluție de rezervă jQuery

Uneori, un script de pe site-ul dvs. ar putea încărca jQuery folosind un CDN care are probleme de conectivitate. În acest caz, ar eșua să încarce jQuery și ar cauza eroarea.

Pentru a rezolva problema, puteți adăuga o soluție de rezervă jQuery pe site-ul dvs. WordPress. Acest lucru asigură că jQuery este întotdeauna încărcat.

Trebuie să îl adăugați în secțiunea head a site-ului dvs. pentru a vă asigura că se încarcă primul. Cu toate acestea, nu recomandăm editarea directă a fișierelor temei. Am văzut oameni care își pierd modificările atunci când actualizează tema și codul pe care l-au adăugat.

Cel mai bun mod de a adăuga cod personalizat în WordPress este să folosești pluginul WPCode. Este un manager de fragmente de cod care îți permite să adaugi cod personalizat în siguranță, fără a-ți strica site-ul.

Mai întâi, instalați și activați pluginul WPCode. Pentru detalii, consultați tutorialul nostru despre instalarea unui plugin WordPress.

Odată activat, accesați Code Snippets » + Add Snippet. Apoi, faceți clic pe butonul ‘Use snippet’ sub ‘Add Your Custom Code (New Snippet).’

În editorul de cod, dați un nume fragmentului dvs., cum ar fi „jQuery Fallback”.

După aceea, selectați „Fragment HTML” pentru „Tipul codului”.

Apoi, lipiți următorul cod în caseta „Previzualizare cod”:

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

Apoi, derulați în jos la secțiunea „Inserare”.

Aici puteți indica WPCode unde să încarce acest cod. Asigurați-vă că selectați „Antet la nivel de site”.

În final, faceți clic pe butonul ‘Save Snippet’ din partea de sus pentru a salva codul dvs. personalizat.

După aceea, nu uita să activezi fragmentul comutând comutatorul pe „Activ”.

4. Remediați ordinea de încărcare a scripturilor (Avansat)

Un alt motiv comun pentru eroarea „jQuery is not defined” este că jQuery se încarcă după alte scripturi care depind de el. Remedierea ordinii de încărcare a scripturilor asigură că jQuery este întotdeauna încărcat primul, prevenind conflictele.

Dacă știți ce script se bazează pe jQuery, puteți încărca acel script corect adăugând jQuery ca dependență.

Dacă eroarea „jQuery is not defined” este cauzată de încărcarea jQuery după alte scripturi care depind de ea, poți remedia ordinea de încărcare a scripturilor folosind WPCode.

Mai întâi, instalați și activați pluginul WPCode, sau optați pentru versiunea gratuită numită WPCode Lite.

Odată activat, accesați Code Snippets » + Add Snippet și faceți clic pe butonul „Use snippet” sub „Add Your Custom Code (New Snippet)”.

În editorul de cod, dați un nume snippet-ului dvs., cum ar fi ‘Fix Script Loading Order’ și selectați ‘PHP snippet’ ca tip de cod.

Apoi, adăugați următorul cod pentru a vă asigura că jQuery este înregistrat ca o dependență pentru orice scripturi personalizate:

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

Nu uitați să înlocuiți „your-script-handle” cu un nume semnificativ pentru a identifica scriptul. Și înlocuiți „/js/your-script.js” cu numele real al fișierului script din folderul /js/ al temei dvs.

Partea array('jquery') din cod asigură că jQuery este încărcat mai întâi.

După ce ați adăugat codul, derulați în jos la opțiunile „Inserare” și selectați „Antet la nivel de site” pentru a vă asigura că scriptul este încărcat în partea corectă a codului HTML al site-ului dvs.

În final, faceți clic pe butonul ‘Save Snippet’ din partea de sus pentru a salva codul dvs. personalizat.

După aceea, nu uita să activezi fragmentul comutând comutatorul pe „Activ”.

Utilizarea WPCode pentru a înregistra corect scripturile asigură că jQuery este încărcat în ordinea corectă. Dacă aceasta a fost cauza problemei, aceasta ar trebui să rezolve eroarea.

5. Editați fișierul wp-config.php pentru a remedia problemele de încărcare jQuery

Dacă celelalte metode nu au funcționat, editarea fișierului wp-config.php poate ajuta prin controlarea modului în care WordPress gestionează încărcarea scripturilor.

Această metodă este utilă dacă problemele legate de concatenarea scripturilor sau de căile fișierelor cauzează eroarea „jQuery nu este definit”.

Iată cum se aplică această metodă:

Mai întâi, accesați fișierul wp-config.php. Puteți face acest lucru folosind un client FTP precum FileZilla sau accesând managerul de fișiere din panoul de control al găzduirii dvs.

Fișierul wp-config.php se află în directorul rădăcină al instalării dvs. WordPress (de obicei în folderul public_html).

Odată ce ați localizat fișierul, deschideți-l pentru editare și adăugați următorul cod chiar înainte de linia care spune /* Gata, opriți editarea! Blogging fericit. */:

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

Iată ce face acest cod:

• Definiția ABSPATH asigură că WordPress cunoaște calea corectă către fișierele sale de bază, ceea ce poate preveni problemele de încărcare jQuery.
• Linia CONCATENATE_SCRIPTS dezactivează concatenarea scripturilor. Aceasta forțează WordPress să încarce fiecare script separat, prevenind conflictele care apar atunci când scripturile sunt combinate.

După adăugarea acestui cod, salvați modificările și reîncărcați site-ul pentru a vedea dacă eroarea a fost rezolvată.

Dezactivarea concatenării scripturilor poate fi o soluție simplă, dar eficientă pentru problemele jQuery, mai ales când alte metode nu funcționează.

Întrebări frecvente despre eroarea „jQuery is not defined”

Resurse bonus: Depanarea erorilor WordPress

Dacă toți pașii de mai sus nu ajută sau doriți să citiți mai departe, atunci următoarele resurse ar putea fi puncte de plecare bune:

• Ghid pentru începători în depanarea erorilor WordPress (Pas cu Pas)
• Cum să adăugați corect scripturi JavaScript și stiluri în WordPress
• Cele mai frecvente erori WordPress și cum să le remediați
• Cum să remediați JavaScript și CSS care blochează redarea în WordPress

Sperăm că acest articol v-a ajutat să remediați eroarea „jQuery is not defined” în WordPress. De asemenea, ați putea dori să consultați ghidul nostru despre actualizarea jQuery la cea mai recentă versiune în WordPress sau selecția noastră de cele mai bune tutoriale jQuery pentru începătorii WordPress.

Dacă ți-a plăcut acest articol, te rugăm să te abonezi la canalul nostru de YouTube pentru tutoriale video WordPress. Ne poți găsi, de asemenea, pe Twitter și Facebook.