Personnaliser la création de pages

Dernière mise à jour : 2023-12-19
ATTENTION

Ce document explique comment personnaliser la création de pages dans l’IU tactile moderne et ne s’applique pas à l’IU classique.

Adobe Experience Manager (AEM) fournit divers mécanismes pour vous permettre de personnaliser la fonctionnalité de création de pages (et les consoles) de votre instance de création.

  • Clientlibs

    Les bibliothèques clientes (clientlibs) vous permettent d’étendre l’implémentation par défaut afin d’obtenir de nouvelles fonctionnalités, tout en réutilisant les fonctions, objets et méthodes standard. Lors de la personnalisation, vous pouvez créer votre propre bibliothèque cliente sous /apps. La nouvelle bibliothèque cliente doit :

    • dépendre de la bibliothèque cliente de création cq.authoring.editor.sites.page ;
    • faire partie de la catégorie cq.authoring.editor.sites.page.hook appropriée.
  • Recouvrements

    Les recouvrements sont basés sur les définitions de nœuds et vous permettent de recouvrir les fonctionnalités standard (dans /libs) avec vos propres fonctionnalités personnalisées (dans /apps). Lors de la création d’un recouvrement, il n’est pas nécessaire de disposer d’une copie 1:1 de l’original, car Sling Resource Merger autorise l’héritage.

REMARQUE

Pour plus d’informations, voir Jeu de documentation JS.

Il est possible de les utiliser de différentes manières pour étendre la fonctionnalité de création de pages dans votre instance AEM. Une sélection est abordée ci-dessous (à un niveau élevé).

REMARQUE

Pour plus d’informations, consultez les sections suivantes :

ATTENTION

​** Ne modifiez rien dans le chemin d’accès /libs.

Cela est dû au fait que le contenu de /libs sera écrasé lors de la prochaine mise à niveau de votre instance (et éventuellement lors de l’application d’un correctif ou d’un pack de fonctionnalités).

La méthode recommandée pour la configuration et d’autres modifications est la suivante :

  1. Recréez l’élément requis (tel qu’il existe dans /libs) sous /apps.
  2. Apportez les modifications désirées dans /apps.

Ajouter un nouveau calque (mode)

Lorsque vous modifiez une page, plusieurs modes sont disponibles. Ces modes sont implémentés à l’aide de calques. Ils permettent d’accéder à différents types de fonctionnalités pour le même contenu de page. Les calques standard sont les suivants : modification, prévisualisation, annotation, développeur et ciblage.

Exemple de calque : statut de Live Copy

Une instance AEM standard fournit la couche MSM. Cela permet d’accéder aux données relatives à la gestion multisite et de les mettre en évidence dans le calque.

Pour obtenir une démonstration, vous pouvez modifier toute page Copie de langue We.Retail (ou n’importe quelle autre page Live Copy) et sélectionner le mode Statut de Live Copy.

Vous trouverez la définition du calque MSM (pour référence) à l’emplacement suivant :

/libs/wcm/msm/content/touch-ui/authoring/editor/js/msm.Layer.js

Exemple de code

Ceci est un exemple de package montrant comment créer un calque (mode), qui est un nouveau calque pour la vue MSM.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

Ajouter une nouvelle catégorie de sélection à l’explorateur de ressources

L’explorateur de ressources affiche des ressources de différents types/catégories (par exemple, des images et des documents). Les ressources peuvent également être filtrées par ces catégories.

Exemple de code

aem-authoring-extension-assetfinder-flickr est un exemple de package qui montre comment ajouter un groupe à l’outil de recherche de ressources. Cet exemple se connecte au flux public de Flickr et l’affiche dans le panneau latéral.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

Filtrer les ressources

Lors de la création de pages, l’utilisateur ou l’utilisatrice doit souvent effectuer une sélection parmi des ressources (par exemple, des pages, des composants et des ressources). Cela peut prendre la forme d’une liste, par exemple, à partir de laquelle l’auteur ou l’autrice doit choisir un élément.

Pour maintenir la liste à une taille raisonnable et adaptée au cas d’utilisation, un filtre peut être mis en œuvre sous la forme d’un prédicat personnalisé. Par exemple, si le composant pathbrowser Granite est utilisé pour permettre à l’utilisateur de sélectionner le chemin d’accès à une ressource spécifique, les chemins d’accès présentés peuvent être filtrés comme suit :

Pour plus d’informations sur la création d’un prédicat personnalisé, consultez cet article.

REMARQUE

Mettre en œuvre un prédicat personnalisé en implémentant l’interface com.day.cq.commons.predicate.AbstractNodePredicate est également possible dans l’IU classique.

Consultez l’article de la base de connaissances pour voir un exemple d’implémentation de prédicat personnalisé dans l’interface utilisateur classique.

Ajouter une nouvelle action à une barre d’outils de composant

Chaque composant (en général) dispose d’une barre d’outils qui permet d’accéder à un éventail d’actions pouvant être réalisées sur le composant.

Exemple de code

aem-authoring-extension-toolbar-screenshot est un exemple de package qui montre comment créer une action de barre d’outils personnalisée pour effectuer le rendu de composants.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

Ajouter un nouvel éditeur statique

Éditeur statique standard

Dans une installation AEM standard :

  1. /libs/cq/gui/components/authoring/editors/clientlibs/core/js/editors/editorExample.js

    Contient les définitions des différents éditeurs disponibles.

  2. Il existe une connexion entre l’éditeur et chaque type de ressource (comme dans le composant) qui peut l’utiliser :

    • cq:inplaceEditing

      par exemple :

      • /libs/foundation/components/text/cq:editConfig

      • /libs/foundation/components/image/cq:editConfig

        • property : editorType

          Définit le type d’éditeur en ligne utilisé lorsqu’une édition statique est déclenchée pour ce composant ; par exemple, text, textimage, image, title.

  3. Les informations de configuration supplémentaires de l’éditeur peuvent être définies à l’aide d’un nœud config contenant des configurations, ainsi qu’un nœud plugin additionnel pour contenir les informations nécessaires à la configuration du plug-in.

    Voici un exemple de définition des proportions pour le plug-in de recadrage d’image du composant d’image. Dans la mesure où la taille d’écran peut être limitée, les proportions de recadrage ont été déplacées vers l’éditeur plein écran et ne sont visibles qu’à cet endroit.

    <cq:inplaceEditing
            jcr:primaryType="cq:InplaceEditingConfig"
            active="{Boolean}true"
            editorType="image">
            <config jcr:primaryType="nt:unstructured">
                <plugins jcr:primaryType="nt:unstructured">
                    <crop jcr:primaryType="nt:unstructured">
                        <aspectRatios jcr:primaryType="nt:unstructured">
                            <_x0031_6-10
                                jcr:primaryType="nt:unstructured"
                                name="16 : 10"
                                ratio="0.625"/>
                        </aspectRatios>
                    </crop>
                </plugins>
            </config>
    </cq:inplaceEditing>
    
    ATTENTION

    Dans AEM, les rapports de recadrage, tels qu’ils sont définis par la propriété ratio, sont définis sous la forme hauteur/largeur. Cela diffère de la définition conventionnelle de la largeur/hauteur. Cela a été créée pour des raisons de compatibilité héritée. Les utilisateurs chargés de la création ne percevront aucune différence, à condition que vous définissiez clairement la propriété name, car c’est cette dernière qui s’affiche dans l’interface utilisateur.

Création d’un éditeur statique

Pour mettre en œuvre un nouvel éditeur statique (au sein de votre bibliothèque cliente) :

REMARQUE

Pour obtenir un exemple, reportez-vous à :
/libs/cq/gui/components/authoring/editors/clientlibs/core/js/editors/editorExample.js

  1. Implémentez les éléments suivants :

    • setUp
    • tearDown
  2. Enregistrez l’éditeur (comprend le constructeur) :

    • editor.register
  3. Fournissez la connexion entre l’éditeur et chaque type de ressource (comme dans le composant) qui peut l’utiliser.

Exemple de code pour la création d’un éditeur statique

aem-authoring-extension-inplace-editor est un exemple de package qui montre comment créer un éditeur statique dans AEM.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

Configurer plusieurs éditeurs statiques

Il est possible de configurer un composant de sorte qu’il dispose de plusieurs éditeurs statiques. Après avoir configuré plusieurs éditeurs statiques, vous pouvez sélectionner le contenu approprié et ouvrir l’éditeur adéquat. Pour plus d’informations, consultez Configuration de plusieurs éditeurs statiques.

Ajouter une nouvelle action de page

Pour ajouter une nouvelle action de page à la barre d’outils de la page, par exemple, une Retour à Sites (console).

Exemple de code

aem-authoring-extension-header-backtosites est un exemple de package qui montre comment créer une action de barre d’en-tête personnalisée pour revenir à la console Sites.

CODE SUR GITHUB

Vous pouvez trouver le code de cette page sur GitHub.

Personnalisation du workflow Demander l’activation

Le workflow d’usine, Demande d’activation :

  • apparaît automatiquement dans le menu approprié lorsqu’un auteur de contenu n’a pas les droits de réplication appropriés, mais dispose de l’abonnement des utilisateurs et auteurs de la gestion des ressources numériques ;

  • sinon, rien ne s’affiche, car les droits de réplication ont été supprimés.

Pour bénéficier d’un comportement personnalisé lors d’une telle activation, vous pouvez incruster le workflow Demande d’activation :

  1. Dans /apps, recouvrez l’assistant Sites :

    /libs/wcm/core/content/common/managepublicationwizard

    REMARQUE

    Cela a pour effet de remplacer l’instance commune de :

    /libs/cq/gui/content/common/managepublicationwizard

  2. Mettez à jour le modèle de workflow et les configurations/scripts associés suivant les besoins.

  3. Retirez, à toutes les personnes appropriées, le droit dont elles bénéficient sur l’action replicate pour l’ensemble des pages pertinentes ; pour faire en sorte que ce workflow se déclenche comme une action par défaut lorsque l’une des personnes tente de publier (ou de répliquer) une page.

Sur cette page