Este important să utilizați această funcție pentru a conecta fișierele js, deoarece astfel veți putea să îmbinați fișierele JS într-una fără probleme. De asemenea, în unele cazuri, eliminați conflictele de script atunci când scriptul dependent este conectat după ce depinde.
wp_enqueue_script () adaugă un script numai dacă nu a fost deja adăugat și celelalte scripturi de care depinde sunt înregistrate. Scripturile dependente sunt adăugate automat.
Dacă script-ul este deja înregistrat cu wp_register_script (). apoi pentru ao conecta la wp_enqueue_script (), trebuie să specificați doar comanda rapidă de script (în primul parametru).
Dacă scriptul nu este înregistrat, acesta poate fi înregistrat și conectat cu o singură funcție - wp_enqueue_script ():
De la versiunea 3.3. wp_enqueue_script () poate fi apelat în momentul generării paginii. În acest caz, scriptul apelat va fi conectat în subsol, în momentul apariției evenimentului wp_footer.
Funcția este apelată, de obicei, în timpul următoarelor evenimente (atârnă pe cârlige):
- wp_enqueue_scripts - pentru exteriorul site-ului;
- admin_enqueue_scripts - pentru panoul de administrare;
- login_enqueue_scripts - pentru pagina de conectare.
Când trebuie să conectați un script cu o condiție, de exemplu, utilizați în plus față de această funcție wp_script_add_data ()
se întoarce
Nu întoarce nimic.
Șablonul de utilizare
Numele scriptului (titlu de lucru). Șirul este minuscule.
Dacă șirul conține un semn de întrebare (?): Scriptaculousv = 1.2. atunci partea anterioară va fi numele scriptului și toate acestea ulterior vor fi adăugate la adresa URL ca parametri de interogare. Deci, puteți specifica versiunea scriptului care trebuie conectat.
Acest parametru este necesar numai atunci când script-ul nu este înregistrat și WordPress nu știe despre acest scenariu, consultați wp_register_script funcția ().
Nu este necesar să scrieți URL-uri rigid, ar trebui să fie determinate dinamic. Pentru aceasta, utilizați funcțiile de recuperare a adreselor URL:
Legăturile către scripturile externe pot fi specificate fără specificarea unui protocol: //otherdomain.com/js/their-script.js.
Deja înregistrați în scripturile WP, vedeți mai jos în acest articol.
Implicit: fals
$ deps (array) Un șir de nume ale scripturilor pe care depinde acest script; script-uri care trebuie încărcate înainte de acest script. Această opțiune este necesară numai dacă WordPress nu știe deja despre acest script.
Implicit: array () $ ver (șir)
Un șir indicând versiunea scriptului, dacă are una. Acest parametru este folosit pentru a vă asigura că clientul a primit versiunea corectă a scriptului, și nu din memoria cache.
Dacă parametrul nu este specificat, versiunea WordPress va fi utilizată ca versiune a scriptului.
Dacă specificați null. atunci nu va fi adăugată nicio versiune.
Implicit: fals
Conectați scriptul la subsol?
De obicei, scenariul este
document, dacă specificați adevărat, scriptul va fi conectat înainte de etichetă . mai precis unde se numește eticheta șablonului wp_footer ().Dacă, din cauza dependenței de alte scripturi, nu este posibil să conectați scriptul curent în subsol, valoarea acestei variabile va fi ignorată.
Pentru citirea clară a codului, în loc de adevărat, puteți specifica orice șir, de exemplu "in_footer".
Implicit: fals
Să presupunem că doriți să conectați o copie CDN în loc de biblioteca jQuery din WordPress. Adăugați acest cod în fișierul functions.php al temei active:
# 2 Încărcați scriptul scriptaculos.
# 3 Înregistrați-vă și conectați propriul scenariu, care depinde de jQuery
Înregistrați și adăugați un script nou, care depinde de jquery (acest lucru va cauza, de asemenea, descărcarea jquery pe pagină):
# 4 Încărcați scriptul numai pentru tipurile de pagini dorite
Să presupunem că trebuie să folosim etichete condiționate pentru a încărca scriptul nostru scriptaculos. Apoi ne putem conecta la cârligul wp. la momentul de funcționare trebuie să folosim etichete condiționate, astfel încât prin el putem determina ce tipuri de pagini pentru a conecta script-ul, și care nu:
# 5 Încărcați scriptul în temă, în funcție de script-ul din WordPress
# 6 Descărcați script-urile plugin-ului numai în paginile sale
# 7 Cum se conectează jquery de la Google
# 8 Detectarea versiunii dinamice a fișierului
Deci, atunci când modificați URL-ul fișierului este diferit și este încărcat în browser-ul ca un nou, și nu a efectuat cache-ul, ceea ce simplifică foarte mult designul, puteți specifica versiunea fișierului este în mod dinamic, pe timpul unei schimbări de fișier:
filemtime Performance (get_theme_file_path ( 'js / custom_script.js')) este foarte mare - de pe disc SSD de 0,5 secunde pe 50k iterații - este foarte rapid!
jQuery în modul noConflict
Biblioteca jQuery inclusă în WordPress este încărcată în modul "fără conflict". Acest lucru se face pentru a preveni problemele de compatibilitate cu alte biblioteci care pot fi încărcate în WordPress.
În modul "no-confict", comanda rapidă $ nu este disponibilă, în schimb se folosește cuvântul jQuery. De exemplu:
Acest cod nu va funcționa și trebuie modificat astfel:
Pentru a utiliza funcția $ ca de obicei, puteți împacheta codul astfel:
În acest fragment, codul dvs. va fi executat atunci când pagina este încărcată complet. Dacă din anumite motive doriți ca codul să fie executat imediat (fără a aștepta evenimentul "gata" din DOM), puteți utiliza acest fragment:
Scripturi care vin cu WordPress