DokumentationAEM 6.4Entwickleranleitung

Vorlagen templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Vorlagen werden an verschiedenen Stellen in AEM verwendet:

Die folgenden Vorlagen werden im Detail beschrieben:

Vorlagen - Seiten templates-pages

AEM bietet jetzt zwei grundlegende Arten von Vorlagen zum Erstellen von Seiten:

NOTE
Wenn Sie eine Vorlage zum Erstellen einer neuen Seite verwenden, gibt es keinen sichtbaren Unterschied (zum Autor der Seite) und keine Angabe zum Typ der verwendeten Vorlage.

Bearbeitbare Vorlagen editable-templates

Bearbeitbare Vorlagen werden jetzt als Best Practices für die Entwicklung mit AEM betrachtet.

Die Vorteile bearbeitbarer Vorlagen:

  • Kann created und bearbeitet durch Ihre Autoren.

  • wurden eingeführt, damit Sie Folgendes für alle Seiten definieren können, die mit der Vorlage erstellt werden:

    • Struktur
    • den anfänglichen Inhalt
    • Content-Richtlinien

  • Nachdem die neue Seite erstellt wurde, wird eine dynamische Verbindung zwischen der Seite und der Vorlage aufrechterhalten. Das bedeutet, dass Änderungen an der Vorlagenstruktur auf allen mit dieser Vorlage erstellten Seiten wiedergegeben werden (Änderungen am ursprünglichen Inhalt werden nicht berücksichtigt).

  • Verwendet Inhaltsrichtlinien (die im Vorlageneditor bearbeitet wurden), um die Designeigenschaften beizubehalten (verwendet den Designmodus im Seiteneditor nicht).

  • Werden gespeichert unter /conf

  • Siehe Bearbeitbare Vorlagen für weitere Informationen.

NOTE
In einem AEM-Community-Artikel wird erläutert, wie Sie eine Experience Manager-Website mit bearbeitbaren Vorlagen erstellen, siehe Erstellen einer Adobe Experience Manager 6.4-Website mit bearbeitbaren Vorlagen.

Statische Vorlagen static-templates

Statische Vorlagen:

  • Muss von Ihren Entwicklern definiert und konfiguriert werden.
  • Dies war das ursprüngliche Vorlagensystem von AEM und war für viele Versionen verfügbar.
  • Eine statische Vorlage ist eine Hierarchie von Knoten mit derselben Struktur wie die zu erstellende Seite, jedoch ohne tatsächlichen Inhalt.
  • werden kopiert, um die neue Seite zu erstellen. Danach existiert keine dynamische Verbindung.
  • Verwendet Designmodus um Designeigenschaften beizubehalten.
  • Werden gespeichert unter /apps
  • Siehe Statische Vorlagen für weitere Informationen.
NOTE
Ab AEM 6.4 gilt die Verwendung statischer Vorlagen nicht mehr als Best Practice. Verwenden Sie stattdessen bearbeitbare Vorlagen.
AEM-Modernisierung-Tools können Ihnen bei der Migration von statischen zu bearbeitbaren Vorlagen helfen.

Verfügbarkeit von Vorlagen template-availability

CAUTION
AEM bietet verschiedene Eigenschaften zur Steuerung der unter Sites zulässigen Vorlagen. Eine Kombination daraus kann jedoch zu komplexen Regeln führen, die sich nur schwer verfolgen und verwalten lassen.
Daher empfiehlt Adobe, einfach anzufangen, indem Sie Folgendes definieren:

  • nur die cq:allowedTemplates-Eigenschaft

  • nur im Site-Stamm

Ein Beispiel finden Sie unter „We.Retail“: /content/we-retail/jcr:content
Außerdem können die Eigenschaften allowedPaths, allowedParents und allowedChildren in den Vorlagen platziert werden, um komplexere Regeln zu definieren. Es ist jedoch nach Möglichkeit deutlich einfacher, in Unterabschnitten der Site weitere cq:allowedTemplates-Eigenschaften zu definieren, wenn die zulässigen Vorlagen weiter eingeschränkt werden sollen.
Ein weiterer Vorteil besteht darin, dass die cq:allowedTemplates-Eigenschaften von einem Autor auf der Registerkarte Erweitert der Seiteneigenschaften aktualisiert werden können. Die anderen Vorlageneigenschaften können nicht über die (standardmäßige) Benutzeroberfläche aktualisiert werden. Dafür wird ein Entwickler benötigt, der die Regeln und Code-Implementierung für jede Änderung pflegt.

Beim Erstellen einer neuen Seite in der Website-Admin-Oberfläche hängt die Liste der verfügbaren Vorlagen vom Speicherort der neuen Seite und den in den einzelnen Vorlagen angegebenen Platzierungsbeschränkungen ab.

Die folgenden Eigenschaften bestimmen, ob eine Vorlage T für eine neue Seite verwendet werden darf, die der Seite P untergeordnet platziert werden kann. Jede dieser Eigenschaften ist eine mehrwertige Zeichenfolge, welche null oder mehrere reguläre Ausdrücke enthält, die für die Übereinstimmung mit Pfaden verwendet werden:

  • Die Eigenschaft cq:allowedTemplates des Unterknotens jcr:content von P oder ein Vorgänger von P.

  • Die allowedPaths-Eigenschaft von T.

  • Die allowedParents-Eigenschaft von T.

  • Die allowedChildren-Eigenschaft der Vorlage von P.

Die Bewertung funktioniert wie folgt:

  • Die erste nicht leere Eigenschaft cq:allowedTemplates, die beim Aufrufen der mit P beginnenden Seitenhierarchie gefunden wird, wird mit dem Pfad von T abgeglichen. Wenn keiner der Werte übereinstimmt, wird T abgelehnt.

  • Wenn T eine nicht leere allowedPaths-Eigenschaft hat, aber keiner der Werte mit dem Pfad von P übereinstimmt, wird T zurückgewiesen.

  • Wenn beide oben genannten Eigenschaften entweder leer oder nicht vorhanden sind, wird T abgelehnt, es sei denn, es gehört zum selben Programm wie P. T gehört genau dann zum selben Programm wie P, wenn der Name der zweiten Ebene des Pfades von T mit dem Namen der zweiten Ebene des Pfades von P übereinstimmt. Zum Beispiel gehört die Vorlage /apps/geometrixx/templates/foo zum selben Programm wie die Seite /content/geometrixx.

  • Wenn T eine nicht leere allowedParents-Eigenschaft hat, aber keiner der Werte mit dem Pfad von P übereinstimmt, wird T zurückgewiesen.

  • Wenn die Vorlage von P eine nicht leere allowedChildren-Eigenschaft hat, aber keiner der Werte mit dem Pfad von T übereinstimmt, wird T zurückgewiesen.

  • In allen anderen Fällen ist T zulässig.

Das folgende Diagramm zeigt den Vorlagenauswertungsprozess:

chlimage_1-176

Einschränkende Vorlagen in untergeordneten Seiten limiting-templates-used-in-child-pages

Um zu begrenzen, welche Vorlagen zum Erstellen von untergeordneten Seiten unter einer bestimmten Seite verwendet werden können, verwenden Sie die Eigenschaft cq:allowedTemplates des Knotens jcr:content auf der Seite. Damit lässt sich die Liste der Vorlagen angeben, die als untergeordnete Seiten zulässig sein sollen. Jeder Wert in der Liste muss ein absoluter Pfad zu einer Vorlage für eine zulässige untergeordnete Seite sein, zum Beispiel /apps/geometrixx/templates/contentpage.

Sie können die Eigenschaft cq:allowedTemplates im Knoten jcr:content der Vorlage verwenden, damit diese Konfiguration auf alle neu erstellten Seiten angewendet wird, die diese Vorlage nutzen.

Wenn Sie mehrere Einschränkungen hinzufügen möchten, z. B. bezüglich der Vorlagenhierarchie, können Sie die Eigenschaften allowedParents/allowedChildren auf der Vorlage verwenden. Sie können dann explizit angeben, dass Seiten, die aus einer Vorlage T erstellt wurden, übergeordnet/untergeordnet von Seiten sein müssen, die aus einer Vorlage T erstellt wurden.

Vorlagen - Inhaltsfragmente templates-content-fragments

Siehe Inhaltsfragmentvorlagen für vollständige Informationen.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e