O instrucțiune despre etichetele condiționate în WordPress 53 la 65

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

Sa incepem!

53. Verificarea dacă pagina este fie o postare în blog, fie o pagină: is_singular ()

Nu știu de ce, dar asta e eticheta mea favorită: is_singular () poate detecta când se afișează orice tip de postare. Este în principiu o combinație a etichetelor condiționate este singur(), is_attachment () și is_page (). În plus, dacă setați un tip de postare (sau un set de tipuri de posturi) ca parametru, puteți detecta numai tipurile postate pe care le-ați setat.

Parametrii acceptați

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

  • $ post_types (matrice / șir, opțional): numele postului sau un șir de nume de tip post. (Implicit: Niciuna)

54. Verificarea dacă funcția lucrează în "buclă": în bucla()

Dacă spun că buclă este fundamentul WordPress în termeni de cod, puțini ar fi de acord. Astfel, eticheta condiționată în bucla() este unul dintre tag-urile Condiționale cheie și vă ajută să aflați dacă sunt sau nu în buclă.

Parametrii acceptați

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

Exemplu de utilizare pentru în bucla()

Să presupunem că plugin-ul dvs. are o funcție trebuie sa executați în buclă, dar doriți, de asemenea, să afișați o eroare în codul sursă al paginii dacă utilizatorul îl folosește în afara buclă. Iată cum construiți funcția:

my_awesome_plugin_function () ". __ ("funcția pluginului" Pluginul meu minunat "trebuie să ruleze în interiorul WordPress Loops!", "domain translation"). "->";  altceva // Rulați codul minunat pentru că suntem în buclă! ?>

55. Verificarea dacă pluginul specificat este inactiv: is_plugin_inactive ()

Puteți ghici ce înseamnă această etichetă condiționată prin numele ei: Definiți ca "negarea logică a is_plugin_active ()"în Codul, is_plugin_inactive () verifică dacă pluginul dat este instalat, dar nu activat.

Parametrii acceptați

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

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

56. Verificarea dacă pagina este o pagină "Autor Archives" is_author ()

Î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ă are un singur parametru:

  • $ autor (șir / număr întreg, opțional): numele de utilizator sau ID-ul autorului. (Implicit: Niciuna)

Exemplu de utilizare pentru is_author ()

Să presupunem că dezvoltați un plugin pentru Google Analytics și doriți să setați o "variabilă personalizată" pentru a detecta arhivele autorului. Iată ce faceți:

57. Verificarea dacă ne aflăm într-o pagină "Înregistrare" paginată: is_paged ()

În paginile indexului de blog sau în paginile de arhivare, WordPress ne permite să folosim paginarea pentru a împărți postările în pagini consecutive. Cu ajutorul etichetei condiționate is_paged (), puteți face codul să detecteze dacă înregistrarea este "paginată" sau numărul paginii este mai mare de 1.

Parametrii acceptați

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

58. Verificarea dacă bara de instrumente WordPress se afișează: is_admin_bar_showing ()

Bara de instrumente WordPress, cunoscută anterior ca Admin Bar, este considerată utilă și enervantă în rândul comunității WordPress. Unii îl iubesc, unii îl urăsc, așa că eticheta condiționată is_admin_bar_showing () ar putea fi de folos tuturor: determină dacă bara de instrumente este afișată sau nu.

Parametrii acceptați

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

Exemplu de utilizare pentru is_admin_bar_showing ()

Să presupunem că doriți să extindeți Bara de instrumente cu unele stiluri CSS, dar trebuie să încărcați condiționată foaia de stil. Iată ce faceți:

59. Verificarea dacă pagina este o pagină "Arhivă zilnică": is_day ()

Arhivele zilnice sunt, probabil, cele mai puțin utilizate tipuri de arhive bazate pe date, dar asta nu înseamnă că sunt inutile - unele teme pot avea chiar șabloane diferite pentru arhivele zilnice. Deci, dacă doriți să detectați paginile de arhivă zilnice, puteți utiliza eticheta condiționată is_day () să-și facă treaba.

Parametrii acceptați

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

60. Verificarea dacă bara laterală dată este utilizată: is_active_sidebar ()

În timp ce creăm o temă, trebuie să luăm în considerare pe cei care nu folosesc widget-uri. Eticheta condiționată is_active_sidebar () verifică dacă bara laterală dată are widget-uri în ea.

Parametrii acceptați

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

  • $ bara laterală (șir / număr întreg): numele sau ID-ul barei laterale. (Implicit: Niciuna)

Exemplu de utilizare pentru is_active_sidebar ()

Acest exemplu vine de la tema Twenty Ten - folosește eticheta condiționată pentru a încărca condițional bara laterală dată:

 

61. Verificarea dacă există un nume de utilizator dat în tabelul utilizatorilor: username_exists ()

Al treilea etichetă condiționată care returnează altceva decât ADEVĂRAT atunci când este de succes username_exists (). Această etichetă condiționată verifică numele de utilizator dat și returnează ID-ul utilizatorului dacă există un utilizator cu numele de utilizator dat. Dacă nu, se întoarce NUL.

Parametrii acceptați

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

  • $ username (șir, necesar): numele de utilizator pentru a verifica. (Implicit: Niciuna)

62. Verificați dacă este vorba de pagina "Preview Preview" is_preview ()

Dacă aveți elemente de pagină care nu ar trebui să fie încărcate în previzualizări (cum ar fi anunțurile bazate pe afișări sau unele coduri de analiză sensibile), le puteți elimina cu ajutorul etichetei condiționate is_preview ().

Parametrii acceptați

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

Exemplu de utilizare pentru is_preview ()

Este o bună practică ascunde previzualizați pagini din Google Analytics, deci trebuie să fiți atenți și să includeți scriptul dvs. Google Analytics astfel:

  „; ?>

63. Verificarea stării scriptului dat: wp_script_is ()

Acest lucru este deosebit de util pentru dezvoltatorii de pluginuri care nu doresc ca scenariile lor să fie în conflict cu alte scripturi enqueued. Cu această etichetă condiționată, puteți detecta dacă scriptul dat este înregistrat, enqueued, enqueued și tipărite sau încleștate, dar nu tipărite încă.

Parametrii acceptați

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

  • $ mâner (șir, necesar): Numele scriptului (cu majuscule). (Implicit: Niciuna)
  • lista $ (șir, opțional): Unul dintre cele patru șiruri de caractere-„Înregistrat“, "Enqueued", "Terminat" (încorporate și tipărite) sau "a face" (incarcate, dar neimprimate). (Implicit: "încorporat")

64. Verificarea stării stilului dat: wp_style_is ()

Această etichetă condiționată este similară cu cea a fratelui său, wp_script_is (), dar face același lucru pentru foile de stil incapsulate. Cu această etichetă condiționată, puteți detecta dacă stilul dat este înregistrat, enqueued, enqueued și tipărite sau încleștate, dar nu tipărite încă.

Parametrii acceptați

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

  • $ mâner (șir, obligatoriu): Numele stilului (cu majuscule). (Implicit: Niciuna)
  • lista $ (șir, opțional): Unul dintre cele patru șiruri de caractere-„Înregistrat“, "Enqueued", "Terminat" (încorporate și tipărite) sau "a face" (incarcate, dar neimprimate). (Implicit: "încorporat")

Exemplu de utilizare pentru wp_style_is ()

Să presupunem că faceți o temă cu cadrul Bootstrap și ați creat o temă personalizată Bootstrap pe care să o includeți. Trebuie să vă asigurați că fișierele CSS principale ale Bootstrap sunt introduse mai întâi:

65. Verificarea dacă taxonomia este ierarhică: is_taxonomy_hierarchical ()

Stii ca categoriile sunt ierarhice - poti seta mamă și copil categorii. Același lucru este valabil și pentru taxonomiile personalizate, dacă le faci în timp ce le creați. Și dacă doriți ca codul dvs. să știe dacă o anumită taxonomie este ierarhică, puteți folosi codul is_taxonomy_hierarchical () Etichetă condiționată.

Parametrii acceptați

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

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

Concluzie

În această parte, am trecut prin ultimul lot din cele 65 de etichete condiționate documentate în WordPress. În următoarea (și ultima) parte a seriei, vom termina prin examinarea a ceea ce am învățat și a unei mici părți bonus care - sperăm - vă veți bucura.

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!

Cod