Inhaltsfragmentvorlagen content-fragment-templates

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Entwickler

CAUTION

Inhaltsfragmentmodelle werden zum Erstellen aller neuen Inhaltsfragmente empfohlen.

Inhaltsfragmentmodelle werden für alle Beispiele in WKND verwendet.

NOTE

Vor AEM 6.3 wurden Inhaltsfragmente basierend auf Vorlagen statt auf Modellen erstellt.

Inhaltsfragmentvorlagen sind jetzt veraltet. Sie können weiterhin zum Erstellen von Fragmenten verwendet werden. Es wird jedoch empfohlen, stattdessen Inhaltsfragmentmodelle zu verwenden. Zu Fragmentvorlagen werden keine neuen Funktionen hinzugefügt und in einer zukünftigen Version werden sie entfernt.

Vorlagen werden beim Erstellen eines Inhaltsfragments ausgewählt. Sie verleihen dem neuen Fragment Grundstruktur, Element(e) und Variante. Die Vorlagen, die für Inhaltsfragmente verwendet werden, unterliegen dem Granite Configuration Manager.

Die im Lieferumfang enthaltenen Vorlagen befinden sich unter:

/libs/settings/dam/cfm/templates

Sie können Ihre Website-spezifischen Vorlagen für Inhaltsfragmente erstellen unter:

/apps/settings/dam/cfm/templates
Der Speicherort für überlagerte gebrauchsfertige Vorlagen oder die Bereitstellung kundenspezifischer, anwendungsweiter Vorlagen, die zur Laufzeit nicht erweitert/geändert werden sollen.
/conf/global/settings/dam/cfm/templates
Der Speicherort für instanzweite kundenspezifische Vorlagen, die zur Laufzeit geändert werden müssen.

Die Rangfolge ist (in absteigender Reihenfolge) /conf, /apps, /libs.

CAUTION

Sie dürfen keinerlei Änderungen im Pfad /libs vornehmen,

da der Inhalt von /libs überschrieben wird, wenn Sie die Instanz das nächste Mal aktualisieren. (Außerdem kann der Inhalt auch durch Anwenden von Hotfixes oder Feature Packs überschrieben werden.)

Die empfohlene Methode zur Konfiguration und für andere Änderungen sieht wie folgt aus:

Erstellen Sie das erforderliche Element unter /apps neu (d. h. wie es in /libs existiert).
Nehmen Sie die gewünschten Änderungen in /apps vor.

Die grundlegende Struktur einer Vorlage befindet sich unter:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Die spezifische Struktur ist dabei:

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

Weitere Details zu den Knoten und ihren Eigenschaften sind:

Vorlage

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
Name	Typ	Wert
`<template-name>`	`nt:unstructured`	Dieser Knoten ist der Stamm für jede Vorlage. Er ist vorgeschrieben und muss einen eindeutigen Namen haben.
`jcr:title`	`String` required	Der Titel der Vorlage (angezeigt im Assistenten Fragment erstellen).
`jcr:description`	`String` optional	Ein Text, der den Zweck der Vorlage beschreibt (angezeigt im Assistenten Fragment erstellen).
`initialAssociatedContent`	`String[]` optional	Ein Array mit Pfaden zu Sammlungen, die standardmäßig mit einem neu erstellten Inhaltsfragment verknüpft werden sollen.
`precreateElements`	`Boolean` erforderlich	`true`, wenn die Unterelemente, die die Elemente (mit Ausnahme des primären Elements) des Inhaltsfragments repräsentieren, bei der Erstellung des Inhaltsfragments erstellt werden sollen; false, wenn sie im laufenden Betrieb erstellt werden sollen. Hinweis: Dieser Parameter muss derzeit auf `true` gesetzt sein.
`version`	`Long` erforderlich	Version der Inhaltsstruktur; derzeit werden unterstützt: Hinweis: Dieser Parameter muss derzeit auf `2` gesetzt sein.

Elemente

table 0-row-3 1-row-3 html-authored

Name Typ Wert

elements

nt:unstructured

erforderlich

Knoten, der die Definition der Elemente des Inhaltsfragments enthält. Er ist erforderlich und muss mindestens einen untergeordneten Knoten für das Haupt-Element enthalten, kann aber [1..n] untergeordnete Knoten enthalten.

Wenn die Vorlage verwendet wird, wird die Unterverzweigung der Elemente in die Modellunterverzweigung des Fragments kopiert.

Das erste Element (wie in CRXDE Lite angezeigt) wird automatisch als Haupt-Element betrachtet; der Knotenname ist irrelevant und der Knoten selbst hat keine besondere Bedeutung, abgesehen von der Tatsache, dass er durch das Hauptelement repräsentiert wird. Die anderen Elemente werden als Unterelemente behandelt.

Elementname

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
Name	Typ	Wert
`<element-name>`	`nt:unstructured`	Dieser Knoten definiert ein Element. Er ist vorgeschrieben und muss einen eindeutigen Namen haben.
`jcr:title`	`String` erforderlich	Der Titel des Elements (wird in der Elementauswahl des Fragment-Editors angezeigt).
`defaultContent`	`String` optional Standard: ""	Anfänglicher Inhalt des Elements; nur verwendet, wenn `precreateElements` = `true`
`initialContentType`	`String` optional Standard: `text/html`	Art des anfänglichen Inhalts des Elements; nur verwendet, wenn `precreateElements` = `true`; derzeit wird unterstützt: `text/html` `text/plain` `text/x-markdown`
`name`	`String` erforderlich	Interner Name des Elements; muss für den Fragmenttyp eindeutig sein.

Varianten

table 0-row-3 1-row-3 html-authored

Name Typ Wert

variations

nt:unstructured

optional

Dieser optionale Knoten enthält die Definition der anfänglichen Varianten des Inhaltsfragments.

Variantenname

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Name	Typ	Wert
`<variation-name>`	`nt:unstructured` erforderlich, wenn ein Variantenknoten vorhanden ist	Definiert eine anfängliche Variante. Die Variante wird standardmäßig allen Elementen des Inhaltsfragments hinzugefügt. Die Variante hat denselben anfänglichen Inhalt wie das entsprechende Element (siehe `defaultContent/ initialContentType` )
`jcr:title`	`String` erforderlich	Der Titel der Variante (wird im Fragment-Editor auf der Registerkarte Variante angezeigt (linke Leiste)).
`jcr:desciption`	`String` optional Standard: ""	Ein Text mit einer Beschreibung der Variante (wird im Fragment-Editor auf der Registerkarte Variante angezeigt (linke Leiste))

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2