In deze serie doorlopen we een van de fundamentele kenmerken van WordPress: voorwaardelijke tags. In dit vierde 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_month ()
In WordPress is het meest gebruikte datumgebaseerde archieftype waarschijnlijk het maandelijkse archief. Wanneer u moet vaststellen of uw code op een maandelijkse archiefpagina wordt uitgevoerd, moet u de voorwaardelijke tag gebruiken is_month ()
zal je helpen.
Deze voorwaardelijke tag accepteert geen parameters.
current_theme_supports ()
Tijdens het ontwikkelen van plug-ins, moet u mogelijk controleren of het actieve thema miniaturen, post-indelingen, aangepaste headers of zelfs widgets toestaat. Met de hulp van current_theme_supports ()
, u kunt controleren of het gebruikte thema de functie ondersteunt die u opgeeft.
Deze voorwaardelijke tag heeft slechts één parameter:
$ feature
(string, optioneel): Naam van de functies. (Standaard: Geen)Functienaam:
current_theme_supports ()
Stel dat u een plug-in ontwikkelt voor WordPress-thema's met de functie "Aangepaste achtergronden". Uw plug-in zal nutteloos zijn voor thema's die geen aangepaste achtergronden ondersteunen, dus u moet een foutmelding in het administratiepaneel weergeven om de gebruiker te informeren. Dit is wat je doet:
'. __ ('Voor deze plug-in is een thema vereist met de functie' Aangepaste achtergronden 'ingeschakeld.', 'Vertaaldomein'). '
is_plugin_active ()
Alleen in het administratiepaneel, de voorwaardelijke tag is_plugin_active ()
helpt uw code te weten of de betreffende plug-in actief is. Deze voorwaardelijke tag kan handig zijn als u "add-on-plug-ins" schrijft voor populaire plug-ins (zoals WooCommerce) of basiskaders geïnstalleerd als plug-ins (zoals het Redux Framework).
Deze voorwaardelijke tag heeft slechts één parameter:
$ plugin
(string, vereist): naam van de plug-in of sub-directory. (Standaard: Geen)is_local_attachment ()
WordPress-bijlagen zijn een zegen als ze goed worden gebruikt, maar hoe kom je erachter of een URL eigenlijk een bijlage is? Als u tijdens het ontwikkelen met URL's werkt, is de voorwaardelijke tag is_local_attachment ()
kan erg nuttig voor u zijn: het controleert of de gegeven URL als een bijlage naar dezelfde WordPress-installatie is geüpload.
Deze voorwaardelijke tag heeft slechts één parameter:
$ url
(string, verplicht): URL om te controleren. (Standaard: Geen)is_local_attachment ()
Omdat deze voorwaardelijke tag vrij eenvoudig is, zal het voorbeeld ook eenvoudig zijn. Stel dat u een plug-in ontwikkelt en dat u URL's (gegenereerd door een andere functie die u hebt gemaakt) nodig hebt om te controleren of ze lokale bijlagen zijn of niet:
het is tijd()
Wist je dat WordPress uurgebaseerde, minuten-gebaseerde en zelfs tweede-gebaseerde archieven heeft? (Om eerlijk te zijn wist ik niet dat je dit soort archieven zou kunnen maken voordat je deze serie gaat schrijven. Ook schrijven op Tuts + kan een leerzame reis zijn!)
Het komt niet uit de doos, wat betekent dat je niet kunt typen mywebsite.com/2014/02/22/18/30/
en krijg archieven voor 18:30 op 22 februari 2014; maar je kunt er een creëren met behulp van de WP_Query
klasse. Hoe dan ook: als u dit soort tijdgebaseerde archieven wilt detecteren, kunt u de het is tijd()
Voorwaardelijke tag.
Deze voorwaardelijke tag accepteert geen parameters.
is_rtl ()
In sommige talen, meestal in de landen van het Midden-Oosten, wordt tekst geschreven van rechts naar links in plaats van van links naar rechts. Als WordPress-ontwikkelaar moet je rekening houden met alle WordPress-gebruikers en als je wilt dat je thema of plug-in goed werkt met WordPress-websites met RTL-tekst, moet je is_rtl ()
om te bepalen of de locale RTL is.
Deze voorwaardelijke tag accepteert geen parameters.
is_rtl ()
De meeste webontwerpers maken afzonderlijke stijlbladen voor RTL-locaties - het is een algemene praktijk. En als u uw RTL-stylesheet voorwaardelijk wilt laden, dan is dit wat u doet:
is_tax ()
De voorwaardelijke tag is_tag ()
kan tagarchieven detecteren, maar het kan niet werken met aangepaste taxonomieën. Om te bepalen of een archiefpagina van een taxonomie wordt weergegeven, kunt u gebruiken is_tax ()
. Standaard bevat deze alle archiefpagina's voor taxonomieën, inclusief reguliere tags. Maar het heeft twee parameters, dus u kunt specifieke taxonomie-archiefpagina's targeten, of zelfs specifieke termen.
Deze voorwaardelijke tag heeft slechts één parameter:
$ taxonomie
(array / string, optioneel): Taxonomie-slug of een reeks slakken. (Standaard: Geen)$ term
(array / string / integer, optioneel): Term's ID, naam, slug of een array daarvan. (Standaard: Geen)is_attachment ()
Tijdens het maken van een plug-in (of thema), wilt u misschien weten wanneer een bijlagepagina wordt weergegeven. De voorwaardelijke tag is_attachment ()
is degene die je zal helpen: het komt terug TRUE
in een bijlagepagina en VALSE
ergens anders.
Deze voorwaardelijke tag accepteert geen parameters.
is_attachment ()
Stel dat u een link 'Terug naar het bericht' boven de bijlage wilt weergeven. Dit is wat je doet:
term_exists ()
Dit is de tweede voorwaardelijke tag die niet wordt geretourneerd TRUE
en VALSE
, maar meer bruikbare informatie: de voorwaardelijke tag term_exists ()
controleert of een begrip van een taxonomie bestaat en retourneert de term ID (als er geen taxonomie is opgegeven) of een array van de taxonomie en termpairing in plaats van TRUE
. Als de opgegeven term niet bestaat, wordt deze geretourneerd 0
of NUL
.
Deze voorwaardelijke tag heeft drie parameters:
$ term
(string / integer, vereist): naam of ID van de term. (Standaard: Geen)$ taxonomie
(string, optioneel): de naam van de taxonomie. (Standaard: leeg)$ ouder
(integer, optioneel): ID van de ouderterm (om de zoekopdracht eronder te beperken). (Standaard: 0)has_term ()
We zagen dat we konden gebruiken has_tag ()
als we een tag in een post wilden vinden. Wat als we hetzelfde wilden doen, maar met een looptijd van een aangepaste taxonomie? Eenvoudig: de voorwaardelijke tag has_term ()
heeft een derde parameter (tweede in volgorde) waarmee we een aangepaste taxonomie kunnen specificeren.
Leuk feitje: zelfs de voorwaardelijke tag has_tag ()
toepassingen has_term ()
terugbrengen TRUE
of VALSE
! En zoals met de has_tag ()
functie, has_term ()
laat je ook toe meer dan één term te specificeren (maar in slechts één taxonomie).
Deze voorwaardelijke tag heeft drie parameters:
$ term
(array / string / integer, optioneel): naam van de term, ID, slug of een reeks daarvan. (Standaard: leeg)$ taxonomie
(string, verplicht): de naam van taxonomie. (Standaard: leeg)$ bericht
(object / integer, optioneel): post om te controleren. (Standaard: NUL
)has_term ()
Stel dat u een e-commercewebsite uitvoert en dat u uw leverancier voor Dell-laptops gaat wijzigen, zodat u uw gebruikers wilt laten weten dat zendingen tot volgende week worden uitgesteld. Dit is wat je doet:
'. __ ('Waarschuwing', 'vertaaldomein'). ': '. __ ('We wisselen van leverancier voor Dell-laptops, dus de zendingen worden tot volgende week uitgesteld. Sorry daarvoor!', 'Vertaaldomein'). '
is_trackback ()
Gegroet, oldtimer! Wil je weten of een opmerking een "trackback" is? De is_trackback ()
Voorwaardelijke tag helpt u daarbij!
Deze voorwaardelijke tag accepteert geen parameters.
is_multisite ()
Hoewel het een niet zo populaire functie van WordPress is, is Multisite erg handig wanneer nodig. Als u wilt dat uw code wordt uitgevoerd in normale WordPress-installaties en zich anders gedraagt in Multisite-installaties, is de voorwaardelijke tag is_multisite ()
kan u helpen bij het detecteren of multisite-ondersteuning is ingeschakeld.
Deze voorwaardelijke tag accepteert geen parameters.
is_multisite ()
Stel dat u een plug-in ontwikkelt en als Multisite is ingeschakeld, heeft de plug-in een andere klasse nodig van uw plug-in. Dit is wat je doet:
is_post_type_archive ()
Soms wilt u misschien dat uw code weet of een archiefpagina voor een aangepast berichttype (of een paar aangepaste berichttypen, of ieder aangepast berichttype) wordt weergegeven. De voorwaardelijke tag is_post_type_archive ()
doet precies dat: het controleert of de vraag betrekking heeft op een archiefpagina voor een aangepast berichttype.
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_types
(array / string, optioneel): naam van het berichttype of een reeks posttypenamen. (Standaard: Geen)In dit deel hebben we een andere batch van de 65 gedocumenteerde voorwaardelijke tags in WordPress beoordeeld. In de volgende delen gaan we de resterende 26 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!