Mallar för innehållsfragment content-fragment-templates

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gäller:
Experience Manager 6.5

Ämnen:

Skapat för:

Utvecklare

CAUTION

Modeller för innehållsfragment rekommenderas för att skapa alla nya innehållsfragment.

Innehållsfragmentmodeller används för alla exempel i WKND.

NOTE

Före AEM 6.3 skapades innehållsfragment baserade på mallar i stället för modeller.

Mallar för innehållsfragment är nu föråldrade. De kan fortfarande användas för att skapa fragment, men du bör använda Content Fragment Models i stället. Inga nya funktioner kommer att läggas till i fragmentmallar och de kommer att tas bort i en framtida version.

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 får inte ändra något i sökvägen /libs.

Detta beror på att 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 det obligatoriska objektet (det vill säga 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:

Mall

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
Namn	Typ	Värde
`<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`	`String` krävs	Mallens titel (visas i guiden Skapa fragment).
`jcr:description`	`String` valfri	En text som beskriver syftet med mallen (visas i guiden Skapa fragment ).
`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 huvudelementet) i innehållsfragmentet ska skapas när innehållsfragmentet skapas: false om de ska skapas direkt. Obs!: för närvarande måste den här parametern anges till `true`.
`version`	`Long` obligatoriskt	Version av innehållsstrukturen som stöds för närvarande: Obs!: den här parametern måste vara inställd på `2`.

Elements

table 0-row-3 1-row-3 html-authored

Namn Typ Vä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 elementet Main, 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 -elementet. Nodnamnet är irrelevant och själva noden har ingen speciell betydelse, förutom att det representeras av huvudresursen. De andra elementen hanteras som underresurser.

Elementnamn

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
Namn	Typ	Värde
`<element-name>`	`nt:unstructured`	Den 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 bara om `precreateElements` = `true`
`initialContentType`	`String` valfri standard: `text/html`	Elementets ursprungliga innehållstyp. Används bara 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 unikt för fragmenttypen.

Variationer

table 0-row-3 1-row-3 html-authored

Namn Typ Värde

variations

nt:unstructured

valfri

Den här valfria noden innehåller definitionen av de ursprungliga variationerna för innehållsfragmentet.

Variationsnamn

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Namn	Typ	Vä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 på fliken Variation i fragmentredigeraren (vänster)).
`jcr:desciption`	`String` valfri standard: ""	En text som innehåller en beskrivning av variationen (som visas på fliken Variation i fragmentredigeraren (vänster)).

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2