WordPress-Theme-Tutorial für Anfänger – Teil 5: Zugriff auf Beitragsinformationen
In dieser Lektion des WordPress-Theme-Tutorials für Anfänger geht es darum, wie wir innerhalb der Post-Schleife auf Informationen wie Link, Titel und mehr von jedem Post zugreifen und diese ausgeben können. Wir tun dies mit Template-Tags. Dabei werden wir auch die Single View Templates zu unserem Theme hinzufügen.
Im vorherigen Schritt haben wir die Post-Schleife hinzugefügt, die die the_post()Funktion enthält. Diese Funktion richtet globale Variablen ein und stellt sicher, dass wir einfache und intuitive Funktionsaufrufe, sogenannte Template-Tags, verwenden können, während wir uns innerhalb der whileSchleife befinden.
Die gängigsten Template-Tags zur Verwendung in der Post-Schleife
Dies ist eine Liste der gängigsten Vorlagen-Tags, die Sie für den Zugriff auf Beitragsinformationen verwenden möchten:
the_title()gibt den Titel des Beitrags wieder.the_permalink()gibt den Permalink/die URL des Beitrags aus.the_content()gibt den Inhalt des Beitrags aus (vom Editor)the_excerpt()wiederholt den Beitragsauszug. Wenn das Auszugsfeld leer ist, werden die ersten 55 Wörter aus dem Beitragsinhalt zusammen mit „…” ausgegeben.the_ID()gibt die ID des Beitrags aus.the_category()gibt alle zugeordneten Kategorien aus.the_tags()gibt alle zugehörigen Variablen aus.the_date()gibt das Veröffentlichungsdatum des Beitrags wieder.the_time()gibt die Veröffentlichungszeit des Beitrags aus.the_author()gibt den Anzeigenamen des Autors des Beitrags wiederthe_post_thumbnail()gibt das Beitragsbild des Beitrags aus. Wir werden später in diesem Tutorial lernen, wie man Unterstützung für vorgestellte Thumbnails hinzufügt.
Es gibt viele mehr. Wenn Sie interessiert sind, werfen Sie einen Blick auf die Dokumentation aller Post-Tags von WordPress Codex. Werfen Sie auch einen Blick außerhalb der Überschrift „Post-Tags”, um mehr zu erfahren – sie sind auf dieser Seite etwas verteilt.
Beginnen wir mit der Implementierung einiger dieser Tags in unserer index.php. Ich werde auch etwas sehr einfaches HTML hinzufügen, nur um die Ausgabe besser zu formatieren. Ich ermutige Sie, Ihr eigenes HTML hinzuzufügen! Fügen Sie Divs, Spans, Abschnitte, Header usw. mit beliebigen Klassen hinzu.
Ausfüllen der Schleife in index.php
Innerhalb der Schleife in unserem index.phpmöchte ich einen Link hinzufügen, der zum Permalink des Beitrags führt. Innerhalb des Links möchte ich den Titel des Beitrags wiedergeben. Dann möchte ich auch den Auszug des Beitrags und seine Kategorien wiedergeben.
Was der obige Code tut, ist;
- Zeile 5 fügt das HTML
<article>-Tag mit einem Aufruf hinzu,post_class()der nützliche Post-Klassen generiert – genau wiebody_class()wir es in einem vorherigen Schritt verwendet haben . - In Zeile 6-8 fügen wir ein
<h2>Tag für den Titel hinzu, mit einem Link, der zum Permalink des Beitrags führt (Einzelansicht). - Zeile #9 gibt den Beitragsauszug wieder.
- Und in Zeile 10 wiederholen wir die Kategorien des Beitrags. Da ich diesem Aufruf keine Argumente übergebe, wird standardmäßig eine
<ul>Liste verwendet.
Dies führt beim Aktualisieren der Frontpage zu folgender Ausgabe:
Wir kommen irgendwo hin! Ich ermutige Sie, sich die Dokumentation für jede Tag-Funktion anzusehen, für die sie Parameter akzeptiert. Sie können die Ausgabe um einiges ändern! Und entscheiden Sie selbst, welche Template-Tags Sie verwenden möchten.
Versuchen Sie, auf den Link eines Beitrags zu klicken, und stellen Sie fest, dass Sie zu dieser einzelnen Beitragsseite gelangen. Sie können jetzt sehen, dass die Schleife nur diesen einen Beitrag anzeigt. Da wir derzeit jedoch nur eine Vorlage haben index.php, verwendet auch die Einzelansicht diese Vorlage. Die Einzelansicht macht also wenig Sinn. Wir brauchen es nicht, um auf sich selbst zu verlinken, und wir wollen den vollständigen Inhalt des Beitrags sehen! Lassen Sie uns dies beheben, indem wir unsere zweite Vorlage in unserem Design erstellen.
Erstellen von Vorlagen für Einzelansichten
Erinnerst du dich, dass wir uns in Lektion 1 des WordPress-Theme-Tutorials für Anfänger die Vorlagenhierarchie angesehen haben? Wenn wir bei einem einzelnen Beitrag oder einer Seite sind, sucht WordPress nach single.phpBeiträgen und page.phpnach Seiten. Wenn einer davon nicht gefunden wurde, greift WordPress darauf zurück, singular.phpwas unabhängig vom Beitragstyp geteilt wird. Themen werden jedoch im Allgemeinen implementiert single.phpund page.phpaufgrund der Unterschiede zwischen Beiträgen und Seiten. Seiten haben keine Kategorien und Tags, und da Seiten normalerweise für statische Inhalte verwendet werden, zeigen sie normalerweise weder das Veröffentlichungsdatum noch Kommentare an. Dies liegt jedoch ganz bei Ihnen.
Wir werden single.phpund page.phpfür unser Thema erstellen. Beginnen wir zuerst mit den Beiträgen.
Einzelne Beitragsvorlage
Erstellen Sie in Ihrem Themenordner eine Kopie von index.phpund benennen Sie sie um in single.php. In single.phpentfernen wir den Permalink (der auf sich selbst verlinkt) und tauschen den Auszug mit dem vollständigen Beitragsinhalt aus. Und schließlich brauchen wir hier keine Archivnavigation.
Lassen Sie uns weitere nützliche Informationen hinzufügen; wie das Datum des Beitrags und der Name des Autors. Auch hier ermutige ich Sie, HTML-Tags hinzuzufügen, um eine viel schönere HTML-Struktur zu erstellen.
Die Funktionen the_time()und the_date()geben das Datum und die Uhrzeit in dem Format aus, das Sie im Admin-Bereich > Einstellungen definiert haben. Sie können dies jedoch überschreiben, indem Sie diesen Methoden ein anderes Datumsformat als Parameter zur Verfügung stellen.
Die Funktion the_author()gibt den „Anzeigenamen” des Autors aus. Wenn der Benutzer in seinem Profil keinen anderen Namen angegeben hat, wird der Benutzername ausgegeben.
Ich empfehle Ihnen dringend, niemals Benutzernamen auszudrucken, da dies ein Sicherheitsrisiko darstellen kann. Stellen Sie immer sicher, dass alle Autoren einen richtigen Namen angegeben haben, oder verwenden Sie nicht the_author().
So sieht ein einzelner Post bei mir jetzt aus. Genial! Lassen Sie uns die Einzelseitenvorlage erstellen.
Einseitige Vorlage
Erstellen Sie eine Kopie Ihrer single.phpund benennen Sie sie um in page.php. Ich habe page.phplediglich alles entfernt, was nichts mit Seiten zu tun hat. Das Ausgeben von Kategorien für Seiten funktioniert nicht, und ich habe auch Datum, Uhrzeit und Autor entfernt. Das bekommen wir rein page.php:
Wir fangen endlich an, mit unseren Vorlagen etwas zu erreichen! Ich kann dies jedoch nicht genug wiederholen; Ich ermutige Sie, die Vorlagen und die Parameter für die Funktionen nach Ihren Wünschen zu ändern. Insbesondere das Hinzufügen weiterer HTML-Wrapper, um das spätere Stylen zu erleichtern.
Im nächsten Schritt entfernen wir uns ein wenig von Vorlagen und gehen mehr auf die Backend-Codierung von WordPress-Themes ein.