Modelli modificabili editable-templates

Scopri come vengono utilizzati i modelli modificabili durante la creazione di una pagina, definendone il contenuto iniziale, il contenuto strutturato, le policy di authoring e il layout.

Panoramica overview

Durante la creazione di una pagina è necessario selezionare un modello. Il modello di pagina viene utilizzato come base per la nuova pagina. Il modello può definire la struttura della pagina risultante, tutto il contenuto iniziale e i componenti che possono essere utilizzati (proprietà di progettazione).

I modelli di pagine utilizzati per creare pagine modificabili con Universal Editor utilizzano un sottoinsieme limitato di funzionalità di modelli modificabili. Pertanto, il resto di questo documento si concentra sui modelli modificabili utilizzati per creare pagine modificabili con l’Editor pagina.

Modelli e pagine modificabili modificati con Editor pagina page-editor

Durante la creazione di modelli per la creazione di pagine modificabili con Editor pagina, vengono normalmente identificati gli autori specializzati.

Con i modelli modificabili, le parti che compongono una pagina vengono isolate all’interno dei componenti. Puoi configurare le combinazioni necessarie di componenti in un’interfaccia utente, eliminando in tal modo la necessità di sviluppare un nuovo componente pagina per ogni variante di pagina.

Questo documento:

Creazione di un nuovo modello modificabile creating-a-new-template

La creazione di modelli modificabili viene eseguita principalmente con la console modelli e l'editor modelli da un autore di modelli. Questa sezione offre una panoramica di questo processo e segue con una descrizione di ciò che accade a livello tecnico.

Quando crei un modello modificabile:

Cartelle modelli template-folders

Per organizzare i modelli è possibile utilizzare le cartelle seguenti:

In un'istanza AEM standard la cartella global esiste già nella console modelli. Questa contiene i modelli predefiniti e funge da fallback se nella cartella corrente non sono presenti criteri e/o tipi di modello. Puoi aggiungere i modelli predefiniti a questa cartella o crearne una (scelta consigliata).

I tipi di modello e i criteri vengono ereditati in tutte le cartelle in base al seguente ordine di precedenza:

Viene creato un elenco di tutte le voci consentite. Se le configurazioni si sovrappongono ( path/ label), verrà presentata all'utente solo l'istanza più vicina alla cartella corrente.

Per creare una cartella, puoi effettuare le seguenti operazioni:

Utilizzo di CRXDE Lite using-crxde-lite

Utilizzo del browser configurazioni using-the-configuration-browser

ACL e gruppi acls-and-groups

Una volta create le cartelle di modelli (tramite CRXDE o con il Browser configurazioni), per garantire la corretta protezione è necessario definire gli ACL per i gruppi appropriati per le cartelle di modelli.

È possibile utilizzare come esempio le cartelle dei modelli per l'esercitazione WKND.

Gruppo di autori di modelli the-template-authors-group

Il gruppo template-authors è il gruppo utilizzato per gestire l'accesso ai modelli e viene fornito come standard con AEM, ma è vuoto. Gli utenti devono essere aggiunti al gruppo per il progetto/sito.

La tabella seguente descrive le autorizzazioni necessarie per la modifica dei modelli.

Questo gruppo template-authors predefinito copre solo le impostazioni del progetto, in cui tutti i membri template-authors possono accedere e creare tutti i modelli. Per impostazioni più complesse, in cui sono necessari più gruppi di autori di modelli per separare l’accesso ai modelli, è necessario creare più gruppi di autori di modelli personalizzati. Tuttavia, le autorizzazioni per i gruppi di autori di modelli continuerebbero a essere le stesse.

Tipo di modello template-type

Durante la creazione di un modello è necessario specificare un tipo di modello:

I tipi di modello preconfigurati sono memorizzati in:

I tipi di modello specifici per il sito devono essere memorizzati nella posizione simile di:

Le definizioni per i tipi di modelli personalizzati devono essere memorizzate in cartelle definite dall'utente (scelta consigliata) o in alternativa in global. Ad esempio:

Creazione di tipi di modello creating-template-types

Se è stato creato un modello che può fungere da base per altri modelli, è possibile copiarlo come tipo di modello.

Puoi anche sviluppare un tipo di modello personalizzato utilizzando come base un modello modificabile di esempio, disponibile su GitHub.

CODICE SU GITHUB

Puoi trovare il codice di questa pagina su GitHub

Definizioni dei modelli template-definitions

Le definizioni per i modelli modificabili sono archiviate cartelle definite dall'utente (consigliato) o in alternativa in global. Ad esempio:

Il nodo principale del modello è di tipo cq:Template con una struttura di ossatura di:

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

Gli elementi principali sono i seguenti:

jcr:content jcr-content

Questo nodo contiene le proprietà per il modello:

Struttura structure

Definisce la struttura della pagina risultante:

Contenuto iniziale initial-content

Definisce il contenuto iniziale di una nuova pagina al momento della creazione:

Layout layout

Quando modifichi un modello, puoi definire il layout, questo utilizza il layout responsivo standard, che può essere configurato nella pagina dall'autore di contenuto.

Criteri per contenuto content-policies

I criteri per contenuto definiscono le proprietà di progettazione di un componente. Ad esempio, i componenti disponibili o le dimensioni minime/massime. Sono applicabili al modello (e alle pagine create con il modello). I criteri per i contenuti possono essere creati e selezionati nell’editor modelli.

Criteri di pagina page-policies

I criteri di pagina consentono di definire il criterio contenuto per la pagina (parsys principale), nel modello o nelle pagine risultanti.

Abilitazione e autorizzazione di un modello per l’utilizzo enabling-and-allowing-a-template-for-use

Pagine di contenuto risultanti resultant-content-pages

Pagine create da modelli modificabili:

Il diagramma precedente mostra l’interrelazione tra modelli, contenuto e componenti:

Durante il rendering di una pagina:

Disponibilità dei modelli template-availability

Durante la creazione di una pagina nell’interfaccia di amministrazione del sito, l’elenco dei modelli disponibili dipende dalla posizione della nuova pagina e dalle restrizioni sul posizionamento specificate in ciascun modello.

Le seguenti proprietà determinano se è consentito utilizzare un modello T per inserire una nuova pagina come elemento figlio della pagina P. Ciascuna di queste proprietà è una stringa con più valori contenente zero o più espressioni regolari utilizzate per la corrispondenza con i percorsi:

La valutazione funziona come segue:

Il diagramma seguente illustra il processo di valutazione del modello:

Limitazione dei modelli utilizzati nelle pagine figlie limiting-templates-used-in-child-pages

Per limitare i modelli utilizzabili per creare pagine figlie in una determinata pagina, utilizzare la proprietà cq:allowedTemplates di jcr:content nodo della pagina per specificare l'elenco di modelli consentiti come pagine figlie. Ogni valore nell'elenco deve essere il percorso assoluto di un modello per una pagina figlio consentita, ad esempio /apps/wknd/templates/page-content.

È possibile utilizzare la proprietà cq:allowedTemplates nel nodo jcr:content del modello per applicare questa configurazione a tutte le pagine create che utilizzano questo modello.

Per aggiungere altri vincoli, ad esempio relativi alla gerarchia dei modelli, è possibile utilizzare le proprietà allowedParents/allowedChildren nel modello. È quindi possibile specificare esplicitamente che le pagine create da un modello devono essere padri/figli di pagine create da un modello T.