Sjablonen voor inhoudsfragmenten content-fragment-templates
Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze
technische ondersteuningsperioden. Ondersteunde versies zoeken
hier.
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.
U moet niets wijzigen in de /libs pad.
Dit komt omdat de inhoud van /libs wordt de volgende keer overschreven wanneer u een upgrade uitvoert van uw exemplaar (en kan worden overschreven wanneer u een hotfix- of functiepakket toepast).
De aanbevolen methode voor configuratie en andere wijzigingen is:
-
Het vereiste item opnieuw maken (bijvoorbeeld zoals het bestaat in /libs) onder /apps
-
Breng wijzigingen aan in /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:
<template-name>
nt:unstructured
Dit knooppunt is de basis voor elke sjabloon. Het is verplicht en moet een unieke naam hebben.
jcr:title
De titel van de sjabloon (weergegeven in de Fragment maken wizard).
jcr:description
Een tekst die het doel van de sjabloon beschrijft (weergegeven in het dialoogvenster Fragment maken wizard).
initialAssociatedContent
Een array met paden naar verzamelingen die standaard aan een nieuw gemaakt inhoudsfragment moeten worden gekoppeld.
precreateElements
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 ze "ter plekke" moeten worden gemaakt.
Opmerking: momenteel moet deze parameter worden ingesteld op true.
version
Versie van de inhoudsstructuur; momenteel ondersteund:
Opmerking: momenteel moet deze parameter worden ingesteld op 2.
elements
Knooppunt dat de definitie van de elementen van het inhoudsfragment bevat. Het is verplicht en moet ten minste één onderliggend knooppunt voor het Hoofd element, but can contain [1..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 eerste element hoofd 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.
<element-name>
nt:unstructured
Dit knooppunt definieert een element. Het is verplicht en moet een unieke naam hebben.
jcr:title
De titel van het element (wordt weergegeven in de elementenkiezer van de fragmenteditor).
defaultContent
String
optioneel
standaard: ""
de initiële inhoud van het element; alleen worden gebruikt als precreateElements = true
initialContentType
String
optioneel
standaard: text/html
Eerste inhoudstype van het element; alleen worden gebruikt als precreateElements = true; momenteel ondersteund:
text/htmltext/plaintext/x-markdown
name
De interne naam van het element; moet uniek zijn voor het fragmenttype.
variations
nt:unstructured
optioneel
Dit optionele knooppunt bevat de definitie van de initiële variaties van het inhoudsfragment.
<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 wijziging heeft dezelfde initiële inhoud als het betreffende element (zie defaultContent/ initialContentType)
jcr:title
De titel van de variatie (weergegeven in de fragmenteditor) Variatie tab (linkerspoor).
jcr:desciption
String
optioneel
standaard: ""
Een tekst die een beschrijving van de wijziging bevat (weergegeven in de Variatie tab (linkerspoor).