CQ5.x : comment créer une bibliothèque-utilisateur de widget personnalisée

Question

Comment créer une bibliothèque-utilisateur de widget personnalisée fournissant une fonctionnalité WCM nouvelle ou modifiée ?

Réponse, résolution

Le CQ5 fournit une interface pour ajouter une nouvelle fonctionnalité JavaScript à l'interface de création WCM via la structure Ext.JS. Ces bibliothèques dites de client proposent les éléments suivants :

• ajouter une fonctionnalité personnalisée ou
• remplacez et étendez les fonctionnalités existantes

créez une bibliothèque-utilisateur personnalisée

Les étapes suivantes décrivent ce qui est nécessaire à la création d'une bibliothèque-utilisateur personnalisée.

• Aller à CRXDE Lite (par exemple : http://<host>:<port>/crxde)
• Créer un nœud de type cq:ClientLibraryFolder, par exemple
  • /apps/myapp/ui/mylib
• Définir la propriété de chaîne sling:resourceType en widgets/clientlib
• Définir des catégories de propriété (à plusieurs valeurs) pour une ou plusieurs des opérations suivantes

• Si nécessaire, définissez les dépendances de propriété string (plusieurs valeurs) à d'autres bibiliothèques-utilisateurs dans le système
• enregistrer toutes les modifications

Recouvrement / ajout de widgets

• Créer un dossier source sous le nœud bibliothèque-client, par exemple :
  • /apps/myapp/ui/mylib/source
• Créez un fichier pour chaque classe JS et un widget de remplacement, par exemple :
  • /apps/myapp/ui/mylib/source/MyWidget.js
  • /apps/myapp/ui/mylib/source/override/ComponentList.js
• Créer un fichier js.txt pour inclure les fichiers créés ci-dessus dans la bibliothèque client personnalisée :

#base=source MyWidget.js override/ComponentList.js 

• enregistrer toutes les modifications.

CQ5 surveille automatiquement les modifications apportées à une bibliothèque client dans le référentiel et réenregistre cette bibliothèque pour une utilisation ultérieure dans la catégorie correspondante, par exemple lors de la modification d'une page. Ci-joint un exemple de module de contenu CQ qui effectue les opérations suivantes :

• ajouter une bibliothèque client personnalisée /apps/myapp/ui/mylib
• catégorie cq.wcm.edit
• Remplace les valeurs par défaut de la liste de composants dans le sidekick.
  • nombre maximal par défaut de groupes de composants à afficher
  • nombre mininimal par défaut de composants requis pour un groupe

S’applique à

CQ5.x.