O instrucțiune despre etichetele condiționate în WordPress 14 - 26

În această serie, trecem printr-una din trăsăturile fundamentale ale WordPress: Etichete condiționate. În această a treia parte, vom continua să introducem și să revizuim etichetele condiționate. Asigurați-vă că ați verificat părțile anterioare dacă nu ați făcut-o încă.

Sa incepem!

14. Verificarea dacă suntem pe prima pagină: is_front_page ()

În WordPress, "prima pagină" poate fi setată pe o pagină WordPress statică sau pe lista celor mai recente postări de blog (Setări> Citire). În orice caz, eticheta condiționată is_front_page () se intoarce ADEVĂRAT când se afișează prima pagină.

Parametrii acceptați

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

15. Verificarea dacă mesajul are o miniatură: has_post_thumbnail ()

Imaginile recomandate reprezintă una din părțile cheie ale ecranului New Post / Page. Eticheta condiționată has_post_thumbnail () determină dacă există sau nu o imagine atribuită pentru postarea dată.

Parametrii acceptați

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

  • $ POST_ID (întreg, opțional): ID-ul postului. (Implicit: Codul postului curent)

Exemplu de utilizare pentru has_post_thumbnail ()

Să presupunem că dezvoltați o temă și că în fiecare post de blog trebuie să aibă o "imagine prezentată", așa că doriți să afișați o "imagine implicită" dacă nu este setată nicio imagine specială. Iată ce faceți:

ID)) $ featured_image = get_the_post_thumbnail ($ post-> ID, "miniatură", array ('alt' => esc_attr ($ post_title), 'class' => $ class));  altceva $ featured_image = '„;  return $ featured_image;  / * * Utilizare (în buclă): * echo mytheme_featured_image ('my-custom-class'); * /?>

16. Verificarea dacă tema folosește "Popup-urile de comentarii": is_comments_popup ()

Nu ar trebui să judeci pe cineva care folosește o temă de 10 ani - sau iubește retro. Dacă dezvoltați un plugin, trebuie să țineți cont de toate lucrurile și acesta include teme care utilizează fereastra pop-up a comentariilor. Pentru a determina acest lucru, puteți utiliza eticheta condiționată is_comments_popup ().

Parametrii acceptați

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

17. Verificarea dacă pagina este o pagină de eroare 404: is_404 ()

Paginile de eroare "Nu au fost găsite" sunt, de obicei, cele pe care nu le place să le vedem pe site-urile noastre și, prin urmare, nu ne pasă cum arată. Dar când utilizați corect aceste pagini de eroare, le puteți transforma în pagini utile care informează utilizatorii sau îi ajută să navigheze. Eticheta condiționată is_404 () ne ajută să determinăm dacă o eroare 404 este afișată utilizatorului.

Parametrii acceptați

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

Exemplu de utilizare pentru is_404 ()

Să presupunem că dezvoltați un plugin care înregistrează link-uri interne rupte și doriți ca funcția dvs. să ruleze de fiecare dată când este vizualizată o pagină de eroare 404. Iată ce faceți:

18. Verificarea existenței taxonomiei date: taxonomy_exists ()

Dacă vreodată trebuie să verificați dacă o taxonomie personalizată este deja înregistrată, puteți folosi taxonomy_exists () Etichetă pentru a vă determina codul.

Parametrii acceptați

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

  • $ taxonomie (șir, necesar): numele taxonomiei. (Implicit: Niciuna)

19. Verificarea dacă pagina este "Rezultatele căutării" Pagina: is_search ()

În timp ce este puțin subevaluat, paginile "Rezultatele căutării" reprezintă o parte importantă a site-urilor WordPress. Și dacă dezvoltați un plugin sau o temă, puteți detecta aceste pagini cu ajutorul is_search () Etichetă condiționată.

Parametrii acceptați

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

Exemplu de utilizare pentru is_search ()

Să presupunem că doriți să includeți un link pentru o căutare Google cu aceiași termeni. Iată ce faceți:

". __ ("Căutați cu Google", "domeniu de traducere"). ''; ?>

20. Verificarea dacă pagina este o pagină "Tag Archives": is_tag ()

Doriți să tratați arhivele de etichete diferit? Eticheta condiționată is_tag () vă poate ajuta cu asta. Doriți să tratați în mod diferit anumite etichete? Introduceți doar un nume de etichetă, un blocaj sau un ID (sau o matrice din acestea) ca parametru!

Parametrii acceptați

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

  • $ tag-ul (matrice / șir, opțional): ID-ul, numele, ghilimele sau un șir de caractere. (Implicit: Niciuna)

21. Verificarea dacă postul are un extras personalizat: has_excerpt ()

Există două tipuri de "fragmente" în posturile WordPress: dacă doriți să scrieți unul singur, se numește un "extras personalizat", iar dacă nu faceți acest lucru, se generează un "extras automat" (în mod implicit, este primul 55 cuvintele postului). has_excerpt () Eticheta Condiționată verifică dacă utilizatorul a setat un extras personalizat pentru postarea respectivă.

Parametrii acceptați

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

  • $ POST_ID (întreg, opțional): ID-ul postului. (Implicit: Codul postului curent)

Exemplu de utilizare pentru has_excerpt ()

Să presupunem că faceți o temă și doriți să afișați extrase personalizate în pagina de pornire, dar nu doriți să afișați fragmente automate. Iată ce faceți:

22. Verificarea dacă este vorba de întrebarea principală: is_main_query ()

WordPress utilizează WP_Query clasa pentru a lista postările - fie că este vorba doar de o listă de titluri postale, fie de indexul postărilor complete dintr-o pagină de arhivă. Un număr de funcții utilizează funcția WP_Query clasă și is_main_query () este una dintre ele. Această etichetă condiționată detectează dacă interogarea nu este o "interogare secundară", ci "interogarea principală".

Parametrii acceptați

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

23. Verificarea dacă mesajul are eticheta dată: has_tag ()

Uneori, poate fi necesar să verificați dacă o postare are o etichetă pentru a face postarea (sau postările) să acționeze diferit decât altele. Pentru a realiza acest lucru, puteți utiliza has_tag () pentru a verifica dacă o postare este etichetată cu eticheta pe care o specificați. (Notă: vă permite să specificați mai multe etichete pe care să le căutați.)

Parametrii acceptați

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

  • $ tag-ul (matrice / șir, opțional): numele etichetei, ID-ul, slug sau o serie de elemente. (Implicit: Niciuna)
  • $ postare (obiect, opțional): Mesaj pentru a verifica. (Implicit: post curent)

Exemplu de utilizare pentru has_tag ()

Să presupunem că aveți "insigne" pentru postările de pe blog (cum ar fi "NOU", "FEATURED" și "OBSOLETE") care vor fi activate prin utilizarea etichetelor corespunzătoare și doriți să ecou imaginile din postări. Iată ce faceți:

„;  altfel dacă (has_tag ('featured featured')) echo '
„; altfel dacă (has_tag ('insigna-depășită')) echo '
„; altceva echo '
„; // Postați conținut. echo "
„; ?>

24. Verificarea dacă blogul este instalat (?): is_blog_installed ()

Acest etichetă condiționată particulară revine ADEVĂRAT dacă WordPress este instalat. Am inclus această etichetă condiționată doar pentru referință, deoarece din punct de vedere tehnic nu poate fi utilă pentru dezvoltatorii de plugin-uri sau tematici - ar putea fi folosit într-un instrument WordPress extern, poate.

Parametrii acceptați

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

25. Verificarea dacă utilizatorul este "Super Admin": is_super_admin ()

Într-o rețea Multisite, există un "super admin" care poate administra toate site-urile. Pentru a detecta dacă utilizatorul este un "super admin" (sau un administrator obișnuit în instalările obișnuite de WordPress), puteți utiliza is_super_admin () Etichetă condiționată.

Parametrii acceptați

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

  • $ user_id (întreg, opțional): ID-ul utilizatorului. (Implicit: Utilizator curent)

Exemplu de utilizare pentru is_super_admin ()

Să presupunem că nu vă place salutul "Howdy" și doriți să-l schimbați, dar utilizatorii dvs. îi plac și doresc să rămână. În acest caz, aveți nevoie de o soluție care să se aplice numai dvs. Iată ce faceți:

get_node ("contul meu"); $ newtitle = __ ("Bună ziua!", "domeniul de traducere"); $ wp_admin_bar-> add_node (array ('id' => 'meu-cont', 'titlu' => $ newtitle)); întoarcere $ wp_admin_bar; ?>

26. Verificarea dacă pagina este o pagină "Page": is_page ()

În WordPress, "paginile" sunt unul dintre cele cinci tipuri de posturi încorporate, împreună cu postări, revizii, atașamente și meniuri de navigare. Și dacă doriți să detectați o anumită pagină (sau orice pagină în general), puteți utiliza eticheta condiționată is_page ().

Parametrii acceptați

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

  • pagina $ (matrice / șir, opțional): ID-ul paginii, titlul, ghiveciul sau o serie de elemente. (Implicit: Niciuna)

Concluzie

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

Ne vedem în următoarea parte!

Cod