Un Walkthrough privind etichetele condiționate în WordPress de la 1 la 13

În prima parte a acestei serii, am trecut prin elementele fundamentale ale etichetelor condiționate - ce sunt, cum să le folosiți și unele scenarii în care etichetele condiționate vin la îndemână.

În această a doua parte, vom începe să revizuim 13 etichete condiționate, iar în cinci articole (inclusiv pe aceasta), vom termina toate cele 65 de etichete condiționate care sunt documentate în Codul. Asigurați-vă că ați verificat prima parte dacă nu ați făcut-o încă.

Sa incepem!

1. Verificarea Indiferent dacă suntem în "Index Index Posts": este acasa()

Acest prost numit Eticheta Condiționată verifică dacă pagina de indexare a postărilor de blog este afișată. În vremurile vechi, când WordPress era doar o "platformă de blogging", "pagina de pornire" însemna lista celor mai recente postări pe blog. Dar după ce WordPress a devenit un sistem de gestionare a conținutului, numele este acasa() a devenit cam învechit.

Parametrii acceptați

Această etichetă condiționată nu acceptă parametri.

Exemplu de utilizare pentru este acasa()

Să presupunem că doriți să vă salutați vizitatorii pe pagina de pornire. Iată ce faceți:

2. Verificarea dacă tema curentă este o temă pentru copil: is_child_theme ()

În timp ce se dezvoltă cu WordPress, poate fi necesar să verificați dacă o temă copil este în uz. În acest caz, eticheta condiționată is_child_theme () vă va ajuta prin întoarcere ADEVĂRAT sau FALS atunci când o temă copil este utilizată sau nu.

Parametrii acceptați

Această etichetă condiționată nu acceptă parametri.

3. Verificarea dacă postul este în categoria dată: in_category ()

Într-un proiect WordPress, este posibil să doriți ca postările din diferite categorii să se comporte diferit. De exemplu, este posibil să doriți să adăugați clase la anumite postări sau să ascundeți aceste postări din totalul postărilor generale. Eticheta condiționată in_category () vă permite să determinați posturile publicate într-o anumită categorie sau categorie.

Parametrii acceptați

Această etichetă condiționată are doi parametri:

  • categorie $ (matrice / șir, este necesar): ID-ul categoriei, numele, slug sau o matrice din acestea. (Implicit: Niciuna)
  • $ postare (obiect / intreg, opțional): postul (ID sau obiectul) pentru a verifica. (Implicit: post curent)

Exemplu de utilizare pentru in_category ()

Să presupunem că aveți un blog cu o mulțime de categorii, unul fiind "Anunțuri" și doriți ca actualizările să apară printre celelalte postări, deci doriți să adăugați o clasă personalizată în pachetul de postări. Iată ce faceți:

 

„>

". __ ("Ne pare rău, niciunul nu corespunde criteriilor dvs.", "domeniu de traducere"). '

„; ?>

4. Verificarea dacă se utilizează un "Șablon de pagină": is_page_template ()

Șabloanele de pagină este o funcție WordPress care vă permite să alegeți modul în care vor fi afișate anumite pagini. Cu ajutorul etichetei condiționate is_page_template (), puteți afla dacă un anumit șablon de pagină (sau orice Șablon de pagină) este în uz.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • șablon $ (șir, opțional): numele șablonului - cu extensie. (Implicit: Niciuna)

5. Verificarea dacă pagina este o pagină de arhivă: is_archive ()

Există multe tipuri de arhive într-un site WordPress: arhive date, arhive categorii, arhive de etichete, arhive autor, arhive taxonomice personalizate ... Dar dacă doriți să detectați paginile de arhivă în general, is_archive () este prietenul tău: verifică dacă este afișată o pagină de arhivă.

Parametrii acceptați

Această etichetă condiționată nu acceptă parametri.

Exemplu de utilizare pentru is_archive ()

Să presupunem că doriți să prefixați titlul postului cu un text în paginile de arhivă. Iată ce faceți:

6. Verificarea dacă pagina este o pagină "Data arhivelor" Pagina: is_date ()

După cum am spus mai devreme, există multe tipuri de pagini de arhivă, iar arhivele date sunt una dintre ele. Arhivele de date pot fi separate în arhive anuale, lunare și zilnice; dar dacă doriți să detectați paginile arhivelor de date, în general, puteți folosi is_date () Etichetă condiționată.

Parametrii acceptați

Această etichetă condiționată nu acceptă parametri.

7. Verificarea dacă Widget-ul dat este utilizat: is_active_widget ()

Crearea widget-urilor în WordPress este ușoară și amuzantă, însă este posibil să fie necesar să determinați dacă miniaplicația este utilizată la capătul frontal sau nu. Eticheta condiționată is_active_widget () face exact asta: Verifică dacă widget-ul este afișat.

Parametrii acceptați

Această etichetă condiționată are patru parametri:

  • $ apel invers (șir, opțional): apel invers widget pentru a verifica. (Mod implicit: FALS)
  • $ WIDGET_ID (întreg, opțional): ID-ul widgetului. (Implicit: Niciuna)
  • $ id_base (șir, opțional): ID-ul de bază al unui widget creat prin extinderea WP_Widget. (Implicit: Niciuna)
  • $ skip_inactive (boolean, opțional): să ignore widget-urile inactive sau nu. (Mod implicit: ADEVĂRAT)

Exemplu de utilizare pentru is_active_widget ()

Să presupunem că un widget în tema dumneavoastră necesită jQuery pentru a rula, și trebuie să-l enqueue condițional. Iată ce faceți:

id_base, adevărat)) wp_enqueue_script ('jquery'); ?>

8. Verificarea dacă pagina este o pagină a unui singur blog: este singur()

Doriți să verificați dacă utilizatorul vizitează o singură postare? Una dintre cele mai populare etichete condiționate, este singur(), vă poate ajuta. Poate detecta orice tip de post, cu excepția paginilor atașate și paginilor de pagină. Și dacă specificați un ID post, un titlu post sau un post slug (sau o serie de acelea), puteți detecta și anumite postări.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • $ postare (matrice / șir, opțional): ID-ul postului, titlu, slug sau o serie de ele. (Implicit: Niciuna)

9. Verificarea dacă există adresa de e-mail în tabelul Utilizatori: email-ul exista()

Dacă trebuie să verificați o adresă de e-mail pentru a vedea dacă este în tabelul utilizatorilor WordPress, puteți utiliza email-ul exista() Etichetă condiționată.

Acest etichetă specială condiționată este una dintre cele trei etichete condiționate care returnează altceva decât ADEVĂRAT-returnează ID-ul utilizatorului care sa înregistrat la adresa de e-mail dată.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • $ e-mail (șir, opțional): Adresa de e-mail pentru a verifica. (Implicit: Niciuna)

Exemplu de utilizare pentru email-ul exista()

Să presupunem că dezvoltați un plugin care construiește o listă de e-mail de la adresele de e-mail ale utilizatorilor și vă permite să adăugați și să eliminați mai multe adrese de e-mail cu intrări personalizate, dar doriți să împiedicați ștergerea adreselor de e-mail care aparțin utilizatorilor. Iată ce faceți:

10. Verificarea dacă tipul de post este ierarhic: is_post_type_hierarchical ()

Ca pagini și subpagini, puteți defini ierarhie pentru noi tipuri de posturi personalizate în WordPress. Și eticheta condiționată is_post_type_hierarchical () vă permite să aflați dacă tipul postului dat este ierarhic sau nu.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • $ post_type (șir, obligatoriu): numele tipului de post. (Implicit: Niciuna)

11. Verificarea dacă mesajul este "lipicios": is_sticky ()

Un mesaj "Sticky Post" este un post care rămâne în partea de sus a înregistrărilor post, indiferent când a fost publicat. Și - voi fi puțin discriminatoriu aici - merită un tratament diferit de celălalt, comun posturi. Deci, dacă doriți să adăugați o clasă post la postări lipicioase sau să le tratați într-un mod diferit, puteți face codul să le detecteze utilizând is_sticky () Etichetă condiționată.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • $ POST_ID (șir, opțional): ID-ul postului. (Implicit: Niciuna)

Exemplu de utilizare pentru is_sticky ()

Să presupunem că faceți o temă și doriți să afișați o panglică "STICKY" în postări lipicioase. Iată ce faceți:

„; ?>

12. Verificarea dacă este afișat panoul de administrare: is_admin ()

Permiteți-ne să aflăm dacă suntem în partea din față sau în spate, eticheta condiționată is_admin () este unul dintre cele mai populare Tag-uri Condiționate printre toate. Așa cum sugerează și numele, is_admin verifică dacă se afișează panoul de administrare WordPress.

Parametrii acceptați

Această etichetă condiționată nu acceptă parametri.

13. Verificarea dacă pagina este o pagină "Categorii de arhivă" is_category ()

Când doriți să detectați anumite pagini de arhivă de categorii, puteți utiliza eticheta condiționată is_category (). Definind o categorie (sau o serie de categorii) ca parametru, puteți verifica dacă arhivele categoriilor respective sunt afișate. Dacă lăsați parametrul dezactivat, acesta va reveni ADEVĂRAT cand orice arhiva pagină este afișată.

Parametrii acceptați

Această etichetă condiționată are un singur parametru:

  • categorie $ (șir / matrice, opțional): ID-ul categoriei, titlu, slug sau o serie de elemente. (Implicit: Niciuna)

Exemplu de utilizare pentru is_category ()

Să presupunem că doriți să includeți o altă bara laterală atunci când se afișează arhiva categoriei "Știri". Iată ce faceți:

Concluzie

În această parte, am revizuit 13 dintre cele 65 de etichete condiționate documentate în WordPress. În următoarele părți, vom trece prin restul de 52. Dacă aveți întrebări sau comentarii, trageți-le mai jos - și dacă vă plac acest articol, nu uitați să le partajați!

Ne vedem în următoarea parte!

Cod