CQ5.x: Come creare una libreria-client personalizzata per widget

Domanda

Come è possibile creare una libreria-client personalizzata per widget che fornisce funzionalità WCM nuove o modificate?

Risposta, Soluzione

CQ5 fornisce un'interfaccia per aggiungere nuove funzionalità JavaScript all'interfaccia di authoring WCM attraverso il framework Ext.JS. Queste cosiddette librerie-client forniscono quanto segue:

  • aggiungi funzionalità personalizzate o
  • sovrascrivi ed estendi le caratteristiche esistenti

Crea una libreria-client personalizzata

I passi successivi delineano ciò che è necessario per costruire una libreria-cliente personalizzata.

  • Vai a CRXDE Lite (es. http://<host>:<port>/crxde)
  • Crea un nodo con il tipo cq:ClientLibraryFolder, ad es.
    • /apps/myapp/ui/mylib
  • imposta la proprietà String sling:resourceType per widgets/clientlib
  • imposta categorie di proprietà (multi-valore) in una o più delle seguenti

Nome della categoria Descrizione
cq.wcm.admin SiteAdmin e strumenti
cq.wcm.edit ContentFinder e pagina di modifica
cq.dam.admin Amministratore DAM
cq.dam.edit DAM AssetShare, AssetEditor

  • se necessario, imposta le dipendenze delle proprietà (multi-valore) String ad altre librerie-client nel sistema
  • salva tutte le modifiche

Sovrapposizione / Aggiunta di widget

  • Crea una cartella sorgente sotto il nodo client-lib, ad es.
    • /apps/myapp/ui/mylib/source
  • Crea un file per ogni classe JS e sovrascrittura di widget, ad esempio
    • /apps/myapp/ui/mylib/source/MyWidget.js
    • /apps/myapp/ui/mylib/source/override/ComponentList.js
  • Crea un file js.txt per includere i file creati in precedenza nel client-lib personalizzato:
#base=source MyWidget.js override/ComponentList.js 

  • salva tutte le modifiche

CQ5 osserva automaticamente le modifiche a una libreria-client nell'archivio e registrerà nuovamente questa libreria per un successivo utilizzo nella categoria corrispondente, ad esempio quando si modifica una pagina. In allegato è presente un esempio di pacchetto di contenuto CQ che esegue i seguenti:

  • aggiungi una libreria-client personalizzata /apps/myapp/ui/mylib
  • categoria cq.wcm.edit
  • sovrascrivi i valori predefiniti della lista dei componenti nel SideKick
    • numero massimo predefinito di gruppi di componenti da visualizzare
    • numero minimo predefinito di componenti necessari per un gruppo

Si applica a

CQ5.X

Scarica

Logo Adobe

Accedi al tuo account