Modelli per frammenti di contenuto sono consigliati per la creazione di tutti i nuovi frammenti di contenuto.
I modelli per frammenti di contenuto vengono utilizzati per tutti gli esempi in WKND.
Prima di AEM 6.3, i frammenti di contenuto venivano creati in base a modelli anziché a modelli.
I modelli per frammenti di contenuto sono ora obsoleti. Possono comunque essere utilizzati per la creazione di frammenti, ma si consiglia l’utilizzo di modelli per frammenti di contenuto. Non verranno aggiunte nuove funzioni ai modelli di frammenti e verranno rimosse in una versione futura.
I modelli vengono selezionati durante la creazione di un frammento di contenuto. Forniscono al nuovo frammento la struttura di base, gli elementi e la variante. I modelli utilizzati per i frammenti di contenuto sono soggetti a Granite Configuration Manager.
I modelli predefiniti sono disponibili in:
/libs/settings/dam/cfm/templates
Puoi creare modelli specifici per il sito per i frammenti di contenuto in:
/apps/settings/dam/cfm/templates
Posizione per la sovrapposizione di modelli predefiniti o per la fornitura di modelli specifici per il cliente, validi per l’intera applicazione e non destinati a essere estesi/modificati in fase di esecuzione.
/conf/global/settings/dam/cfm/templates
Posizione dei modelli specifici del cliente a livello di istanza che devono essere modificati in fase di esecuzione.
L’ordine di precedenza è (in ordine decrescente) /conf
, /apps
, /libs
.
Tu deve non modificare nulla in /libs
percorso.
Questo perché il contenuto di /libs
viene sovrascritto al successivo aggiornamento dell’istanza (e potrebbe benissimo essere sovrascritto quando applichi un hotfix o un feature pack).
Il metodo consigliato per la configurazione e altre modifiche è:
Ricrea l'elemento richiesto, ovvero come esiste in /libs
) in /apps
Apporta le modifiche in /apps
La struttura di base di un modello si trova in:
conf
global
settings
dam
cfm
templates
<template-name>
...
Con la struttura specifica:
+ <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
Ulteriori dettagli sui nodi e sulle relative proprietà sono:
Modello
Nome | Tipo | Valore |
---|---|---|
<template-name> |
nt:unstructured |
Questo nodo è la radice di ciascun modello. È obbligatorio e deve avere un nome univoco. |
jcr:title |
obbligatorio |
Titolo del modello (visualizzato nel Crea frammento procedura guidata). |
jcr:description |
facoltativo |
Testo che descrive lo scopo del modello (visualizzato nel Crea frammento procedura guidata). |
initialAssociatedContent |
facoltativo |
Array con percorsi di raccolte che devono essere associati a un frammento di contenuto appena creato per impostazione predefinita. |
precreateElements |
obbligatorio |
Nota: attualmente questo parametro deve essere impostato su |
version |
obbligatorio |
Versione della struttura del contenuto; attualmente supportata: Nota: attualmente questo parametro deve essere impostato su |
Elementi
Nome | Tipo | Valore |
---|---|---|
elements |
obbligatorio |
Nodo che contiene la definizione degli elementi del frammento di contenuto. È obbligatorio e deve contenere almeno un nodo figlio per Principale , ma può contenere [1..n] nodi secondari. Quando si utilizza il modello, il ramo secondario degli elementi viene copiato nel ramo secondario del modello del frammento. Il primo elemento (visualizzato in CRXDE Liti) viene automaticamente considerato come principale Il nome del nodo è irrilevante e il nodo stesso non ha un significato particolare, a parte il fatto che è rappresentato dalla risorsa principale; gli altri elementi sono gestiti come risorse secondarie. |
Nome elemento
Nome | Tipo | Valore |
---|---|---|
<element-name> |
nt:unstructured |
Questo nodo definisce un elemento. È obbligatorio e deve avere un nome univoco. |
jcr:title |
obbligatorio |
Titolo dell’elemento (visualizzato nel selettore degli elementi dell’editor di frammenti). |
defaultContent |
facoltativo impostazione predefinita: "" |
Contenuto iniziale dell’elemento; utilizzato solo se precreateElements = true |
initialContentType |
facoltativo impostazione predefinita: |
Tipo di contenuto iniziale dell’elemento; utilizzato solo se
|
name |
obbligatorio |
Nome interno dell’elemento; deve essere univoco per il tipo di frammento. |
Varianti
Nome | Tipo | Valore |
---|---|---|
variations |
facoltativo |
Questo nodo facoltativo contiene la definizione delle varianti iniziali del frammento di contenuto. |
Nome variante
Nome | Tipo | Valore |
---|---|---|
<variation-name> |
obbligatorio se è presente un nodo di variante |
Definisce una variante iniziale. La variante avrà lo stesso contenuto iniziale del rispettivo elemento (vedi |
jcr:title |
obbligatorio |
Titolo della variante (visualizzato nel file dell’editor di frammenti) Variante (barra a sinistra). |
jcr:desciption |
facoltativo impostazione predefinita: "" |
Testo che fornisce una descrizione della variante (visualizzato nel file dell’editor frammento di Variante (barra a sinistra). |