Een krachtige functie die vaak wordt gebruikt door ontwikkelaars en themaontwerpers bij het bouwen of aanpassen van een WordPress -website is de sjabloon -tag. Inzicht in wat een sjabloon -tag is en hoe deze werkt, kan uw vermogen om dynamische inhoud op uw webpagina te structureren aanzienlijk verbeteren.
Of u nu een beginner of een ervaren ontwikkelaar bent, deze gids legt alles wat u moet weten over sjabloontags in WordPress in eenvoudige bewoordingen uit.
Inleiding tot sjabloontags
In WordPress is een sjabloon -tag een PHP -functie die wordt gebruikt om gegevens dynamisch op te halen en weer te geven. In plaats van hardcoderingwaarden zoals uw sitetitel of de naam van de auteur, gebruikt u een tag om ze uit de database te halen en ze waar nodig weer te geven.
Template -tags worden gebruikt in WordPress -themabestanden zoals header.php, footer.php, index.php en single.php. Deze functies helpen de structuur van uw site te definiëren zonder meerdere keren te dupliceren.
Sjabloon tag vs. html<template> Element
Het is belangrijk om WordPress -sjabloontags niet te verwarren met de HTML<template> element. Hoewel beide nuttig zijn, dienen ze heel verschillende doeleinden.
- Het HTML -element bevat codefragmenten die niet worden weergegeven wanneer de pagina wordt geladen. Deze inhoud kan later worden gekloond en ingevoegd met JavaScript.
- Een sjabloon -tag in WordPress is een PHP -functie die specifieke inhoud of informatie op een pagina uitvoert, zoals de titel of datum van de post.
Hoewel nauw verwant in concept, wordt de ene voornamelijk gebruikt voor op JavaScript gebaseerde frontend-rendering, en de andere is voor Backend PHP-sjabloonafhandeling.
Anatomie van een sjabloontag
Hier is een eenvoudig voorbeeld van een sjabloon -tag:
<?php the_title(); ?>
Deze code geeft de titel van een WordPress -bericht weer. Het maakt gebruik van een vooraf gedefinieerde functie die door WordPress .
De meeste sjabloontags volgen een soortgelijk formaat:
- Een PHP -functie
- Kan parameters nemen (optioneel)
- Kan de uitvoer rechtstreeks weerspiegelen of een waarde retourneren
Echo vs. Return
Sommige tags weerspiegelen hun inhoud rechtstreeks, terwijl anderen een waarde retourneren die u kunt toewijzen aan een variabele. Raadpleeg altijd naar de WordPress -documentatie om het verwachte gedrag te controleren.
Veelgebruikte sjabloontags
WordPress heeft verschillende ingebouwde sjabloontags die het gemakkelijker maken om dynamische inhoud weer te geven. Deze tags zijn gegroepeerd door functionaliteit en worden veel gebruikt in themabestanden.
Structurele tags
Structurele sjabloontags bevatten automatisch verschillende delen van uw themalay -out. Ze helpen u de consistentie op meerdere pagina's te behouden zonder code te herschrijven.
Deze tags bevatten andere sjabloonbestanden zoals header.php, footer.php en sidebar.php.
Verken verder: header -tags - wat zijn ze en hoe ze te gebruiken
Inhoudstags
Tags voor inhoudsjabloon zijn essentieel voor het weergeven van dynamische berichtgegevens op uw webpagina. Ze voeren belangrijke inhoudselementen uit zoals titels, lichamen en fragmenten.
Metadata -tags
Metadata -tags kunt u aanvullende informatie ophalen met betrekking tot het bericht, zoals de naam, de postdatum of categorieën van de auteur. Deze verrijken uw inhoud met de juiste context.
Deze tags trekken metagegevens over het bericht of de gebruiker die het heeft geschreven.
Site -informatie -tags
Site -informatie -tags Ophalen instellingen en informatie gedefinieerd in uw WordPress -dashboard. Dit kan de naam, beschrijving en basis -URL van uw site omvatten.
Deze tags halen gegevens uit uw site -instellingen.
Lees meer: wat zijn metatags
Sjabloon tags in de lus
De WordPress -lus is een PHP -codeblok dat berichten verwerkt en weergeeft. De meeste content-gerelateerde sjabloontags werken het beste wanneer ze in deze lus worden geplaatst.
In de lus werken tags zoals the_title () of the_content () op basis van het huidige bericht in context.
Hoe u een aangepaste sjabloontag maakt
Soms dekken de standaardsjabloon -tags niet al uw behoeften. Dat is waar aangepaste sjabloontags binnenkomen.
Om er een te maken, schrijft u een aangepaste PHP -functie in het Function.php -bestand van uw thema:
functie mytheme_display_random_number () {
echo rand (1, 100);
}
U kunt deze functie vervolgens in uw themasjabloon noemen, zoals zo:
<?php mytheme_display_random_number(); ?>
Beste praktijken
- Voorvoeg altijd uw functienamen voor om botsingen te voorkomen.
- Saniteer gegevens en valideer gegevens vóór de uitvoer.
- Gebruik WordPress-geleverde functies zoals ESC_HTML () om een veilige uitvoer te garanderen.
Wanneer en waar sjabloontags te gebruiken
Weten wanneer en waar een sjabloon -tag te gebruiken, zorgt ervoor dat uw WordPress -thema correct functioneert. Sjabloon -tags worden voornamelijk geplaatst in themabestanden zoals single.php, archive.php, page.php of zelfs index.php, afhankelijk van het type inhoud dat wordt weergegeven.
Bijvoorbeeld:
- Bel in de lus
de_title ()om de titel van elk bericht weer te geven. - In
pagina.phpofsingle.phpvoegt een consistente zijbalk in metget_sideBar (). - Gebruik
BlogInfo ('Beschrijving')om de slogan van uw site inheader.php.
Het begrijpen van de sjabloonstructuur helpt bij het bepalen van de juiste plaatsing, zodat uw webpagina dynamische inhoud efficiënt laadt.
Verder lezen: hoe u dubbele titeltags in WordPress kunt repareren om SEO te verbeteren
Verschil tussen sjabloontags en sjabloonbestanden
Beginners verwarren sjabloontags vaak met sjabloonbestanden, die verschillende doeleinden dienen in WordPress -themaontwikkeling.
- Sjabloonbestanden zijn volledige PHP -bestanden, zoals Home.php, Single.php of 404.php, die de algemene lay -out of structuur van een webpagina definiëren.
- Een sjabloon -tag is een functie die in die bestanden is geschreven om specifieke gegevens weer te geven, zoals inhoud, metagegevens of site -informatie.
U kunt sjabloonbestanden beschouwen als de containers en sjabloontags als de afzonderlijke elementen die de inhoud in die container vormen.
Voorwaardelijke tags met sjabloontags gebruiken
U kunt sjabloontags combineren met WordPress -voorwaardelijke tags om te regelen wanneer inhoud op een pagina verschijnt. Hierdoor kan uw site zich dynamisch gedragen op basis van context.
Voorbeeld:
php
if (is_single ()) {
the_title ();
the_content ();
}
Deze code zorgt ervoor dat de posttitel en inhoud alleen worden weergegeven op enkele postweergaven. Het gebruik van sjabloontags helpt u voor het voorwaardelijk aan te passen aan de structuur van de webpagina en gebruikerservaring zonder hardcodering.
Prestaties en beveiligingstips
Template -tags kunnen van invloed zijn op prestaties en beveiliging als ze niet correct worden gebruikt.
- Escape -uitvoer : gebruik altijd functies zoals esc_url () en esc_html () bij het afdrukken van gegevens.
- Cachegegevens : slaat herhaalde query's op met transiënten om de prestaties te verbeteren.
- Vermijd directe DB -oproepen : gebruik WordPress API -functies om gegevens op te halen.
Lees ook: hoe kunnen tags van derden de prestaties beïnvloeden
Template -tags versus shortcodes
Zowel sjabloontags als shortcodes worden gebruikt om dynamische inhoud in te voegen, maar verschillen in gebruik en doel.
- Template -tags worden gebruikt in thema PHP -bestanden om de dynamische HTML -uitvoer rechtstreeks in te voegen en te besturen.
- Shortcodes worden gebruikt in post- of pagina -inhoud via de WordPress -editor of de functie Do_shortcode ().
Gebruik bijvoorbeeld the_author () (een sjabloon -tag) in single.php om de naam van auteur galerij (een shortcode) kan worden toegevoegd in een postlichaam.
Shortcodes zijn meer gebruikersgericht, terwijl sjabloontags achter de schermen in de themacode werken.
Verken verder: hoe u Elementor -shortcodes instelt voor eenvoudig gebruik van sjabloon
Geavanceerd gebruik: parameters doorgeven aan sjabloontags
Sommige sjabloontags accepteren parameters om aan te passen hoe gegevens worden weergegeven. Met deze flexibiliteit kunt u de contentpresentatie aanpassen zonder code te herhalen.
Voorbeeld met wp_nav_menu ():
PHP
wp_nav_menu (
array ('theme_location' => 'primaire',
'menu_class' => 'nav-menu',
'container' => 'nav',
));
?>
Hier wordt een reeks parameters doorgegeven om het uiterlijk en de HTML -structuur van het menu te definiëren. Op dezelfde manier kunt tags zoals get_the_excerpt ($ post_id) u het fragment voor een specifiek bericht halen, waardoor meer controle over hoe informatie wordt opgehaald en weergegeven.
SEO- en toegankelijkheidsoverwegingen
Volg bij het gebruik van sjabloontags best practices voor SEO en toegankelijkheid :
- Gebruik semantische HTML -tags (<article> ,,<section> ) samen met sjabloontags.
- Voeg ALT -attributen toe aan afbeeldingstags met the_post_thumbnail ().
- Zorg ervoor dat koppen de juiste structuur gebruiken (<h1> ,,<h2> ).
Voorbeeld:
<img src=”<?php echo get_the_post_thumbnail_url(); ?> "Alt ="<?php the_title(); ?> ”>
Debugging -sjabloontags
Als een sjabloon -tag niet werkt:
- Controleer of u zich in de lus bevindt.
- Controleer het bestaan van de functie met behulp van functie_exists ().
- Gebruik WP_Debug en foutlogboeken om problemen bij te houden.
Voorbeeld:
if (function_exists ('the_title')) {
the_title ();
}
Browserondersteuning en compatibiliteit
Sjabloon -tags maken deel uit van PHP en WordPress Core, dus browserondersteuning is geen directe zorg. Bij het gebruik van JavaScript met de HTML<template> element:
- De meeste moderne browsers (Chrome, Firefox, Safari, Edge) ondersteunen het.
- Oudere versies van Internet Explorer niet.
- Gebruik een polyfill om ondersteuning toe te voegen indien nodig.
Lees meer: Essentiële handleiding voor het veilig bijwerken van WordPress PHP -versie
HTML<template> Element en javascript
Hoewel niet direct deel uitmaakt van WordPress-sjabloontags, helpt het begrijpen van het HTML-element bij het werken met front-end JavaScript- rendering.
Voorbeeld:
const template = document.querySelector ('#card-template');
const clone = sjabloon.content.clonenode (true);
Clone.querySelector ('IMG'). Src = 'Image.jpg';
Clone.querySelector ('. Beschrijving'). TextContent = 'Card Beschrijving';
Document.Body.AppendChild (kloon);
Hiermee kunt u HTML -structuren dynamisch hergebruiken, vergelijkbaar in concept als sjabloontags, maar geïmplementeerd met JavaScript.
Veel voorkomende fouten om te vermijden
Hier zijn enkele fouten om op te letten bij het gebruik van sjabloontags:
- De verkeerde context gebruiken : tags zoals the_content () moeten in de lus worden gebruikt; Anders zullen ze niet werken zoals verwacht.
- Vergeten om te ontsnappen aan output : om beveiligingsproblemen te voorkomen, saneer de output altijd met ESC_HTML (), ESC_URL () of vergelijkbare functies.
- Compatibiliteit van de browser niet controleren : als u het HTML -element met JavaScript gebruikt, controleert u de browserondersteuning altijd en voegt Polyfills toe indien nodig.
- Hardcodering in plaats van tags : vermijd statische waarden wanneer een sjabloon -tag dynamisch uit de database kan trekken.
Het volgen van best practices zorgt ervoor dat uw site veilig, performant en gemakkelijk te onderhouden blijft.
Samenvatting
Template -tags in WordPress bieden een krachtige manier om dynamische inhoud weer te geven, schone code te behouden en de flexibiliteit van de site te verbeteren. Of u nu posttitels, auteursnamen of aangepaste gegevens weergeeft, sjabloontags stroomlijnen uw themaontwikkeling.
Het correct gebruiken van ze zorgt ervoor dat uw webpagina's goed gestructureerd, toegankelijk en SEO-vriendelijk zijn. Het maken van aangepaste sjabloontags maakt ook geavanceerde aanpassing mogelijk, waardoor u precies kunt regelen wat wordt weergegeven en hoe.
Veelgestelde vragen
Wat is een sjabloon -tag?
Een sjabloon -tag is een PHP -functie die in WordPress wordt gebruikt om dynamische inhoud op te halen en weer te geven.
Kan ik mijn sjabloontags maken?
Ja, door aangepaste functies in functies te definiëren.php.
Werken sjabloontags buiten de lus?
Sommigen doen dat, maar veel tags vertrouwen op de luscontext om correct te functioneren.
Is browserondersteuning nodig voor sjabloontags?
Nee, omdat sjabloontags op PHP zijn gebaseerd. HTML<template> Elementen die met JavaScript worden gebruikt, hebben overwegingen van browsercompatibiliteit.
Wat is het verschil tussen Get_ en The_ -functies?
De functies Get_ retourneren een waarde voor verdere verwerking, terwijl de_ de uitvoer functioneert (echo) de waarde rechtstreeks naar de pagina.