Modelli per frammenti di contenuto

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.

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	String obbligatorio	Titolo del modello (visualizzato nel Crea frammento procedura guidata).
  jcr:description	String facoltativo	Testo che descrive lo scopo del modello (visualizzato nel Crea frammento procedura guidata).
  initialAssociatedContent	String[] facoltativo	Array con percorsi di raccolte che devono essere associati a un frammento di contenuto appena creato per impostazione predefinita.
  precreateElements	Boolean obbligatorio	true, se al momento della creazione del frammento di contenuto è necessario creare le risorse secondarie che rappresentano gli elementi (ad eccezione dell’elemento principale) del frammento di contenuto; false se devono essere create "al volo". Nota: attualmente questo parametro deve essere impostato su true.
  version	Long obbligatorio	Versione della struttura del contenuto; attualmente supportata: Nota: attualmente questo parametro deve essere impostato su 2.

• Elementi

  Nome	Tipo	Valore
  elements	nt:unstructured 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	String obbligatorio	Titolo dell’elemento (visualizzato nel selettore degli elementi dell’editor di frammenti).
  defaultContent	String facoltativo impostazione predefinita: ""	Contenuto iniziale dell’elemento; utilizzato solo se precreateElements = true
  initialContentType	String facoltativo impostazione predefinita: text/html	Tipo di contenuto iniziale dell’elemento; utilizzato solo se precreateElements = true; attualmente supportato: text/html text/plain text/x-markdown
  name	String obbligatorio	Nome interno dell’elemento; deve essere univoco per il tipo di frammento.

• Varianti

  Nome	Tipo	Valore
  variations	nt:unstructured facoltativo	Questo nodo facoltativo contiene la definizione delle varianti iniziali del frammento di contenuto.

• Nome variante

  Nome	Tipo	Valore
  <variation-name>	nt:unstructured obbligatorio se è presente un nodo di variante	Definisce una variante iniziale. La variante viene aggiunta a tutti gli elementi del frammento di contenuto per impostazione predefinita. La variante avrà lo stesso contenuto iniziale del rispettivo elemento (vedi defaultContent/ initialContentType)
  jcr:title	String obbligatorio	Titolo della variante (visualizzato nel file dell’editor di frammenti) Variante (barra a sinistra).
  jcr:desciption	String facoltativo impostazione predefinita: ""	Testo che fornisce una descrizione della variante (visualizzato nel file dell’editor frammento di Variante (barra a sinistra).