Inhaltsfragmentvorlagen

VORSICHT

Inhaltsfragmentmodelle werden für die Erstellung aller neuen Inhaltsfragmente empfohlen.

Inhaltsfragmentmodelle werden für alle Beispiele in WKND verwendet.

HINWEIS

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

Inhaltsfragmentvorlagen werden jetzt nicht mehr unterstützt. Sie können weiterhin zum Erstellen von Fragmenten verwendet werden. Es wird jedoch empfohlen, stattdessen Inhaltsfragmentmodelle zu verwenden. Fragmentvorlagen werden keine neuen Funktionen hinzugefügt und in einer zukünftigen Version 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 die Überlagerung von nativen 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 lautet (in absteigender Reihenfolge). /conf, /apps, /libs.

VORSICHT

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:

  1. Erstellen Sie das erforderliche Element (d. h. wie es in vorhanden ist) neu. /libs) unter /apps

  2. 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>
              ...

Dabei ist die bestimmte Struktur:

+ <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

    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 Fragment erstellen Assistent).
    jcr:description

    String

    optional

    Ein Text, der den Zweck der Vorlage beschreibt (angezeigt im Fragment erstellen Assistent).
    initialAssociatedContent

    String[]

    optional

    Ein Array mit Pfaden zu Sammlungen, die standardmäßig mit einem neu erstellten Inhaltsfragment verknüpft werden sollen.
    precreateElements

    Boolean

    required

    true, wenn die Teil-Assets, die die Elemente des Inhaltsfragments darstellen (mit Ausnahme des Übergeordneten Elements), bei der Erstellung des Inhaltsfragments erstellt werden sollen; false , wenn sie "on the fly" erstellt werden sollen.

    Hinweis: Dieser Parameter muss derzeit auf true.

    version

    Long

    erforderlich

    Version der Inhaltsstruktur; derzeit unterstützt:

    Hinweis: Dieser Parameter muss derzeit auf 2.

  • Elemente

    Name Typ Wert
    elements

    nt:unstructured

    erforderlich

    Knoten, der die Definition der Elemente des Inhaltsfragments enthält. Sie ist obligatorisch und muss mindestens einen untergeordneten Knoten für die Main -Element, kann jedoch [1..n] untergeordneten Knoten enthalten.

    Wenn die Vorlage verwendet wird, wird der Unterzweig Elemente in den Modellunterzweig des Fragments kopiert.

    Das erste Element (wie in CRXDE Lite angezeigt) wird automatisch als main Element; der Knotenname ist irrelevant und der Knoten selbst hat keine besondere Bedeutung, abgesehen von der Tatsache, dass er durch das Haupt-Asset dargestellt wird. die anderen Elemente werden als Teil-Assets behandelt.

  • Elementname

    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

    default: ""

    Anfänglicher Inhalt des Elements; nur verwendet, wenn precreateElements = true
    initialContentType

    String

    optional

    default: text/html

    Art des anfänglichen Inhalts des Elements; nur verwendet, wenn precreateElements = true; derzeit unterstützt:

    • text/html
    • text/plain
    • text/x-markdown
    name

    String

    erforderlich

    Interner Name des Elements; muss für den Fragmenttyp eindeutig sein.
  • Varianten

    Name Typ Wert
    variations

    nt:unstructured

    optional

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

    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 (der im Fragment-Editor in der Variante Registerkarte (linke Leiste).
    jcr:desciption

    String

    optional

    default: ""

    Ein Text mit einer Beschreibung der Variante (wird im Fragment-Editor in der Variante Registerkarte (linke Leiste).

Auf dieser Seite