In deze serie doorlopen we een van de fundamentele kenmerken van WordPress: voorwaardelijke tags. In dit vijfde deel gaan we door met het introduceren en beoordelen van de voorwaardelijke tags. Zorg ervoor dat je de vorige delen bekijkt als je dat nog niet hebt gedaan.
Laten we beginnen!
is_main_site ()
Als u zich ontwikkelt voor WordPress Multisite, zal er uiteindelijk een moment komen waarop u de hoofdsite moet detecteren. De voorwaardelijke tag is_main_site
zal je dan helpen: Het bepaalt of de gegeven site-ID de belangrijkste site van het netwerk is.
Deze voorwaardelijke tag heeft slechts één parameter:
$ site_id
(integer, optioneel): de ID van de site om te controleren. (Standaard: huidige site-ID)has_nav_menu ()
Terwijl u een aangepast navigatiemenu maakt, moet u een "menulocatie" opgeven met de twee parameters van de register_nav_menu (s)
functie (s). De voorwaardelijke tag has_nav_menu ()
controleert of er een aangepast menu is dat de gebruiker heeft toegewezen aan de opgegeven locatie.
Deze voorwaardelijke tag heeft slechts één parameter:
$ locatie
(string, optioneel): Slug van de menulocatie. (Standaard: Geen)has_nav_menu ()
Laten we zeggen dat een van de aangepaste menustructuren van uw thema een klein JavaScript-bestand nodig heeft om goed te werken, dus u wilt het script alleen in de wachtrij plaatsen als het menu door de gebruiker wordt gebruikt. Dit is wat je doet:
is_plugin_active_for_network ()
Gelijkwaardig aan is_plugin_active ()
, de voorwaardelijke tag is_plugin_active_for_network ()
zal detecteren of de gegeven plug-in actief is ... in een multisite-installatie. Dit kan handig zijn als uw code moet weten of een andere plug-in actief is via het hele netwerk in plaats van één enkele site.
Deze voorwaardelijke tag heeft slechts één parameter:
$ plugin
(string, vereist): naam van de plug-in of sub-directory. (Standaard: Geen)comments_open ()
Een van de meest gebruikte voorwaardelijke tags is comments_open ()
. Met deze functie in uw als
verklaring, kunt u bepalen of opmerkingen zijn ingeschakeld in het huidige bericht.
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_id
(integer, optioneel): de bericht-ID. (Standaard: 0)comments_open ()
Laten we zeggen dat je een waarschuwing wilt herhalen voor het gedeelte met reacties, als reacties zijn ingeschakeld voor het bericht. Dit is wat je doet:
'. __ ('Waarschuwing', 'vertaaldomein'). ': '. __ ('Alle commentatoren zijn verantwoordelijk voor hun eigen woorden!', 'Vertaaldomein'). '
is_dynamic_sidebar ()
Veel WordPress-thema's gebruiken zijbalken om widgetinhoud weer te geven. Maar als u een plug-in of een thema aan het ontwikkelen bent en ongebruikte zijbalken wilt bepalen, kunt u de voorwaardelijke tag gebruiken is_dynamic_sidebar ()
-het controleert of een zijbalk actief is en of er widgets in worden gebruikt.
Deze voorwaardelijke tag accepteert geen parameters.
is_multi_author ()
De meeste WordPress-websites werken volgens mij met slechts één gebruiker. Bedrijfswebsites hebben meestal niet meer dan één gebruiker nodig en het internet staat vol met "persoonlijke blogs" (wat een goede zaak is, begrijp me niet verkeerd). U kunt echter controleren of meerdere auteurs berichten hebben gepubliceerd. Als dat het geval is, is_multi_author ()
kan u helpen bij het detecteren van WordPress-installaties met meerdere auteurs.
Deze voorwaardelijke tag accepteert geen parameters.
is_multi_author ()
Stel dat u een plug-in maakt voor blogs met meerdere auteurs en dat u afzonderlijke auteurs wilt waarschuwen dat de plug-in niet voor hen zal werken. Dit is wat je doet:
'. __ ('Sorry partner, deze plug-in werkt alleen voor blogs met meerdere auteurs!', 'Vertaaldomein'). '
pings_open ()
als jij nog steeds gebruik trackbacks om een of andere reden (of je hebt je plug-in nodig om aan hele oude blogs te werken), je kunt bepalen of trackbacks en pings zijn ingeschakeld in een specifieke post (of de post die wordt weergegeven) met behulp van de pings_open ()
Voorwaardelijke tag.
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_id
(integer, optioneel): de bericht-ID. (Standaard: 0)is_feed ()
Ik ben nog steeds dol op feeds, maar ze zijn een verouderd een deel van het web tegenwoordig. En WordPress gebruikt ze ook: het ondersteunt vier verschillende soorten feeds in zijn kern. Als u wilt dat uw functie weet wanneer deze in een feed wordt uitgevoerd, kunt u de is_feed ()
Voorwaardelijke tag-it controleert of de huidige zoekopdracht voor een feed is.
Deze voorwaardelijke tag heeft slechts één parameter:
$ feeds
(string / array, optioneel): Feedtypen. (Standaard: Geen)is_feed ()
Laten we zeggen dat u extra inhoud in elke post voor uw feeds wilt publiceren (om meer mensen aan te moedigen zich te abonneren). U heeft een shortcode nodig. Dit is wat je doet:
is_year ()
In blogs die u niet vaak schrijft, is het misschien een beter idee om jaarlijkse archieven te promoten in plaats van maandelijkse archieven. En als u verschillende functies wilt toevoegen of een ander ontwerp wilt weergeven, kunt u dit gebruiken is_year ()
om jaar-gebaseerde archiefpagina's te detecteren.
Deze voorwaardelijke tag accepteert geen parameters.
is_user_logged_in ()
Het is gebruikelijk om verschillende code voor ingelogde gebruikers uit te voeren: het kan een nieuw menu-item zijn, het kan een extra commentaarveld zijn, of het kan een heel ander website-ontwerp zijn. Hoe het ook zij, u kunt aangemelde gebruikers detecteren met de is_user_logged_in ()
Voorwaardelijke tag.
Deze voorwaardelijke tag accepteert geen parameters.
is_user_logged_in ()
Stel dat u uw gebruikers anders wilt begroeten dan bezoekers. Dit is wat je doet:
Weergavenaam . '!'; else _e ('Welkom op onze website!', 'vertaaldomein'); ?>
wp_attachment_is_image ()
De taak van deze voorwaardelijke tag is heel eenvoudig: u geeft de bericht-ID door als de parameter en de voorwaardelijke tag wordt geretourneerd TRUE
als de bijlage van het bericht een JPG-, JPEG-, GIF- of PNG-bestand is (en VALSE
als het dat niet is).
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_id
(geheel getal, virtueel vereist, technisch optioneel): de bericht-ID. (Standaard: 0)Waarom "virtueel vereist" en "technisch optioneel"? Omdat het standaard op 0 staat, wat betekent dat als u deze voorwaardelijke tag gebruikt zonder zijn parameter, deze een bericht probeert terug te sturen dat niet bestaat.
post_type_exists ()
In sommige scenario's kan het een goed idee zijn om te controleren of een bepaald aangepast berichttype al in gebruik is. (Als u bijvoorbeeld een portfolio-plug-in maakt, kunt u proberen berichten van een veelgebruikte posttypenaam voor portfolio's te dupliceren.) Hiervoor kunt u de post_type_exists ()
Voorwaardelijke tag.
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_type
(string, verplicht): Naam van het berichttype. (Standaard: Geen)post_type_exists ()
Laten we zeggen dat u een "portfolio" -plug-in ontwikkelt en dat u de natuurlijke naam "portfolio" op maat heeft gekozen. Maar veel ontwikkelaars gebruiken dezelfde naam voor portfoliostypes, dus je moet de gebruiker waarschuwen als een andere plug-in of thema al het berichttype heeft geregistreerd:
'. __ ('Waarschuwing', 'vertaaldomein'). ': '. __ ('Een berichttype met de naam' portfolio 'is al geregistreerd door een andere plug-in of een ander thema, dit zal hoogstwaarschijnlijk conflicten veroorzaken.', 'Vertaaldomein'). '
is_new_day ()
Sommige WordPress-functies lossen de kleinste problemen op, en is_new_day ()
is een van hen: deze specifieke voorwaardelijke tag retourneert TRUE
als de dag van de huidige post anders is dan de vorige.
Deze voorwaardelijke tag accepteert geen parameters.
In dit deel hebben we een andere batch van de 65 gedocumenteerde voorwaardelijke tags in WordPress beoordeeld. In het volgende deel gaan we de resterende 13 door. 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!