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

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Developing,Content Fragments

Skapat för:

Developer

CAUTION

Modeller för innehållsfragment Vi rekommenderar att du skapar 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 måste ändrar ingenting i dialogrutan /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 installerar 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:

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` 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 huvudelementet) 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	Version av innehållsstrukturen som stöds för närvarande: Anteckning: för närvarande måste den här parametern anges till `2`.

Element

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 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 själva noden har ingen speciell betydelse, förutom att det representeras av huvudtillgången. 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 endast 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.

Variantnamn

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 i fragmentredigerarens Variation tabbtangenten.
`jcr:desciption`	`String` valfri standard: ""	En text som innehåller en beskrivning av variationen (visas i fragmentredigerarens Variation tabbtangenten.

recommendation-more-help

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