DokumentationAEM 6.5Användarhandbok

Mallar för innehållsfragment

13 juli 2024
  • Ä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:

  1. Återskapa det obligatoriska objektet (det vill säga 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

    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

    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

    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

    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

    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