In deze serie doorlopen we een van de fundamentele kenmerken van WordPress: voorwaardelijke tags. In dit zesde deel maken we een einde aan 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_singular ()
Ik weet niet waarom, maar dit is mijn favoriete voorwaardelijke tag: is_singular ()
kan detecteren wanneer een berichttype wordt weergegeven. Het is eigenlijk een combinatie van de voorwaardelijke tags is vrijgezel()
, is_attachment ()
en is_page ()
. Plus, als u een berichttype (of een reeks berichttypen) als parameter instelt, kunt u alleen de berichttypen detecteren die u hebt ingesteld.
Deze voorwaardelijke tag heeft slechts één parameter:
$ post_types
(array / string, optioneel): de naam van het berichttype of een reeks posttypenamen. (Standaard: Geen)in de lus()
Als ik zeg dat de Loop het fundament is van WordPress in termen van code, zijn maar weinigen het hiermee niet eens. Dus de voorwaardelijke tag in de lus()
is een van de belangrijkste voorwaardelijke tags en het helpt uw functies om te zien of ze zich in de Loop bevinden of niet.
Deze voorwaardelijke tag accepteert geen parameters.
in de lus()
Laten we zeggen dat uw plug-in een functie heeft die moet in de Loop uitvoeren, maar u wilt ook een fout in de paginabroncode weergeven als de gebruiker deze buiten de Loop gebruikt. Zo bouw je de functie op:
my_awesome_plugin_function () '. __ ('functie van de plug-in' Mijn Awesome-plug-in 'moet in WordPress Loops worden uitgevoerd!', 'vertaaldomein'). '->'; else // Voer de geweldige code uit omdat we bezig zijn! ?>
is_plugin_inactive ()
U kunt raden wat deze voorwaardelijke tag inhoudt door zijn naam: Gedefinieerd als "de logische ontkenning van is_plugin_active ()
"in de Codex, is_plugin_inactive ()
controleert of de opgegeven plug-in is geïnstalleerd, maar niet geactiveerd.
Deze voorwaardelijke tag heeft slechts één parameter:
$ plugin
(string, vereist): naam van de plug-in of sub-directory. (Standaard: Geen)is_author ()
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 heeft slechts één parameter:
$ auteur
(string / integer, optioneel): gebruikersnaam of ID van de auteur. (Standaard: Geen)is_author ()
Stel dat u een plug-in voor Google Analytics ontwikkelt en een 'aangepaste variabele' wilt instellen om auteursarchieven te detecteren. Dit is wat je doet:
is_paged ()
In blogindexpagina's of archiefpagina's kunnen we met WordPress de paginering gebruiken om de berichtvermeldingen op opeenvolgende pagina's te verdelen. Met de hulp van de voorwaardelijke tag is_paged ()
, u kunt uw code laten detecteren of de vermelding "gepagineerd" is en of het paginanummer groter is dan 1.
Deze voorwaardelijke tag accepteert geen parameters.
is_admin_bar_showing ()
De WordPress-werkbalk, voorheen bekend als de Admin-balk, wordt zowel nuttig als irritant beschouwd in de WordPress-community. Sommigen houden ervan, anderen haten het, dus de voorwaardelijke tag is_admin_bar_showing ()
kan voor iedereen nuttig zijn: het bepaalt of de werkbalk wordt weergegeven of niet.
Deze voorwaardelijke tag accepteert geen parameters.
is_admin_bar_showing ()
Stel dat u de werkbalk wilt uitbreiden met enkele CSS-stijlen, maar dat u de stylesheet voorwaardelijk moet laden. Dit is wat je doet:
is_day ()
Dagelijkse archieven zijn waarschijnlijk de meest onderbenutte typen van datumgebaseerde archieven, maar dat betekent niet dat ze nutteloos zijn - sommige thema's kunnen zelfs verschillende sjablonen hebben voor dagelijkse archieven. Dus als u dagelijkse archiefpagina's wilt detecteren, kunt u de voorwaardelijke tag gebruiken is_day ()
om het werk te doen.
Deze voorwaardelijke tag accepteert geen parameters.
is_active_sidebar ()
Bij het maken van een thema moeten we degenen die geen gebruik maken van widgets meenemen. De voorwaardelijke tag is_active_sidebar ()
controleert of de gegeven zijbalk al dan niet widgets bevat.
Deze voorwaardelijke tag heeft slechts één parameter:
$ zijbalk
(string / integer, vereist): naam of ID van zijbalk. (Standaard: Geen)is_active_sidebar ()
Dit voorbeeld komt uit het Twenty Ten-thema - het gebruikt de voorwaardelijke tag om de gegeven zijbalk voorwaardelijk te laden:
username_exists ()
De derde voorwaardelijke tag die iets anders retourneert dan TRUE
wanneer succesvol is username_exists ()
. Deze voorwaardelijke tag controleert de gegeven gebruikersnaam en retourneert de ID van de gebruiker als een gebruiker met de opgegeven gebruikersnaam bestaat. Als dit niet het geval is, keert het terug NUL
.
Deze voorwaardelijke tag heeft slechts één parameter:
$ username
(string, verplicht): De gebruikersnaam die moet worden gecontroleerd. (Standaard: Geen)is_preview ()
Als u enkele pagina-elementen heeft die niet in voorvertoningen mogen worden geladen (zoals op advertenties gebaseerde advertenties of een code voor gevoelige analyse), kunt u deze verwijderen met behulp van de voorwaardelijke tag is_preview ()
.
Deze voorwaardelijke tag accepteert geen parameters.
is_preview ()
Het is een goede gewoonte om dit te doen verbergen voorbeeldpagina's van Google Analytics, dus u moet voorzichtig zijn en uw Google Analytics-script als volgt opnemen:
'; ?>
wp_script_is ()
Dit is vooral handig voor ontwikkelaars van plug-ins die niet willen dat hun scripts in conflict komen met andere wachtrijen. Met deze voorwaardelijke tag kunt u detecteren of het opgegeven script is geregistreerd, in de wachtrij is geplaatst en in de wachtrij is geplaatst en afgedrukt, of in de wachtrij geplaatst maar niet nog afgedrukt.
Deze voorwaardelijke tag heeft twee parameters:
$ handle
(string, verplicht): Naam van het script (in kleine letters). (Standaard: Geen)$ lijst
(string, optioneel): een van de vier strings-"geregistreerd", "Enqueued", "gedaan" (in de wachtrij geplaatst en afgedrukt), of "Te doen" (in de wacht maar niet afgedrukt). (Standaard: "in de wachtrij geplaatst")wp_style_is ()
Deze voorwaardelijke tag is vergelijkbaar met zijn broer, wp_script_is ()
, maar het doet hetzelfde werk voor opgezette stylesheets. Met deze voorwaardelijke tag kunt u detecteren of de opgegeven stijl is geregistreerd, in de wachtrij is geplaatst en in de wachtrij is geplaatst en afgedrukt, of in de wachtrij geplaatst maar niet nog afgedrukt.
Deze voorwaardelijke tag heeft twee parameters:
$ handle
(string, verplicht): Naam van de stijl (in kleine letters). (Standaard: Geen)$ lijst
(string, optioneel): een van de vier strings-"geregistreerd", "Enqueued", "gedaan" (in de wachtrij geplaatst en afgedrukt), of "Te doen" (in de wacht maar niet afgedrukt). (Standaard: "in de wachtrij geplaatst")wp_style_is ()
Laten we zeggen dat u een thema maakt met het Bootstrap-framework en dat u een aangepast Bootstrap-thema hebt gemaakt om op te nemen. U moet ervoor zorgen dat Bootstrap's belangrijkste CSS-bestanden als eerste in de wacht worden gezet:
is_taxonomy_hierarchical ()
Je weet dat categorieën hiërarchisch zijn - je kunt instellen ouder en kind categorieën. Hetzelfde geldt voor aangepaste taxonomieën, als je het zo maakt tijdens het maken ervan. En als u wilt dat uw code weet of een bepaalde taxonomie hiërarchisch is, kunt u de is_taxonomy_hierarchical ()
Voorwaardelijke tag.
Deze voorwaardelijke tag heeft slechts één parameter:
$ taxonomie
(string, verplicht): Taxonomie naam. (Standaard: Geen)In dit deel hebben we de laatste batch van de 65 gedocumenteerde voorwaardelijke tags in WordPress doorgenomen. In het volgende (en laatste) deel van de serie eindigen we met het bekijken van wat we hebben geleerd en een klein bonusdeel dat - hopelijk - je zult genieten.
Als je vragen of opmerkingen hebt, kun je deze hieronder opnemen. Als je dit artikel leuk vindt, kun je dit het beste delen!