O instrucțiune despre etichetele condiționate în WordPress 27 - 39

În această serie, trecem printr-una din trăsăturile fundamentale ale WordPress: Etichete condiționate. În această a patra 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!

27. Verificarea dacă pagina este o pagină "Arhive lunare" is_month ()

În WordPress, cel mai frecvent utilizat tip de arhivă bazat pe date este probabil arhiva lunară. Când trebuie să detectați dacă codul dvs. rulează într-o pagină de arhivă lunară, eticheta condiționată is_month () te va ajuta.

Parametrii acceptați

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

28. Verificarea funcțiilor temei curente: current_theme_supports ()

În timp ce dezvoltați pluginuri, este posibil să fie necesar să verificați dacă tema activă permite miniaturi, formate postate, anteturi personalizate sau chiar widget-uri. Cu ajutorul current_theme_supports (), puteți verifica dacă tema utilizată acceptă caracteristica pe care o specificați.

Parametrii acceptați

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

  • caracteristică $ (șir, opțional): numele caracteristicilor. (Implicit: Niciuna)

Nume de nume:

  • 'post-miniaturile'
  • 'post-formate'
  • 'Custom-header'
  • 'fundal personalizat'
  • „meniuri“
  • 'automat-feed-link-uri'
  • „Stil editor“
  • „widget-uri“
  • '' html5

Exemplu de utilizare pentru current_theme_supports ()

Să presupunem că dezvoltați un plugin special pentru teme WordPress cu funcția "fundaluri personalizate". Pluginul dvs. va fi inutil pentru teme care nu acceptă medii personalizate, prin urmare trebuie să afișați un mesaj de eroare în panoul de administrare pentru a informa utilizatorul. Iată ce faceți:

 

". __ ('Acest plugin necesită o temă cu caracteristica "particularități personalizate" activată.', 'Domeniu de traducere'). '

„; ?>

29. Verificarea dacă plugin-ul specificat este activ: is_plugin_active ()

Lucrând numai în panoul de administrare, eticheta condiționată is_plugin_active () vă ajută codul să știe dacă pluginul dat este activ. Acest etichetă condiționată poate fi utilă dacă scrieți pluginuri addon pentru pluginuri populare (cum ar fi WooCommerce) sau cadre de bază instalate ca pluginuri (cum ar fi Redux Framework).

Parametrii acceptați

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

  • $ plugin (șir, necesar): numele plugin-ului sau al sub-directorului. (Implicit: Niciuna)

30. Verificarea dacă adresa URL este un atasament local: is_local_attachment ()

Articolele WordPress sunt o binecuvântare atunci când sunt utilizate corect, dar cum afli dacă o adresă URL este de fapt un atașament? Dacă lucrați cu adrese URL în curs de dezvoltare, eticheta condiționată is_local_attachment () ar putea fi foarte util pentru dvs.: verifică dacă adresa URL dată este încărcată în aceeași instalare WordPress ca atașament.

Parametrii acceptați

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

  • $ url (șir, necesar): Adresa URL pentru a verifica. (Implicit: Niciuna)

Exemplu de utilizare pentru is_local_attachment ()

Deoarece această etichetă condiționată este destul de simplă, exemplul va fi simplu. Imaginați-vă că dezvoltați un plugin și că trebuie să verificați URL-urile (generate de o altă funcție pe care ați creat-o) pentru a vedea dacă acestea sunt atașamente locale sau nu:

31. Verificarea dacă pagina este o pagină de arhivă bazată pe timp: este timpul()

Știați că WordPress are arhive bazate pe oră, minute și chiar pe al doilea rând? (Pentru a fi sincer, nu știam că puteți crea astfel de arhive înainte de a scrie această serie. Scrierea la Tuts + poate fi și o călătorie educațională!) 

Nu iese din cutie, ceea ce înseamnă că nu poți introduce mywebsite.com/2014/02/22/18/30/ și primiți arhivele la ora 18:30 pe 22 februarie 2014; dar puteți crea unul cu ajutorul WP_Query clasă. Oricum: Dacă doriți să detectați aceste tipuri de arhive bazate pe timp, puteți utiliza este timpul() Etichetă condiționată.

Parametrii acceptați

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

32. Verificarea faptului dacă localizarea curentă este RTL: is_rtl ()

În unele limbi, mai ales în țările din Orientul Mijlociu, textul este scris de la dreapta la stânga în loc de stânga spre dreapta. Ca dezvoltator WordPress, trebuie să luați în considerare toți utilizatorii WordPress și dacă doriți ca tema sau pluginul să funcționeze bine cu site-urile WordPress cu text RTL, trebuie să utilizați is_rtl () pentru a determina dacă localitatea este RTL.

Parametrii acceptați

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

Exemplu de utilizare pentru is_rtl ()

Majoritatea designerilor web creează foi de stiluri separate pentru localizările RTL - este o practică obișnuită. Și dacă doriți să încărcați condiționată foaia dvs. de stil RTL, iată ce faceți:

33. Verificarea dacă pagina este o "arhivă" a unei taxonomii personalizate Pagina: is_tax ()

Eticheta condiționată is_tag () poate detecta arhivele de etichete, dar nu poate funcționa cu taxonomii personalizate. Pentru a determina dacă este afișată o pagină de arhivă taxonomică, puteți utiliza is_tax (). Implicit, aceasta include toate paginile de arhivă din taxonomie, inclusiv etichetele regulate. Dar are doi parametri, astfel încât să puteți viza anumite pagini arhivate de taxonomie sau chiar termeni specifici.

Parametrii acceptați

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

  • $ taxonomie (matrice / șir, opțional): Taxonomie slug sau o serie de țesătoare. (Implicit: Niciuna)
  • termenul $ (array / string / integer, opțional): numele ID-ului, numele, slug-ul sau o matrice. (Implicit: Niciuna)

34. Verificarea dacă pagina este o pagină atașată: is_attachment ()

În timp ce creați un plugin (sau o temă), vă recomandăm să știți când se afișează o pagină de atașament. Eticheta condiționată is_attachment () este cel care vă va ajuta: Se întoarce ADEVĂRAT într - o pagină de atașament și FALS oriunde altundeva.

Parametrii acceptați

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

Exemplu de utilizare pentru is_attachment ()

Să presupunem că doriți să afișați un link "Înapoi la postare" deasupra atașamentului. Iată ce faceți:

35. Verificarea existenței termenului dat: term_exists ()

Acesta este cel de-al doilea etichetă condiționată care nu se întoarce ADEVĂRAT și FALS, dar mai multe informații utile: eticheta condiționată term_exists () verifică dacă există un termen al unei taxonomii și returnează termenul ID (dacă nu este specificată nici o taxonomie) sau o matrice a taxonomiei și asocierii termenilor în loc de ADEVĂRAT. Dacă termenul specificat nu există, acesta se întoarce 0 sau NUL.

Parametrii acceptați

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

  • termenul $ (șir / număr întreg, necesar): Numele sau ID-ul termenului. (Implicit: Niciuna)
  • $ taxonomie (șir, opțional): numele taxonomiei. (Implicit: Gol)
  • $ părinte (întreg, opțional): ID-ul termenului părinte (pentru a limita căutarea în cadrul acestuia). (Implicit: 0)

36. Verificarea faptului dacă postul are termenul dat: has_term ()

Am văzut că am putea folosi has_tag () dacă vrem să găsim o etichetă într-un post. Dacă am vrea să facem același lucru, dar cu un termen de taxonomie particularizată? Ușor: eticheta condiționată has_term () are un al treilea parametru (al doilea în ordine) care ne permite să specificăm o taxonomie particularizată. 

Fun fact: Chiar și eticheta condiționată has_tag () utilizări has_term () a se intoarce ADEVĂRAT sau FALS! Și ca și cu has_tag () funcţie, has_term () vă permite să specificați mai mult de un termen (dar numai într-o singură taxonomie).

Parametrii acceptați

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

  • termenul $ (array / string / integer, opțional): numele Term, ID, slug sau o serie de elemente. (Implicit: Gol)
  • $ taxonomie (șir, necesar): numele taxonomiei. (Implicit: Gol)
  • $ postare (obiect / intreg, opțional): Post pentru a verifica. (Mod implicit: NUL)

Exemplu de utilizare pentru has_term ()

Să presupunem că rulați un site web de comerț electronic și că veți schimba furnizorul dvs. pentru laptopurile Dell, deci doriți să informați utilizatorii dvs. că transporturile vor fi amânate până săptămâna viitoare. Iată ce faceți:

". __ ("Atenție", "domeniu de traducere"). „: ". __ ("Vom schimba furnizorii pentru laptop-uri Dell, astfel încât expedițiile vor fi amânate până săptămâna viitoare. Îmi pare rău!", "Domeniu de traducere"). '
„; ?>

37. Verificarea dacă este un trackback (și suntem în 2007): is_trackback ()

Salutări, vechi! Vrei să afli dacă un comentariu este un "trackback"? is_trackback () Eticheta cu condiție vă va ajuta în acest sens!

Parametrii acceptați

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

38. Verificarea dacă "WordPress Multisite" este în uz: is_multisite ()

În timp ce este o caracteristică nu-așa-populară a WordPress, Multisite vine foarte util când este necesar. Dacă doriți ca codul dvs. să ruleze în instalări normale WordPress și să se comporte diferit în instalațiile Multisite, eticheta condiționată is_multisite () vă poate ajuta să aflați dacă este activat suportul Multisite.

Parametrii acceptați

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

Exemplu de utilizare pentru is_multisite ()

Să presupunem că dezvoltați un plugin, iar dacă Multisite este activat, pluginul cere o altă clasă din plugin. Iată ce faceți:

39. Verificarea dacă pagina este o arhivă de tip (ele) de postare: is_post_type_archive ()

Uneori, este posibil ca codul dvs. să știe dacă o pagină de arhivă pentru un tip de post personalizat (sau câteva tipuri personalizate de postări sau orice tipul postului personalizat). Eticheta condiționată is_post_type_archive () face exact asta: verifică dacă interogarea este pentru o pagină de arhivă pentru un tip de post personalizat.

Parametrii acceptați

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

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