Einzelproduktvorlagen erstellen

Zu diesem Zeitpunkt kann man davon ausgehen, dass Sie bereits wissen, dass
Easy Digital Downloads (EDD) für die Arbeit mit jedem Theme entwickelt wurde. Es gibt jedoch mehrere Dinge, die getan werden können, um sicherzustellen, dass Ihr Theme mehr aus EDD herausholt.

In diesem Artikel werden wir die Grundlagen der Erstellung von Single-Product-Vorlagen für Ihr Theme behandeln. Um es klarzustellen: Eine Single-Product-Vorlage wird verwendet, um die Frontend-Seite anzuzeigen, die erstellt wird, wenn Sie Ihrer Website einen neuen Download hinzufügen.

WordPress-Vorlagenhierarchie

Zuerst müssen wir einen Schritt zurücktreten und untersuchen, wie WordPress selbst funktioniert. WordPress-Themes sind nichts weiter als eine Sammlung von Dateien, die zusammenarbeiten, um Ihre Website anzuzeigen. Einige dieser Theme-Dateien sind Vorlagen und Vorlagenkomponenten, die zusammen die HTML-Struktur Ihrer Website erstellen.

WordPress verwendet eine
Vorlagenhierarchie, um zu bestimmen, wann und wie diese Vorlagendateien verwendet werden. Wir werden nicht auf alle Details der gesamten Hierarchie eingehen, aber hier ist eine visuelle Darstellung, wie die verschiedenen Vorlagendateien miteinander verbunden sind.

Was wir hier behandeln werden, ist die Single-Post-Vorlage und wie sie die Anzeige Ihrer einzelnen Produktseiten beeinflusst. Fangen wir an.

Single-Post- (und Singular-) Vorlage

Direkt von
wordpress.org, hier ist die Vorlagenhierarchie für einzelne Beiträge:

1. single-{post-type}-{slug}.php – (Seit 4.4) Zuerst sucht WordPress nach einer Vorlage für den spezifischen Beitrag. Wenn der Beitragstyp beispielsweise product und die Beitrags-Slug dmc-12 ist, würde WordPress nach single-product-dmc-12.php suchen.
2. single-{post-type}.php – Wenn der Beitragstyp product ist, würde WordPress nach single-product.php suchen.
3. single.php – WordPress greift dann auf single.php zurück.
4. singular.php – Dann greift es auf singular.php zurück.
5. index.php – Schließlich, wie oben erwähnt, greift WordPress letztendlich auf index.php zurück.

Das bedeutet, dass der Name einer Theme-Datei WordPress mitteilt, wann sie verwendet werden soll und welchen „Rang“ sie in der Hierarchie für diesen speziellen Anwendungsfall hat.

Der gebräuchlichste Dateiname zu diesem Zeitpunkt ist höchstwahrscheinlich
single.php. Die Vorlage single.php wird verwendet, um einzelne Blogbeiträge anzuzeigen. Wie Sie sich vorstellen können, veröffentlichen die meisten Benutzer mehr Blogbeiträge auf ihren WordPress-Websites als alles andere. Obwohl single.php also nicht die höchste Priorität insgesamt hat, hat sie
die höchste Priorität für generische Single-Post-Vorlagen.

Es ist sehr wahrscheinlich, dass Ihr aktives Theme (oder Parent-Theme, wenn Sie ein
Child-Theme verwenden) eine single.php-Datei in seinem Stammverzeichnis hat. Wenn ja, wird diese zur Anzeige einzelner Blogbeiträge verwendet. Es ist jedoch auch möglich, dass Sie keine single.php-Datei, sondern stattdessen eine singular.php-Datei haben. Dies wird immer häufiger. Ihr grundlegender Zweck ist es, eine „universellere“ Vorlage für alle Frontend-Seiten zu sein, die unter die WordPress-Definition von „singular“ fallen, wie z. B. Blogbeiträge, Seiten und Einträge für grundlegende benutzerdefinierte Beitragstypen.

Lassen Sie uns behandeln, wie EDD diese Vorlagen verwendet und wie Sie das ändern können.

single.php

Wie oben erwähnt, ist die
single.php-Datei eine grundlegende Vorlage, die zur Anzeige einzelner Blogbeiträge verwendet wird. Wenn die URL eines Blogbeitrags besucht wird, sucht WordPress in der Theme-Struktur nach der entsprechenden Vorlagendatei, die zur Anzeige dieses Blogbeitrags verwendet werden soll. Die single.php-Datei ist die übliche Antwort.

Mit diesem Verständnis müssen Sie auch wissen, dass Beiträge (und Seiten) das sind, was WordPress „Beitragstypen“ nennt. Es gibt einige Standard-Beitragstypen, die in WordPress integriert sind, aber Entwickler können auch ihre eigenen erstellen, sogenannte benutzerdefinierte Beitragstypen.

EDD selbst führt mehrere benutzerdefinierte Beitragstypen in Ihr System ein, von denen einer der
Download ist. Das ist der einzige, den wir hier besprechen werden.

Wenn Sie nach oben scrollen, um sich die Vorlagenhierarchie für einzelne Beiträge noch einmal anzusehen, werden Sie feststellen, dass
single-{post-type}.php einen höheren Rang hat als single.php. Das impliziert zwei Dinge:

1. Wenn single-{post-type}.php auf das Szenario zutrifft, wird es vor single.php verwendet.
2. Wenn keine single-{post-type}.php-Vorlage existiert, ist die nächste Wahl single.php.

Sofern Ihr Theme nicht speziell für EDD geschrieben wurde, fällt Ihre Situation standardmäßig unter das zweite Szenario. Da der benutzerdefinierte Beitragstyp „Download“ von EDD als „download“ registriert wird, sucht WordPress nach der single.php-Datei, es sei denn, Ihr Theme enthält eine
single-download.php-Datei (oder die Position #1 in der Hierarchie für einzelne Beiträge, die wir nicht besprechen werden).

Das bedeutet, dass Ihr EDD-Download genauso aussieht, wie Ihre Blogbeiträge angezeigt werden. Wenn Ihre Blogbeiträge Informationen zur Autorenzeile, zur Navigation von Beitrag zu Beitrag oder etwas anderes enthalten, wird dies auch für Ihre Downloads angezeigt.

Für viele Benutzer ist dies kein Problem. Für andere kann es unerwünschte Informationen zur Produktanzeige hinzufügen. Oder vielleicht möchten einige Benutzer einfach nicht, dass ihre Produktseiten auf die gleiche Weise wie Blogbeiträge angezeigt werden, was verständlich ist.

single-download.php

Um WordPress mitzuteilen, dass Sie Ihre einzelnen Produktseiten anders als Ihre einzelnen Blogbeiträge anzeigen möchten, müssen Sie in die Vorlagenhierarchie für einzelne Beiträge eingreifen, indem Sie eine
single-download.php-Datei im Stammverzeichnis Ihres aktiven Themes erstellen (was Ihr Child-Theme wäre, wenn Sie eines verwenden).

Wenn diese Datei im Stammverzeichnis Ihres aktiven Themes platziert ist, wird beim Aufrufen der Frontend-Seite für eines Ihrer Produkte die downloadspezifische Vorlage anstelle der Blogbeitragsvorlage aufgerufen. Zu diesem Zeitpunkt haben Sie die Kontrolle über Ihre
single-download.php-Vorlage und können sie nach Belieben erstellen.

Hier ist ein sehr nützlicher Tipp zum Erstellen Ihrer
single-download.php-Vorlage:

Sofern Sie kein Theme-Entwickler sind, der bereits weiß, was er tut, besteht der beste Weg, Ihre anfängliche
single-download.php-Datei zu erstellen, darin, die single.php-Datei Ihres Themes zu duplizieren und dann die Kopie in single-download.php umzubenennen. Zu diesem Zeitpunkt ändert sich nichts an der Anzeige Ihrer Produktseiten. Sie können die neue Vorlagendatei jedoch jetzt bearbeiten, und dies wirkt sich nur auf Ihre Produktseiten aus.

Wenn Sie ein Child-Theme verwenden, bedeutet dies, dass Sie die Vorlage für einzelne Beiträge des Parent-Themes kopieren und in das Stammverzeichnis Ihres Child-Themes einfügen müssten.

singular.php

Die Dinge werden hier etwas komplizierter. Die
singular.php-Datei ist ziemlich neu und obwohl sie nicht so weit verbreitet ist wie die single.php-Datei, ist sie immer noch beliebt. Wie bereits erwähnt, verfügt WordPress über mehrere integrierte Beitragstypen und unterstützt die Erstellung benutzerdefinierter Beitragstypen. Alle diese Beitragstypen gelten als Singulars.

Das bedeutet, dass ein Theme keine single.php-Datei oder sogar eine page.php-Datei (die Vorlage für die Anzeige von WordPress-Seiten) enthalten muss. Wenn eine singular.php-Datei vorhanden ist und keine der spezifischeren Vorlagen verfügbar ist, verwendet WordPress diese für alle Beitragstypen.

Unnötig zu erwähnen, dass diese Vorlagendatei oft bedingte Logik verwenden muss. Das bedeutet:

Wenn die besuchte URL eine Seite ist, verwenden Sie diesen Code, um die Seite anzuzeigen. Wenn die besuchte URL ein Beitrag ist, verwenden Sie diesen Code, um den Beitrag anzuzeigen.

Dies geschieht alles innerhalb einer einzigen Vorlagendatei. Für Websites mit nur Beiträgen und Seiten ist dies einfach. Wenn Sie benutzerdefinierte Beitragstypen einführen, kann dies knifflig werden, da der Theme-Entwickler höchstwahrscheinlich keine Bedingung für den Download-Beitragstyp erstellt hat, d. h. wenn das Theme nicht so geschrieben wurde, dass EDD berücksichtigt wird.

Obwohl dies nicht der richtige Ort ist, um ins Detail zu gehen, wie ein Theme erstellt wird, gilt in diesem Szenario dasselbe wie beim Überschreiben der
single.php für Produktvorlagen. Sie können die singular.php-Datei verwenden, um (durch Duplizieren) eine single-download.php-Datei zu erstellen. Der einzige Unterschied hier ist, dass Sie den Code in dieser Datei besser verstehen müssen, um ihn für die Verwendung mit Produkten zu ändern.

Einzelne Produktvorlagen – Zusammenfassung

Dies ist keine Anleitung zum Erstellen von WordPress-Themes. Stattdessen soll gezeigt werden, wie EDD mit WordPress funktioniert, damit Sie einzelne Produktvorlagen zur Anzeige Ihrer Produktseiten verwenden können.

Wenn Sie kein WordPress-Theme-Entwickler sind, möchten Sie dies vielleicht an jemanden auslagern, der erfahren ist. Die Erstellung der notwendigen Datei ist nur ein Schritt. Die Erstellung (oder Bearbeitung) des Codes in der Datei ist eine völlig separate Aufgabe, die etwas Erfahrung oder zumindest Vertrautheit mit HTML und PHP erfordert.