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

• 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