Modelli di pagina page-templates

Durante la creazione di una pagina è necessario selezionare un modello. Il modello di pagina viene utilizzato come base per la nuova pagina. Il modello definisce la struttura della pagina risultante, eventuali contenuti iniziali e i componenti che possono essere utilizzati (proprietà di progettazione). Questo offre diversi vantaggi:

Con Modelli di pagina, i pezzi che compongono una pagina sono isolati 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 creating-a-new-template

La creazione di modelli di pagina 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 reattivo standard.

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.