In deze zelfstudie voegt u wat actiehaken toe aan uw sjabloonbestanden, waaraan u vervolgens functies toevoegt in de volgende zelfstudie. Hierna voegt u enkele filterhaken toe.
Het voordeel van het maken van actiehaken in uw framework is dat elke inhoud die u eraan koppelt, gemakkelijk kan worden overschreven door functies in een kindthema of door plug-ins. Dit bespaart u het creëren van dubbele sjabloonbestanden in uw kindthema's en geeft u meer flexibiliteit.
Opmerking: als u meer wilt weten over actie en filterhaken voordat u begint, helpt deze zelfstudie.
Als u deze zelfstudie wilt volgen, heeft u het volgende nodig:
We gaan twee haken aan de kop toevoegen: één ervoor en één erin.
In header.php
, onmiddellijk in de opening tag, voeg de eerste actiehaak toe:
Deze haak kan handig zijn om inhoud, menu's of links boven de sitekop toe te voegen.
Voeg nog een haak toe in de kop, rechts. Uw kindthema's kunnen dit gebruiken om aangepaste inhoud, een zoekformulier of widgets in te voegen.
Merk op dat ik deze haak heb ingesloten in een div
met een aantal klassen die werken met de object-georiënteerde stijl in mijn thema - als je met je eigen thema werkt, moet je iets anders gebruiken, maar de haak zelf is hetzelfde.
Het thema bevat twee inhoudshaken - één vóór de lus en daarna geopend, beide binnen de #content div
. Gelukkig, vanwege de manier waarop mijn thema is gestructureerd, hoef ik slechts elke haak één keer toe te voegen, terwijl ik die div open in de header.php
bestand en sluit het in de sidebar.php
en page-full-width.php
bestand - het is toegevoegd aan de paginasjabloon met de volledige breedte omdat dat de zijbalk niet roept.
Laten we beginnen met die voor de lus.
Aan het einde van header.php
, voeg het volgende toe net binnen de opening #inhoud
div:
Dit zorgt voor een haak voor alles binnen het inhoudgebied maar boven de lus.
Volgende in sidebar.php
, vlak voor het sluiten van de #inhoud
div, voeg deze code toe:
Voeg tenslotte dezelfde code toe aan de page-full-width.php
sjabloon zoals u dat net deed sidebar.php
, weer net voor het einde van de #inhoud
div.
De volgende stap is om het widgetgebied in de zijbalk te vervangen door een haak, die vervolgens zal worden gebruikt om het widgetgebied op een later tijdstip weer toe te voegen, maar kan ook worden gebruikt om aangepaste code toe te voegen of het widgetgebied te overschrijven..
Vervang alle code voor het widgetgebied door de nieuwe haak:
Dit betekent dat als u het widgetgebied wilt vervangen door uw eigen code in een plug-in of een kindthema, u dit kunt doen door de nieuwe code aan deze haak te koppelen en de haak te negeren die het widgetgebied bevestigt.
Eindelijk moet je een paar haken toevoegen aan de voettekst: een erin en een eronder, die voor de colofon wordt gebruikt.
Binnen in de footer
element, vervang alle bestaande code door de haak:
Voeg vervolgens nog een haak toe voor de colofon, na het sluiten van de footer
element:
Opmerking: de code die u hebt verwijderd voor widgetgebieden en de colofon, zal in een later stadium worden vervangen, maar in plaats van deze rechtstreeks aan de sjabloonbestanden toe te voegen, wordt deze toegevoegd met behulp van een functie die wordt geactiveerd via de relevante haak. We voegen ook filterhaken toe aan enkele van die functies.
Het gebruik van actiehaken in uw sjabloonbestanden geeft u en de gebruikers van uw raamwerk veel meer flexibiliteit over de lijn. U kunt ze gebruiken om elk type inhoud in te voegen waar u maar wilt, en inhoud overschrijven of verwijderen, allemaal zonder nieuwe sjabloonbestanden te maken.
In het volgende deel van deze serie laat ik je zien hoe je functies kunt maken die widgetgebieden en andere inhoud toevoegen, allemaal geactiveerd via deze haken.