Modelli di pagina - Modificabili

Sono stati introdotti modelli modificabili per:

• Consenti agli autori specializzati di creare e modificare i modelli.

  • Tali autori specializzati sono denominati autori di modelli
  • Gli autori dei modelli devono essere membri del gruppo template-authors.

• Fornire modelli che mantengano una connessione dinamica a tutte le pagine create da tali modelli. In questo modo tutte le modifiche apportate al modello verranno applicate alle pagine stesse.

• Rendete il componente pagina più generico in modo che possa essere utilizzato senza personalizzazione.

Con i modelli modificabili, le parti che compongono una pagina sono isolate all’interno dei componenti. È possibile configurare le combinazioni di componenti necessarie in un’interfaccia utente, eliminando così la necessità di sviluppare un nuovo componente di pagina per ogni variazione di pagina.

Questo documento:

• Fornisce una panoramica sulla creazione di modelli modificabili

  • Per informazioni dettagliate, vedere Creazione di modelli di pagina

• Descrive le attività di amministrazione/sviluppatore necessarie per creare modelli modificabili

• Descrive le basi tecniche dei modelli modificabili

Questo documento presuppone che si abbia già familiarità con la creazione e la modifica di modelli. Consultate il documento di authoring Creazione di modelli di pagina, che descrive in dettaglio le capacità dei modelli modificabili come esposti all'autore del modello.

Creazione di un nuovo modello

La creazione di modelli modificabili viene realizzata principalmente con la console dei modelli ed editor di modelli da un autore di modelli. Questa sezione fornisce una panoramica di questo processo e una descrizione di quanto avviene a livello tecnico.

Per informazioni sull'utilizzo di modelli modificabili in un progetto AEM vedere Creazione di un progetto AEM tramite Lazybones.

Durante la creazione di un nuovo modello modificabile:

1. Create una cartella per i modelli. Questa operazione non è obbligatoria, ma è consigliata.

2. Selezionare un tipo di modello. Viene copiato per creare la definizione del modello.

   NOTA

   Sono disponibili una selezione di tipi di modelli out-of-the-box. Potete anche creare tipi di modelli specifici per il sito, se necessario.

3. Configurate la struttura, i criteri di contenuto, il contenuto iniziale e il layout del nuovo modello.

   Struttura

   • La struttura consente di definire componenti e contenuti per il modello.

   • I componenti definiti nella struttura del modello non possono essere spostati su una pagina risultante, né eliminati da alcuna pagina risultante.

     • Se create un modello in una cartella personalizzata all'esterno del contenuto di esempio di We.Retail, potete scegliere i componenti di base o utilizzare Componenti di base.

   • Se desideri che gli autori delle pagine siano in grado di aggiungere e rimuovere componenti, aggiungi un sistema di paragrafi al modello.

   • I componenti possono essere sbloccati e bloccati di nuovo per consentire di definire il contenuto iniziale.

   Per informazioni dettagliate sulla definizione della struttura da parte dell'autore di un modello, vedere Creazione di modelli di pagina.

   Per informazioni tecniche sulla struttura, vedere Struttura in questo documento.

   Criteri

   • I criteri di contenuto definiscono le proprietà di progettazione di un componente.

     • Ad esempio, i componenti disponibili o le dimensioni minime e massime.

   • Questi sono applicabili al modello (e alle pagine create con tale modello).

   Per informazioni dettagliate sulla definizione dei criteri da parte dell'autore di un modello, vedere Creazione di modelli di pagina.

   Per informazioni tecniche sui criteri, vedere Criteri di contenuto in questo documento.

   Contenuto iniziale

   • Contenuto iniziale definisce il contenuto che verrà visualizzato quando una pagina viene creata per la prima volta in base al modello.
   • Il contenuto iniziale può essere modificato dagli autori della pagina.

   Per informazioni dettagliate sulla definizione della struttura da parte dell'autore di un modello, vedere Creazione di modelli di pagina.

   Per informazioni tecniche sui contenuti iniziali, consultate Contenuto iniziale in questo documento.

   Layout

   • È possibile definire il layout del modello per una serie di dispositivi.
   • Il Layout reattivo per i modelli funziona come per la creazione delle pagine.

   Per informazioni dettagliate sulla modalità in cui un autore del modello definisce il layout del modello, vedere Creazione di modelli di pagina.

   Per informazioni tecniche sul layout del modello, vedere Layout in questo documento.

4. Attivate il modello, quindi consentitelo per specifiche strutture ad albero del contenuto.

   • Un modello può essere abilitato o disabilitato per renderlo disponibile o non disponibile per gli autori di pagine.
   • Un modello può essere reso disponibile o non disponibile per alcuni rami di pagina.

   Per informazioni dettagliate sull'abilitazione di un modello da parte dell'autore di un modello, vedere Creazione di modelli di pagina.

   Per informazioni tecniche sull'abilitazione di un modello, vedere Abilitazione e abilitazione di un modello per noie in questo documento

5. Utilizzatelo per creare pagine di contenuto.

   • Quando si utilizza un modello per creare una nuova pagina, non vi è alcuna differenza visibile e nessuna indicazione tra modelli statici e modificabili.
   • Per l’autore della pagina, il processo è trasparente.

   Per informazioni dettagliate sull'utilizzo dei modelli da parte dell'autore di una pagina per creare una pagina, vedere Creazione e organizzazione di pagine.

   Per informazioni tecniche sulla creazione di pagine con modelli modificabili, consultare Pagine di contenuti risultanti in questo documento.

Cartelle modello

Per organizzare i modelli potete utilizzare le cartelle seguenti:

• globale

• Specifico per il sito

  Le cartelle specifiche del sito create per organizzare i modelli vengono create con un account che dispone di privilegi di amministratore.

In un’istanza AEM standard la cartella globale 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. Potete aggiungere i modelli predefiniti a questa cartella o creare una nuova cartella (scelta consigliata).

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

1. La cartella corrente.
2. Elemento padre/i della cartella corrente.
3. /conf/global
4. /apps
5. /libs

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

Per creare una nuova cartella, potete effettuare le seguenti operazioni:

• Programmaticamente o con CRXDE Lite
• Utilizzo del browser di configurazione

Utilizzo del CRXDE Lite

1. È possibile creare una nuova cartella (in /conf) per l’istanza a livello di programmazione o con CRXDE Lite.

   Deve essere utilizzata la seguente struttura:

   /conf
       <your-folder-name> [sling:Folder]
           settings [sling:Folder]
               wcm [cq:Page]
                   templates [cq:Page]
                   policies [cq:Page]
   

2. È quindi possibile definire le seguenti proprietà sul nodo principale della cartella:

   <your-folder-name> [sling:Folder]

   Nome: jcr:title

   • Tipo: String
   • Valore: Titolo (per la cartella) che si desidera visualizzare nella console Templates.

3. In aggiunta alle autorizzazioni e ai privilegi di authoring standard (ad esempio content-authors) è ora necessario assegnare i gruppi e definire i diritti di accesso (ACL) richiesti agli autori per poter creare i modelli nella nuova cartella.

   Il gruppo template-authors è il gruppo predefinito che deve essere assegnato. Per ulteriori informazioni, vedere la sezione ACL e gruppi riportata di seguito.

   Per informazioni dettagliate sulla gestione e l'assegnazione dei diritti di accesso, vedere Accesso a Rights Management.

Utilizzo del browser di configurazione

1. Andate a Navigazione globale -> Strumenti > Browser di configurazione.

   Le cartelle esistenti sono elencate a sinistra, inclusa la cartella globale.

2. Fai clic su Crea.

3. Nella finestra di dialogo Crea configurazione è necessario configurare i seguenti campi:

   • Titolo: Fornire un titolo per la cartella di configurazione
   • Modelli modificabili: Fare clic per consentire la modifica dei modelli all'interno di questa cartella

4. Fai clic su Crea

ACL e gruppi

Una volta create le cartelle dei modelli (tramite CRXDE o con il browser di configurazione), gli ACL devono essere definiti per i gruppi appropriati per le cartelle dei modelli per garantire la protezione adeguata.

Le cartelle dei modelli per l'implementazione di riferimento We.Retail possono essere utilizzate come esempio.

Il gruppo di autori dei modelli

Il gruppo template-authors è il gruppo utilizzato per gestire l'accesso ai modelli ed è dotato di AEM standard, ma è vuoto. Gli utenti devono essere aggiunti al gruppo per il progetto/sito.

Nella tabella seguente sono elencate le autorizzazioni necessarie per la modifica dei modelli.

Questo gruppo predefinito template-authors copre solo le impostazioni di progetto, dove tutti i membri template-authors possono accedere e creare tutti i modelli. Per le impostazioni più complesse, in cui sono necessari gruppi di autori di modelli multipli per l'accesso separato ai modelli, è necessario creare un numero maggiore di gruppi di autori di modelli personalizzati. Tuttavia, le autorizzazioni per i gruppi di autori dei modelli rimarrebbero invariate.

Modelli precedenti in /conf/global

I modelli non devono più essere memorizzati in /conf/global, tuttavia per alcune installazioni precedenti potrebbero essere ancora presenti dei modelli in questo percorso. SOLO in tali situazioni precedenti, i seguenti percorsi /conf/global dovrebbero essere configurati in modo esplicito.

Tipo di modello

Quando create un nuovo modello, dovete specificare un tipo di modello:

• I tipi di modello forniscono efficacemente i modelli per un modello. Quando create un nuovo modello, la struttura e il contenuto iniziale del tipo di modello selezionato vengono usati per creare il nuovo modello.

  • Il tipo di modello viene copiato per creare il modello.
  • Una volta eseguita la copia, l'unica connessione tra il modello e il tipo di modello è un riferimento statico a scopo informativo.

• I tipi di modello consentono di definire:

  • Il tipo di risorsa del componente pagina.
  • Il criterio del nodo principale, che definisce i componenti consentiti nell'editor modelli.
  • È consigliabile definire i punti di interruzione per la griglia reattiva e l'impostazione dell'emulatore mobile sul tipo di modello. Questo è facoltativo, perché la configurazione può essere definita anche sul singolo modello (vedere Tipo di modello e Gruppi di dispositivi mobili).

• AEM fornisce una piccola selezione di tipi di modelli predefiniti, ad esempio Pagina HTML5 e Pagina modulo adattiva.

  • Altri esempi sono forniti come parte del contenuto di esempio We.Retail.

• I tipi di modelli sono generalmente definiti dagli sviluppatori.

I tipi di modelli forniti vengono memorizzati in:

• /libs/settings/wcm/template-types

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

• /apps/settings/wcm/template-types

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

• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
• /conf/<my-folder>/settings/wcm/template-types
• /conf/global/settings/wcm/template-types

Tipo di modello e gruppi di dispositivi mobili

I gruppi di dispositivi utilizzati per un modello modificabile (impostati come percorso relativo della proprietà cq:deviceGroups) definiscono quali dispositivi mobili sono disponibili come emulatori nella modalità di layout dell'authoring delle pagine. Questo valore può essere impostato in due posizioni:

• Nel tipo di modello modificabile
• Nel modello modificabile

Quando create un nuovo modello modificabile, il valore viene copiato dal tipo di modello al singolo modello. Se il valore non è impostato sul tipo, può essere impostato sul modello. Una volta creato il modello, non esiste alcuna ereditarietà dal tipo al modello.

Creazione di tipi di modelli

Se avete creato un modello che può fungere da base per altri modelli, potete copiare il modello come tipo di modello.

1. Create un modello come fareste con qualsiasi altro modello modificabile come indicato qui, che fungerà da base per il tipo di modello.
2. Utilizzando CRXDE Lite, copiare il modello appena creato dal nodo templates al nodo template-types sotto la cartella template.
3. Eliminate il modello dal nodo templates sotto la cartella template.
4. Nella copia del modello che si trova sotto il nodo template-types, eliminare tutte le proprietà cq:template e cq:templateType jcr:content.

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

CODICE SU GITHUB

Puoi trovare il codice di questa pagina su GitHub

• Apri progetto di tipo "aem-sites-example-custom-template-type" su GitHub
• Scarica il progetto come un file ZIP

Definizioni dei modelli

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

• /conf/<my-folder>/settings/wcm/templates
• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
• /conf/global/settings/wcm/templates

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:

• <template-name>

  • initial
  • jcr:content
  • structure
  • policies
  • thumbnail.png

jcr:content

Questo nodo contiene le proprietà per il modello:

• Nome: jcr:title

• Nome: status

  • Tipo: String
  • Valore: draft, enabled oppure disabled

Struttura

Definisce la struttura della pagina risultante:

• Viene unito al contenuto iniziale ( /initial) durante la creazione di una nuova pagina.

• Le modifiche apportate alla struttura si rifletteranno sulle pagine create con il modello.

• Il nodo root ( structure/jcr:content/root) definisce l'elenco dei componenti che saranno disponibili nella pagina risultante.

  • I componenti definiti nella struttura del modello non possono essere spostati né eliminati dalle pagine risultanti.
  • Quando un componente viene sbloccato, la proprietà editable viene impostata su true.
  • Quando un componente che già contiene contenuto viene sbloccato, il contenuto verrà spostato nel ramo initial.

• Il nodo cq:responsive contiene le definizioni per il layout reattivo.

Contenuto iniziale

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

• Contiene un nodo jcr:content che viene copiato in qualsiasi nuova pagina.
• Viene unito alla struttura ( /structure) durante la creazione di una nuova pagina.
• Eventuali pagine esistenti non verranno aggiornate se il contenuto iniziale viene modificato dopo la creazione.
• Il nodo root contiene un elenco di componenti per definire ciò che sarà disponibile nella pagina risultante.
• Se il contenuto viene aggiunto a un componente in modalità struttura e tale componente viene successivamente sbloccato (o viceversa), tale contenuto viene utilizzato come contenuto iniziale.

Layout

Durante la modifica di un modello è possibile definire il layout, utilizza layout reattivo standard che può essere anche configurato.

Criteri contenuto

I criteri relativi ai contenuti (o alle progettazioni) definiscono le proprietà di progettazione (o design) di un componente. Ad esempio, i componenti disponibili o le dimensioni minime e massime. Questi sono applicabili al modello (e alle pagine create con tale modello). I criteri di contenuto possono essere creati e selezionati nell'editor modelli.

• La proprietà cq:policy, sul nodo root

  /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root

  Fornisce un riferimento relativo al criterio del contenuto per il sistema paragrafo della pagina.

• La proprietà cq:policy, nei nodi espliciti dei componenti in root, fornisce collegamenti ai criteri per i singoli componenti.

• Le definizioni effettive dei criteri sono memorizzate in:

  /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

Criteri di pagina

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

Abilitazione e abilitazione di un modello per l'uso di

1. Abilita modello

   Per poter utilizzare un modello, è necessario che sia attivato:

   • Abilitazione del modello dalla console ​​Modelli.

   • Impostazione della proprietà status sul nodo jcr:content.

     • Ad esempio, on:

       /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content

     • Definire la proprietà:

       • Nome: status
       • Tipo: Stringa
       • Valore: enabled

2. Modelli consentiti

   • Definire i percorsi dei modelli consentiti nelle proprietà pagina della pagina o della pagina principale appropriata di un ramo secondario.

   • Impostare la proprietà:

     cq:allowedTemplates

     Sul nodo jcr:content del ramo richiesto.
     Ad esempio, con un valore di:

   /conf/<your-folder>/settings/wcm/templates/.*;

Pagine contenuto risultanti

Pagine create da modelli modificabili:

• Vengono creati con una sottostruttura ad albero che viene unita da structure e initial nel modello

• Contiene riferimenti alle informazioni contenute nel modello e nel tipo di modello. Questo si ottiene con un nodo jcr:content con le proprietà:

  • cq:template

    Fornisce il riferimento dinamico al modello effettivo; consente di riflettere le modifiche apportate al modello sulle pagine effettive.

  • cq:templateType

    Fornisce un riferimento al tipo di modello.

Il diagramma precedente mostra come i modelli, i contenuti e i componenti si interfacciano:

• Controller - /content/<my-site>/<my-page>

  Pagina risultante che fa riferimento al modello. Il contenuto controlla l’intero processo. In base alle definizioni, accede al modello e ai componenti appropriati.

• Configurazione - /conf/<my-folder>/settings/wcm/templates/<my-template>

  Il modello e i relativi criteri di contenuto definiscono la configurazione della pagina.

• Modello - Pacchetti OSGi

  I bundle OSGI implementano la funzionalità.

• Visualizzazione - /apps/<my-site>/components

  Sia nell’ambiente di creazione che in quello di pubblicazione, il rendering del contenuto viene eseguito da components.

Durante il rendering di una pagina:

• Modelli:

  • Viene fatto riferimento alla proprietà cq:template del relativo nodo jcr:content per accedere al modello che corrisponde a tale pagina.

• Componenti:

  • Il componente pagina unisce la struttura structure/jcr:content del modello alla struttura jcr:content della pagina.

  • Il componente Pagina consente solo all’autore di modificare i nodi della struttura del modello contrassegnati come modificabili (così come altri elementi secondari).

  • Quando si esegue il rendering di un componente su una pagina, il percorso relativo di tale componente viene tracciato dal nodo jcr:content; viene quindi ricercato lo stesso percorso nel nodo policies/jcr:content del modello.

    • La proprietà cq:policy di questo nodo fa riferimento al criterio del contenuto effettivo (ovvero contiene la configurazione di progettazione per quel componente).
    • Questo consente di avere più modelli che riutilizzano le stesse configurazioni dei criteri per i contenuti.

Risorse Business.Adobe.com

Automated Onboarding Auto Form Fill Personalized Experiences Dynamic Media Content Management Headless Cms