Mallar för innehållsfragment content-fragment-templates
Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i
teknisk supportperiod. Hitta de versioner som stöds
här.
Modeller för innehållsfragment används för alla exempel i We.Retail.
Mallar väljs när ett innehållsfragment skapas. De ger det nya fragmentet grundläggande struktur, element och variation. Mallarna som används för innehållsfragment omfattas av Granite Configuration Manager.
De färdiga mallarna finns i
/libs/settings/dam/cfm/templates
Du kan skapa webbplatsspecifika mallar för innehållsfragment under:
-
/apps/settings/dam/cfm/templates
Plats för att täcka över färdiga mallar eller tillhandahålla kundspecifika, programövergripande mallar som inte är avsedda att utökas/ändras under körning.
-
/conf/global/settings/dam/cfm/templates
Platsen för användarspecifika mallar för hela instansen som behöver ändras vid körning.
Prioritetsordningen är (i fallande ordning) /conf, /apps, /libs.
Du måste ändrar ingenting i /libs bana.
Detta beror på innehållet i /libs skrivs över nästa gång du uppgraderar din instans (och kan mycket väl skrivas över när du använder en snabbkorrigering eller ett funktionspaket).
Den rekommenderade metoden för konfiguration och andra ändringar är:
-
Återskapa önskat objekt (d.v.s. som det finns i /libs) under /apps
-
Gör ändringar i /apps
En malls grundläggande struktur hålls under
conf
global
settings
dam
cfm
templates
<template-name>
...
Med den specifika strukturen:
+ <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
Mer information om noderna och deras egenskaper är:
<template-name>
nt:unstructured
Den här noden är roten för varje mall. Det är obligatoriskt och ska ha ett unikt namn.
jcr:title
Mallens titel (visas i Skapa fragment guide).
jcr:description
En text som beskriver syftet med mallen (visas i Skapa fragment guide).
initialAssociatedContent
En array med sökvägar till samlingar som ska kopplas till ett nyligen skapat innehållsfragment som standard.
precreateElements
true, om de delresurser som representerar elementen (utom det överordnad elementet) i innehållsfragmentet ska skapas när innehållsfragmentet skapas, false om de ska skapas "i farten".
Anteckning: för närvarande måste den här parametern anges till true.
version
Innehållsstrukturens version. stöds för närvarande:
Anteckning: för närvarande måste den här parametern anges till 2.
elements
nt:unstructured
obligatoriskt
En nod som innehåller definitionen av elementen i innehållsfragmentet. Det är obligatoriskt och måste innehålla minst en underordnad nod för Huvud -element, men kan innehålla [1..n] underordnade noder.
När mallen används kopieras elementundergrenen till fragmentets modellundergren.
Det första elementet (som det visas i CRXDE Lite) anses automatiskt vara main element, nodnamnet är irrelevant och noden i sig inte har någon särskild betydelse, förutom det faktum att den representeras av huvudtillgången, övriga element hanteras som undertillgångar.
<element-name>
nt:unstructured
Den här noden definierar ett element. Det är obligatoriskt och ska ha ett unikt namn.
jcr:title
Elementets rubrik (visas i fragmentredigerarens elementväljare).
defaultContent
String
valfri
standard: ""
Elementets ursprungliga innehåll. används endast om precreateElements = true
initialContentType
String
valfri
standard: text/html
Elementets ursprungliga innehållstyp. används endast om precreateElements = true; stöds för närvarande:
text/htmltext/plaintext/x-markdown
name
Elementets interna namn. måste vara unik för fragmenttypen.
variations
Den här valfria noden innehåller definitionen av de ursprungliga variationerna för innehållsfragmentet.
<variation-name>
nt:unstructured
krävs om det finns en variantnod
Definierar en ursprunglig variation.
Variationen läggs som standard till i alla element i innehållsfragmentet.
Variationen kommer att ha samma ursprungliga innehåll som respektive element (se defaultContent/ initialContentType)
jcr:title
Variantens titel (visas i fragmentredigerarens Variation tabbtangenten.
jcr:desciption
String
valfri
standard: ""
En text som innehåller en beskrivning av variationen (visas i fragmentredigerarens Variation tabbtangenten.