Sjablonen voor inhoudsfragmenten content-fragment-templates

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

CAUTION

de fragmentmodellen van de Inhoudworden geadviseerd voor het creëren van alle nieuwe inhoudsfragmenten.

Inhoudsfragmentmodellen worden voor alle voorbeelden in WKND gebruikt.

NOTE

Voorafgaand aan AEM 6.3 werden de Fragments van de Inhoud gecreeerd gebaseerd op malplaatjes in plaats van modellen.

Sjablonen voor inhoudsfragmenten zijn nu afgekeurd. Ze kunnen nog steeds worden gebruikt voor het maken van fragmenten, maar het gebruik van Content Fragment Models wordt aangeraden. Er worden geen nieuwe functies toegevoegd aan fragmentsjablonen en deze worden in een toekomstige versie verwijderd.

Sjablonen worden geselecteerd wanneer u een inhoudsfragment maakt. Zij verstrekken het nieuwe fragment de basisstructuur, element(en) en variatie. De sjablonen die voor inhoudsfragmenten worden gebruikt, zijn afhankelijk van de Granite Configuration Manager.

De out-of-the-box sjablonen worden bewaard onder:

/libs/settings/dam/cfm/templates

U kunt uw sitespecifieke sjablonen voor inhoudsfragmenten maken onder:

/apps/settings/dam/cfm/templates
De locatie voor het bedekken van out-of-the-box sjablonen of het aanbieden van klantspecifieke, toepassingsbrede sjablonen die niet bedoeld zijn om tijdens runtime te worden uitgebreid/gewijzigd.
/conf/global/settings/dam/cfm/templates
De locatie voor klantspecifieke sjablonen die voor de hele organisatie moeten worden gewijzigd tijdens runtime.

De prioriteitsvolgorde is (in aflopende volgorde) /conf , /apps , /libs .

CAUTION

U moet niets in de /libs weg veranderen.

De reden hiervoor is dat de inhoud van /libs de volgende keer dat u een upgrade uitvoert van de instantie wordt overschreven (en dat deze inhoud ook kan worden overschreven wanneer u een hotfix- of functiepakket toepast).

De aanbevolen methode voor configuratie en andere wijzigingen is:

Het vereiste item opnieuw maken (dat wil zeggen, zoals het in /libs staat) onder /apps
Breng eventuele wijzigingen aan binnen /apps

De basisstructuur van een template wordt aangehouden onder:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Met de specifieke structuur:

+ <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

Meer details over de knopen en hun eigenschappen zijn:

Malplaatje

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
Naam	Type	Waarde
`<template-name>`	`nt:unstructured`	Dit knooppunt is de basis voor elke sjabloon. Het is verplicht en moet een unieke naam hebben.
`jcr:title`	`String` required	De titel van het malplaatje (dat in wordt getoond leidt tot de tovenaar van het Fragment ).
`jcr:description`	`String` optioneel	Een tekst die het doel van het malplaatje beschrijft (getoond in creeer de tovenaar van het Fragment ).
`initialAssociatedContent`	`String[]` optioneel	Een array met paden naar verzamelingen die standaard aan een nieuw gemaakt inhoudsfragment moeten worden gekoppeld.
`precreateElements`	`Boolean` vereist	`true`, als subassets die de elementen (behalve het hoofdelement) van het inhoudsfragment vertegenwoordigen zouden moeten worden gecreeerd wanneer het inhoudsfragment wordt gecreeerd; vals als zij "op de vlucht"zouden moeten worden gecreeerd. Nota : momenteel moet deze parameter aan `true` worden geplaatst.
`version`	`Long` vereist	Versie van de inhoudsstructuur; momenteel ondersteund: Nota : momenteel moet deze parameter aan `2` worden geplaatst.

Elementen

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

Naam Type Waarde

elements

nt:unstructured

vereist

Knooppunt dat de definitie van de elementen van het inhoudsfragment bevat. Het is verplicht en moet minstens één kindknoop voor het Belangrijkste element bevatten, maar kan [1.. bevatten.n] onderliggende knooppunten.

Wanneer de sjabloon wordt gebruikt, wordt de elementensubvertakking gekopieerd naar de modelsubvertakking van het fragment.

Het eerste element (zoals die in CRXDE Lite wordt bekeken) wordt automatisch beschouwd als om het belangrijkste element; de knoopnaam is irrelevant en de knoop zelf heeft geen speciale betekenis, behalve het feit dat het door het belangrijkste activa wordt vertegenwoordigd; de andere elementen worden behandeld als subactiva.

Naam van het Element

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
Naam	Type	Waarde
`<element-name>`	`nt:unstructured`	Dit knooppunt definieert een element. Het is verplicht en moet een unieke naam hebben.
`jcr:title`	`String` vereist	De titel van het element (wordt weergegeven in de elementenkiezer van de fragmenteditor).
`defaultContent`	`String` optioneel default: ""	Oorspronkelijke inhoud van het element; wordt alleen gebruikt als `precreateElements` = `true`
`initialContentType`	`String` optioneel standaard: `text/html`	Oorspronkelijk inhoudstype van het element; alleen gebruikt als `precreateElements` = `true`; momenteel ondersteund: `text/html` `text/plain` `text/x-markdown`
`name`	`String` vereist	De interne naam van het element; moet uniek zijn voor het fragmenttype.

Variaties

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

Naam Type Waarde

variations

nt:unstructured

optioneel

Dit optionele knooppunt bevat de definitie van de initiële variaties van het inhoudsfragment.

de Naam van de Variatie

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Naam	Type	Waarde
`<variation-name>`	`nt:unstructured` vereist als er een variatieknooppunt aanwezig is	Definieert een oorspronkelijke variatie. De variatie wordt standaard toegevoegd aan alle elementen van het inhoudsfragment. De variatie zal de zelfde aanvankelijke inhoud hebben zoals het respectieve element (zie `defaultContent/ initialContentType` )
`jcr:title`	`String` vereist	De titel van de variatie (die in het 0} wordt getoond van de fragmentredacteur { lusje van de Variatie (linkerspoor)).
`jcr:desciption`	`String` optioneel default: ""	Een tekst die een beschrijving van de variatie (getoond in het 1} Verandering lusje van de fragmentredacteur (linkerspoor)) verstrekt.

recommendation-more-help

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