Een walkthrough op voorwaardelijke tags in WordPress 1 tot 13

In het eerste deel van deze serie hebben we de basisprincipes van voorwaardelijke tags besproken - wat ze zijn, hoe ze te gebruiken en enkele scenario's waarbij voorwaardelijke tags van pas komen.

In dit tweede deel gaan we 13 voorwaardelijke tags beoordelen en in vijf artikelen (inclusief deze) voltooien we alle 65 voorwaardelijke tags die in de Codex zijn gedocumenteerd. Zorg ervoor dat je het eerste deel bekijkt als je dat nog niet hebt gedaan.

Laten we beginnen!

1. Controleren of we in de "Blog Posts Index-pagina" zijn: is thuis()

Deze slecht genoemd Voorwaardelijke tag controleert of de indexpagina van de blogpost wordt weergegeven. In de oudheid, toen WordPress slechts een "blogplatform" was, betekende de "startpagina" de lijst met uw laatste blogberichten. Maar nadat WordPress uitgroeide tot een content management systeem, de naam is thuis() werd een beetje verouderd.

Geaccepteerde parameters

Deze voorwaardelijke tag accepteert geen parameters.

Gebruik Voorbeeld voor is thuis()

Stel dat u uw bezoekers op de startpagina wilt begroeten. Dit is wat je doet:

2. Controleren of het huidige thema een kindthema is: is_child_theme ()

Tijdens het ontwikkelen met WordPress moet u mogelijk controleren of een kindthema in gebruik is. Als dat het geval is, is de voorwaardelijke tag is_child_theme () zal je helpen door terug te keren TRUE of VALSE wanneer een kindthema wordt gebruikt of niet.

Geaccepteerde parameters

Deze voorwaardelijke tag accepteert geen parameters.

3. Controleren of de post in de gegeven categorie is: in_category ()

In een WordPress-project wilt u misschien dat berichten van verschillende categorieën zich anders gedragen. U kunt bijvoorbeeld klassen aan bepaalde berichten toevoegen of deze berichten volledig verbergen voor de algemene berichtvermeldingen. De voorwaardelijke tag in_category () kunt u bepalen welke berichten in een bepaalde categorie of categorieën zijn gepubliceerd.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft twee parameters:

  • $ categorie (array / string, vereist): Categorie-ID, naam, slug of een array daarvan. (Standaard: Geen)
  • $ bericht (object / geheel getal, optioneel): het bericht (ID of object) om te controleren. (Standaard: Huidige bericht)

Gebruik Voorbeeld voor in_category ()

Laten we zeggen dat je een blog hebt met veel categorieën, waaronder 'Aankondigingen', en je wilt dat de updates verschijnen tussen andere berichten, dus je wilt een aangepaste klasse toevoegen aan de berichtverpakking. Dit is wat je doet:

 

">

'. __ ('Sorry, geen berichten voldeden aan uw criteria.', 'Vertaaldomein'). '

'; ?>

4. Controleren of een "paginasjabloon" in gebruik is: is_page_template ()

Paginasjablonen is een WordPress-functie waarmee u kunt kiezen hoe bepaalde pagina's worden weergegeven. Met de hulp van de voorwaardelijke tag is_page_template (), u kunt detecteren of een bepaalde paginasjabloon (of ieder Paginasjabloon) is in gebruik.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ template (string, optioneel): Sjabloonnaam - met extensie. (Standaard: Geen)

5. Controleren of de pagina een archiefpagina is: is_archive ()

Er zijn veel soorten archieven op een WordPress-website: datumarchieven, categoriearchieven, tagarchieven, auteursarchieven, aangepaste taxonomiearchieven ... Maar als u archiefpagina's in het algemeen wilt detecteren, is_archive () is je vriend: het controleert of een archiefpagina wordt weergegeven.

Geaccepteerde parameters

Deze voorwaardelijke tag accepteert geen parameters.

Gebruik Voorbeeld voor is_archive ()

Stel dat u posttitels wilt toevoegen met wat tekst op archiefpagina's. Dit is wat je doet:

6. Controleren of de pagina een pagina met 'datumarchieven' is: is_date ()

Zoals ik al eerder zei, zijn er vele soorten archiefpagina's en datumarchieven zijn er een van. Datumarchieven kunnen worden gescheiden in jaarlijkse, maandelijkse en dagelijkse archieven; maar als u datuminputpagina's in het algemeen wilt detecteren, kunt u de is_date () Voorwaardelijke tag.

Geaccepteerde parameters

Deze voorwaardelijke tag accepteert geen parameters.

7. Controleren of de gegeven widget in gebruik is: is_active_widget ()

Het maken van widgets in WordPress is gemakkelijk en leuk, maar we moeten mogelijk bepalen of de widget al dan niet in gebruik is aan de voorkant. De voorwaardelijke tag is_active_widget () doet precies dat: het controleert of de widget wordt weergegeven.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft vier parameters:

  • $ callback (string, optioneel): Widget-callback om te controleren. (Standaard: VALSE)
  • $ WIDGET_ID (integer, optioneel): Widget's ID. (Standaard: Geen)
  • $ id_base (string, optioneel): Base ID van een widget gemaakt door WP_Widget uit te breiden. (Standaard: Geen)
  • $ skip_inactive (boolean, optioneel): Of inactieve widgets al dan niet worden overgeslagen. (Standaard: TRUE)

Gebruik Voorbeeld voor is_active_widget ()

Laten we zeggen dat voor een widget in uw thema jQuery moet worden uitgevoerd en dat u deze voorwaardelijk moet inlijven. Dit is wat je doet:

id_base, true)) wp_enqueue_script ('jQuery'); ?>

8. Controleren of de pagina één blogpagina is: is vrijgezel()

Wilt u controleren of de gebruiker één bericht bezoekt? Een van de meest populaire voorwaardelijke tags, is vrijgezel(), kan jou helpen. Het kan elk berichttype detecteren, met uitzondering van bijlagepagina's en paginapagina's. En als u een bericht-ID, een berichttitel of een berichtslak (of een reeks daarvan) opgeeft, kunt u specifieke berichten ook detecteren.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ bericht (array / string, optioneel): post-ID, titel, slug of een reeks daarvan. (Standaard: Geen)

9. Controleren of het e-mailadres zich in de tabel Gebruikers bevindt: email bestaat()

Als u een e-mailadres moet controleren om te zien of het in de tabel met gebruikers van WordPress staat, kunt u de email bestaat() Voorwaardelijke tag.

Deze specifieke voorwaardelijke tag is een van de drie voorwaardelijke tags die iets anders retourneert dan TRUE-het geeft de ID terug van de gebruiker die zich bij het opgegeven e-mailadres heeft geregistreerd.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ e-mail (string, optioneel): e-mailadres om te controleren. (Standaard: Geen)

Gebruik Voorbeeld voor email bestaat()

Laten we zeggen dat u een plug-in ontwikkelt die een e-maillijst opbouwt op basis van de e-mailadressen van de gebruikers en waarmee u meer e-mailadressen met aangepaste invoer kunt toevoegen en verwijderen, maar u wilt voorkomen dat e-mailadressen die bij gebruikers horen worden verwijderd. Dit is wat je doet:

10. Controleren of het berichttype hiërarchisch is: is_post_type_hierarchical ()

Net als pagina's en subpagina's, kunt u definiëren hiërarchie voor nieuwe aangepaste berichttypen in WordPress. En de voorwaardelijke tag is_post_type_hierarchical () laat uw code weten of het gegeven berichttype hiërarchisch is of niet.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ post_type (string, verplicht): naam van het berichttype. (Standaard: Geen)

11. Controleren of de post "plakkerig" is: is_sticky ()

Een "Sticky Post" is een bericht dat bovenaan het bericht blijft staan, ongeacht wanneer het is gepubliceerd. En - ik zal hier een beetje discriminerend zijn - ze verdienen een andere behandeling dan andere, gewoon berichten. Dus als u een postklasse wilt toevoegen aan plaknotities, of ze op een andere manier wilt behandelen, kunt u uw code laten detecteren door de postklasse te gebruiken. is_sticky () Voorwaardelijke tag.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ post_id (string, optioneel): de ID van de post. (Standaard: Geen)

Gebruik Voorbeeld voor is_sticky ()

Laten we zeggen dat u een thema maakt en dat u een "STICKY" -lint in plaknotities wilt weergeven. Dit is wat je doet:

'; ?>

12. Controleren of het administratiepaneel wordt weergegeven: is_admin ()

Sta ons toe te weten of we aan de voorkant of aan de achterkant zitten, de voorwaardelijke tag is_admin () is een van de meest populaire voorwaardelijke tags van allemaal. Zoals de naam al doet vermoeden, is_admin controleert of het WordPress-beheerpaneel wordt weergegeven.

Geaccepteerde parameters

Deze voorwaardelijke tag accepteert geen parameters.

13. Controleren of de pagina een "Categoriearchieven" -pagina is: is_category ()

Wanneer u bepaalde categoriearchiefpagina's wilt detecteren, kunt u de voorwaardelijke tag gebruiken is_category (). Als u een categorie (of een reeks categorieën) als parameter definieert, kunt u controleren of de archieven van die categorieën worden weergegeven. Als u de parameter niet instelt, zal deze terugkeren TRUE wanneer ieder categorie archiefpagina wordt weergegeven.

Geaccepteerde parameters

Deze voorwaardelijke tag heeft slechts één parameter:

  • $ categorie (string / array, optioneel): Category ID, title, slug of een array daarvan. (Standaard: Geen)

Gebruik Voorbeeld voor is_category ()

Stel dat u een andere zijbalk wilt opnemen wanneer de categoriearchieven "Nieuws" worden weergegeven. Dit is wat je doet:

Conclusie

In dit deel hebben we 13 van de 65 gedocumenteerde voorwaardelijke tags in WordPress beoordeeld. In de volgende delen gaan we door de resterende 52. Als je vragen of opmerkingen hebt, kun je deze hieronder opnemen. Als je dit artikel leuk vindt, vergeet dan niet om het te delen.!

Zie je in het volgende deel!