Show Menu
ARGOMENTI×

Frammenti esperienza

Nozioni di base

Un Frammento esperienza è un gruppo di uno o più componenti, che include contenuto e layout, a cui è possibile fare riferimento tra le pagine.
Un elemento principale e/o variante del frammento esperienza utilizza:
  • sling:resourceType : /libs/cq/experience-fragments/components/xfpage
Poiché non esiste, /libs/cq/experience-fragments/components/xfpage/xfpage.html viene ripristinato
  • sling:resourceSuperType : wcm/foundation/components/page

La rappresentazione HTML semplice

Utilizzando il .plain. selettore nell’URL, potete accedere alla rappresentazione HTML semplice.
Questo è disponibile dal browser, ma il suo scopo principale è consentire ad altre applicazioni (ad esempio, app Web di terze parti, implementazioni mobili personalizzate) di accedere direttamente al contenuto del frammento esperienza, utilizzando solo l'URL.
La rappresentazione HTML semplice aggiunge protocollo, host e percorso contestuale a percorsi che sono:
  • del tipo: src , href oppure action
  • o terminare con: -src , oppure -href
Esempio:
.../brooklyn-coat/master.plain.html
I collegamenti fanno sempre riferimento all’istanza di pubblicazione. Sono destinati a essere utilizzati da terzi, pertanto il collegamento verrà sempre chiamato dall’istanza pubblica, non dall’autore.
Il selettore di rappresentazione semplice utilizza un trasformatore invece di script aggiuntivi; il trasformatore Sling Rewriter . Questa è configurata in
  • /libs/experience-fragments/config/rewriter/experiencefragments

Variazioni social

Le varianti social possono essere pubblicate sui social media (testo e immagine). In AEM queste varianti social possono contenere componenti; ad esempio, componenti di testo, componenti immagine.
L'immagine e il testo per il post social possono essere tratti da qualsiasi tipo di risorsa immagine o testo a qualsiasi livello di profondità (nel blocco predefinito o nel contenitore di layout).
Le variazioni sociali consentono anche di creare blocchi e di tenerne conto quando si effettuano azioni sociali (nell’ambiente di pubblicazione).
Per pubblicare il testo e l'immagine corretti sul social media, alcune convenzioni devono essere rispettate se state sviluppando componenti personalizzati.
A tal fine, è necessario utilizzare le seguenti proprietà:
  • Per l'estrazione dell'immagine
    • fileReference
    • fileName
  • Per l'estrazione del testo
    • text
I componenti che non utilizzano questa convenzione non saranno presi in considerazione.

Modelli per frammenti esperienza

Per i frammenti esperienza sono supportati solo i modelli modificabili.
Nello sviluppo di un nuovo modello per i frammenti esperienza, puoi seguire le procedure standard per un modello modificabile.
Per creare un modello di frammento esperienza rilevato dalla procedura guidata Crea frammento esperienza, è necessario seguire uno dei seguenti set di regole:
  1. Entrambe:
    1. Il tipo di risorsa del modello (il nodo iniziale) deve ereditare da:
      cq/experience-fragments/components/xfpage
    2. Il nome del modello deve iniziare con:
      experience-fragments Questo consente agli utenti di creare frammenti esperienza in /content/experience-fragments, poiché la cq:allowedTemplates proprietà di questa cartella include tutti i modelli con nomi che iniziano con experience-fragment . I clienti possono aggiornare questa proprietà per includere i propri schemi di denominazione o le posizioni dei modelli.
  2. I modelli consentiti possono essere configurati nella console Frammenti esperienza.

Componenti per frammenti esperienza

Lo sviluppo di componenti da utilizzare con/nei frammenti esperienza segue le procedure standard.
L'unica configurazione aggiuntiva consiste nell'assicurare che i componenti siano consentiti nel modello, come avviene con i criteri di contenuto.