Modelli templates
I modelli vengono utilizzati in vari punti di AEM:
-
Quando creazione di una pagina da selezionare come modello; verrà utilizzato come base per la nuova pagina. Il modello definisce la struttura della pagina risultante, gli eventuali contenuti iniziali e il componenti che possono essere utilizzati (proprietà di progettazione).
-
Quando creazione di un frammento di contenuto è necessario selezionare anche un modello. Questo modello definisce la struttura, gli elementi iniziali e le varianti.
Vengono descritti in dettaglio i seguenti modelli:
Modelli - Pagine templates-pages
AEM ora offre due tipi di modelli di base per la creazione di pagine:
Modelli modificabili editable-templates
I modelli modificabili sono ora considerati best practice per lo sviluppo con AEM.
Vantaggi dei modelli modificabili:
-
Può essere creato e modificato dai tuoi autori.
-
Sono stati introdotti per consentire di definire quanto segue per le pagine create con il modello:
- la struttura
- il contenuto iniziale
- criteri dei contenuti
-
Dopo la creazione della nuova pagina viene mantenuta una connessione dinamica tra la pagina e il modello; ciò significa che le modifiche alla struttura del modello verranno applicate a tutte le pagine create con tale modello (le modifiche al contenuto iniziale non verranno applicate).
-
Utilizza i criteri del contenuto (modificati dall’editor dei modelli) per mantenere le proprietà di progettazione (non utilizza la modalità Progettazione nell’editor di pagine).
-
Sono memorizzati in
/conf
-
Vedi Modelli modificabili per ulteriori informazioni.
Modelli statici static-templates
Modelli statici:
- Deve essere definito e configurato dagli sviluppatori.
- Questo era il sistema di modelli originale di AEM ed è disponibile per molte versioni.
- Un modello statico è una gerarchia di nodi con la stessa struttura della pagina da creare, ma senza alcun contenuto effettivo.
- Vengono copiati per creare la nuova pagina, dopo di ciò non esiste alcuna connessione dinamica.
- Usi Modalità Progettazione per mantenere le proprietà di progettazione.
- Sono memorizzati in
/apps
- Vedi Modelli statici per ulteriori informazioni.
Disponibilità dei modelli template-availability
-
solo il
cq:allowedTemplates
property -
solo nella directory principale del sito
/content/we-retail/jcr:content
allowedPaths
, allowedParents
e allowedChildren
può anche essere posizionato sui modelli per definire regole più sofisticate. Tuttavia, quando possibile, è molto più semplice da definire cq:allowedTemplates
nelle sottosezioni del sito se è necessario limitare ulteriormente i modelli consentiti.cq:allowedTemplates
le proprietà possono essere aggiornate da un autore nel Avanzate della scheda Proprietà pagina. Le altre proprietà del modello non possono essere aggiornate utilizzando l’interfaccia utente (standard), pertanto per ogni modifica sarebbe necessario uno sviluppatore per mantenere le regole e una distribuzione del codice.Quando crei una nuova pagina nell’interfaccia di amministrazione del sito, l’elenco dei modelli disponibili dipende dalla posizione della nuova pagina e dalle restrizioni di posizionamento specificate in ciascun modello.
Le proprietà seguenti determinano se un modello T
può essere utilizzato per inserire una nuova pagina come pagina figlia di P
. Ciascuna di queste proprietà è una stringa con più valori contenente zero o più espressioni regolari utilizzate per la corrispondenza con i percorsi:
-
La
cq:allowedTemplates
proprietàjcr:content
sottonodo diP
o un antenato diP
. -
La
allowedPaths
proprietà diT
. -
La
allowedParents
proprietà diT
. -
La
allowedChildren
proprietà del modello diP
.
La valutazione funziona come segue:
-
Il primo non vuoto
cq:allowedTemplates
trovato durante l'ascesa della gerarchia di pagina che inizia conP
viene confrontato con il percorso diT
. Se nessuno dei valori corrisponde,T
è rifiutato. -
Se
T
non è vuotoallowedPaths
, ma nessuno dei valori corrisponde al percorso diP
,T
è rifiutato. -
Se entrambe le proprietà di cui sopra sono vuote o inesistenti,
T
è rifiutato a meno che non appartenga alla stessa domandaP
.T
appartiene alla stessa applicazioneP
se e solo se il nome del secondo livello del percorsoT
è lo stesso del nome del secondo livello del percorsoP
. Ad esempio, il modello/apps/geometrixx/templates/foo
appartiene alla stessa applicazione della pagina/content/geometrixx
. -
Se
T
non è vuotoallowedParents
, ma nessuno dei valori corrisponde al percorso diP
,T
è rifiutato. -
Se il modello di
P
non è vuotoallowedChildren
, ma nessuno dei valori corrisponde al percorso diT
,T
è rifiutato. -
In tutti gli altri casi,
T
è consentito.
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 che possono essere utilizzati per creare pagine figlie sotto una determinata pagina, utilizza la funzione cq:allowedTemplates
proprietà di jcr:content
nodo della pagina per specificare l’elenco di modelli da consentire come pagine figlie. Ogni valore nell’elenco deve essere un percorso assoluto a un modello per una pagina figlio consentita, ad esempio /apps/geometrixx/templates/contentpage
.
È possibile utilizzare cq:allowedTemplates
nella proprietà del modello jcr:content
per applicare questa configurazione a tutte le pagine appena create che utilizzano questo modello.
Se desideri aggiungere altri vincoli, ad esempio per quanto riguarda la gerarchia dei modelli, puoi utilizzare la funzione allowedParents/allowedChildren
nel modello. È quindi possibile specificare esplicitamente che le pagine create da un modello T devono essere padre/figlio di pagine create da un modello T.
Modelli - Frammenti di contenuto templates-content-fragments
Vedi Modelli per frammenti di contenuto per informazioni complete.