Sjablonen voor inhoudsfragmenten

LET OP

Voor bepaalde functionaliteit van contentfragment is de toepassing van AEM 6.4 Service Pack 2 (6.4.2.0) vereist.

LET OP

Het wordt nu aanbevolen om al uw fragmenten te maken.

De fragmentmodellen van de inhoud worden gebruikt voor alle voorbeelden in Wij.Retail.

Sjablonen worden geselecteerd wanneer u een inhoudsfragment maakt. Ze bieden het nieuwe fragment de basisstructuur, elementen en variatie. De sjablonen die voor inhoudsfragmenten worden gebruikt, zijn afhankelijk van de Granite Configuration Manager.

De out-of-the-box sjablonen worden bewaard onder:

  • /libs/settings/dam/cfm/templates

U kunt uw sitespecifieke sjablonen voor inhoudsfragmenten maken onder:

  • /apps/settings/dam/cfm/templates

    De locatie voor het bedekken van out-of-the-box sjablonen of het aanbieden van klantspecifieke, toepassingsbrede sjablonen die niet bedoeld zijn om tijdens runtime te worden uitgebreid/gewijzigd.

  • /conf/global/settings/dam/cfm/templates

    De locatie voor klantspecifieke sjablonen die voor de hele organisatie moeten worden gewijzigd tijdens runtime.

De rangorde is (in aflopende volgorde) /conf, /apps, /libs.

LET OP

U must verandert niets in /libs weg.

Dit komt doordat de inhoud van /libs de volgende keer wordt overschreven dat u uw exemplaar bijwerkt (en dat kan worden overschreven wanneer u een hotfix- of functiepakket toepast).

De aanbevolen methode voor configuratie en andere wijzigingen is:

  1. Het vereiste item opnieuw maken (dat wil zeggen zoals het bestaat in /libs) onder /apps

  2. Wijzigingen aanbrengen binnen /apps

De basisstructuur van een template wordt aangehouden onder:

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

Met de specifieke structuur:

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

Meer details over de knopen en hun eigenschappen zijn:

  • Sjabloonmodel
Naam Type Waarde
<template-name> nt:unstructured Dit knooppunt is de basis voor elke sjabloon. Het is verplicht en moet een unieke naam hebben.
jcr:title

String

required

De titel van de sjabloon (weergegeven in de wizard Fragment maken).
jcr:description

String

optioneel

Een tekst die het doel van het malplaatje beschrijft (die in Create Fragment tovenaar wordt getoond).
initialAssociatedContent

String[]

optioneel

Een array met paden naar verzamelingen die standaard aan een nieuw gemaakt inhoudsfragment moeten worden gekoppeld.
precreateElements

Boolean

required

true, als de subassets die de elementen (behalve het master element) van het inhoudsfragment vertegenwoordigen, moeten worden gemaakt wanneer het inhoudsfragment wordt gemaakt; false als deze 'ter plekke' moeten worden gemaakt.

Opmerking: momenteel moet deze parameter worden ingesteld op true.

version

Long

vereist

Versie van de inhoudsstructuur; momenteel ondersteund:

Opmerking: momenteel moet deze parameter worden ingesteld op 2.

  • Elementen
Naam Type Waarde
elements

nt:unstructured

vereist

Knooppunt dat de definitie van de elementen van het inhoudsfragment bevat. Het is verplicht en moet minstens één kindknoop voor het Hoofd element bevatten, maar kan [1.. bevatten.n] onderliggende knooppunten.

Wanneer de sjabloon wordt gebruikt, wordt de elementensubvertakking gekopieerd naar de modelsubvertakking van het fragment.

Het eerste element (zoals weergegeven in CRXDE Lite) wordt automatisch beschouwd als het main-element; de knooppuntnaam is irrelevant en het knooppunt zelf heeft geen speciale betekenis, afgezien van het feit dat het wordt vertegenwoordigd door het hoofdactief; de overige elementen worden behandeld als subactiva.

  • Elementnaam
Naam Type Waarde
<element-name> nt:unstructured Dit knooppunt definieert een element. Het is verplicht en moet een unieke naam hebben.
jcr:title

String

vereist

De titel van het element (wordt weergegeven in de elementenkiezer van de fragmenteditor).
defaultContent

String

optioneel

default: ""

de initiële inhoud van het element; alleen worden gebruikt als precreateElements = true
initialContentType

String

optioneel

default: text/html

Eerste inhoudstype van het element; alleen worden gebruikt als precreateElements = true; momenteel ondersteund:

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

String

vereist

De interne naam van het element; moet uniek zijn voor het fragmenttype.
  • Variaties
Naam Type Waarde
variations

nt:unstructured

optioneel

Dit optionele knooppunt bevat de definitie van de initiële variaties van het inhoudsfragment.
  • Naam variatie
Naam Type Waarde
<variation-name>

nt:unstructured

vereist als er een variatieknooppunt aanwezig is

Definieert een oorspronkelijke variatie.
De variatie wordt standaard toegevoegd aan alle elementen van het inhoudsfragment.

De variatie zal de zelfde aanvankelijke inhoud hebben zoals het respectieve element (zie defaultContent/ initialContentType)

jcr:title

String

vereist

De titel van de variatie (weergegeven in de tab Variatie van de fragmenteditor (linkerrail)).
jcr:desciption

String

optioneel

standaard: ""

Een tekst die een beschrijving van de variatie (getoond in Variatie tabel (linkerspoor)). verstrekt.

Op deze pagina