Mallar för innehållsfragment

Senast uppdaterad: 4 maj 2023

Skapat för:

  • Developer
CAUTION
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.
CAUTION
Vissa funktioner för innehållsfragment kräver att AEM 6.4 Service Pack 2 (6.4.2.0).
CAUTION
Modeller för innehållsfragment rekommenderas nu för att skapa alla dina fragment.
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.

CAUTION
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:

  1. Återskapa önskat objekt (d.v.s. som det finns i /libs) under /apps

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

  • Mall
NamnTypVärde
<template-name>nt:unstructuredDen här noden är roten för varje mall. Det är obligatoriskt och ska ha ett unikt namn.
jcr:title

String

obligatoriskt

Mallens titel (visas i Skapa fragment guide).
jcr:description

String

valfri

En text som beskriver syftet med mallen (visas i Skapa fragment guide).
initialAssociatedContent

String[]

valfri

En array med sökvägar till samlingar som ska kopplas till ett nyligen skapat innehållsfragment som standard.
precreateElements

Boolean

obligatoriskt

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

Long

obligatoriskt

Innehållsstrukturens version. stöds för närvarande:

Anteckning: för närvarande måste den här parametern anges till 2.

  • Element
NamnTypVärde
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.

  • Elementnamn
NamnTypVärde
<element-name>nt:unstructuredDen här noden definierar ett element. Det är obligatoriskt och ska ha ett unikt namn.
jcr:title

String

obligatoriskt

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/html
  • text/plain
  • text/x-markdown
name

String

obligatoriskt

Elementets interna namn. måste vara unik för fragmenttypen.
  • Variationer
NamnTypVärde
variations

nt:unstructured

valfri

Den här valfria noden innehåller definitionen av de ursprungliga variationerna för innehållsfragmentet.
  • Variantnamn
NamnTypVärde
<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

String

obligatoriskt

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.
Föregående sida
Nästa sida

Experience Manager