Modelli per frammenti di contenuto content-fragment-templates

CAUTION
I 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.
NOTE
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.

CAUTION
must non modificare nulla nel percorso /libs.
Il contenuto di /libs viene sovrascritto al successivo aggiornamento dell'istanza (e potrebbe essere sovrascritto quando si applica un hotfix o un feature pack).
Il metodo consigliato per la configurazione e altre modifiche è:
  1. Ricrea l'elemento richiesto (ovvero, poiché esiste in /libs) in /apps

  2. 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

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
    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 nella procedura guidata Crea frammento.
    jcr:description

    String

    facoltativo

    Testo che descrive lo scopo del modello (visualizzato nella procedura guidata Crea frammento).
    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 le risorse secondarie che rappresentano gli elementi (ad eccezione dell’elemento principale) del frammento di contenuto devono essere create al momento della creazione del frammento di contenuto; false se devono essere create "al volo".

    Nota: al momento questo parametro deve essere impostato su true.

    version

    Long

    obbligatorio

    Versione della struttura del contenuto; attualmente supportata:

    Nota: al momento questo parametro deve essere impostato su 2.

  • Elementi

    table 0-row-3 1-row-3 html-authored
    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 l'elemento Main, 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 (come visualizzato in CRXDE Lite) viene automaticamente considerato come l'elemento main; 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 vengono gestiti come risorse secondarie.

  • Nome elemento

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
    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

    table 0-row-3 1-row-3 html-authored
    Nome Tipo Valore
    variations

    nt:unstructured

    facoltativo

    Questo nodo facoltativo contiene la definizione delle varianti iniziali del frammento di contenuto.
  • Nome variante

    table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
    Nome Tipo Valore
    <variation-name>

    nt:unstructured

    obbligatorio se è presente un nodo di variante

    Definisce una variante iniziale.
    Per impostazione predefinita, la variante viene aggiunta a tutti gli elementi del frammento di contenuto.

    La variante avrà lo stesso contenuto iniziale del rispettivo elemento (vedere

    defaultContent/ initialContentType

    )

    jcr:title

    String

    obbligatorio

    Titolo della variante (visualizzato nella scheda Variante dell'editor di frammenti (barra a sinistra).
    jcr:desciption

    String

    facoltativo

    impostazione predefinita: ""

    Testo che fornisce una descrizione della variante (visualizzata nella scheda Variante dell'editor frammenti (barra a sinistra)).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2