Show Menu
SUJETS×

Fragments d’expérience

Principes élémentaires

Un fragment d’expérience est un groupe d’un ou plusieurs composants comprenant un contenu et une disposition pouvant être référencés dans les pages.
Un maître et/ou une variante de fragment d’expérience utilise :
  • sling:resourceType : /libs/cq/experience-fragments/components/xfpage
Comme il n'y en a pas /libs/cq/experience-fragments/components/xfpage/xfpage.html il revient à
  • sling:resourceSuperType : wcm/foundation/components/page

Rendu HTML brut

Using the .plain. selector in the URL, you can access the plain HTML rendition.
Cela est possible à partir du navigateur. Cependant, le principal objectif consiste à autoriser d’autres applications (des applications web tierces et des implémentations mobiles personnalisées, par exemple) à accéder directement au contenu du fragment d’expérience en utilisant uniquement l’URL.
Le rendu HTML brut ajoute le protocole, l’hôte et le chemin d’accès au contexte à des chemins qui :
  • du type: src , href ou action
  • or end with: -src , or -href
Par exemple :
.../brooklyn-coat/master.plain.html
Les liens font toujours référence à l’instance de publication. Ils sont destinés à être utilisés par des tiers, de sorte qu’ils soient toujours appelés à partir de l’instance de publication, et non de l’auteur.
Le sélecteur de rendu brut utilise un transformateur plutôt que des scripts supplémentaires. le Sling Rewriter est utilisé comme transformateur. Ceci est configuré à l’adresse
  • /libs/experience-fragments/config/rewriter/experiencefragments

Variations sociales

Les variantes de Social peuvent être publiées sur les réseaux sociaux (texte et image). Dans AEM, ces variantes sociales peuvent contenir des composants ; par exemple, les composants de texte, les composants d’image.
L’image et le texte de la publication sociale peuvent être extraits de n’importe quel type de ressource d’image ou de ressource de texte à n’importe quel niveau de profondeur (dans le bloc de création ou le conteneur de mise en page).
Les variations sociales permettent également de créer des blocs de création et de les prendre en compte lors de l’exécution d’actions sociales (dans l’environnement de publication).
Pour publier le texte et l’image appropriés sur le réseau de médias sociaux, certaines conventions doivent être respectées si vous développez vos propres composants personnalisés.
Pour ce faire, vous devez utiliser les propriétés suivantes :
  • Pour extraire l’image
    • fileReference
    • fileName
  • Pour extraire le texte
    • text
Les éléments qui n'utilisent pas cette convention ne seront pas pris en considération.

Modèles de fragments d’expérience

Seuls les modèles Modèles de pages – Modifiables modifiables sont pris en charge pour les fragments d’expérience.
Lors du développement d’un nouveau modèle de fragments d’expérience, vous pouvez suivre les pratiques standard d’un modèle Modèles de pages – Modifiables modifiable.
Pour créer un modèle de fragment d’expérience détecté par l’assistant Créer un fragment d’expérience, vous devez suivre l’un des jeux de règles suivants :
  1. les deux:
    1. Le type de ressource du modèle (le noeud initial) doit hériter de :
      cq/experience-fragments/components/xfpage
    2. Et le nom du modèle doit commencer par :
      experience-fragments Cela permet aux utilisateurs de créer des fragments d’expérience dans /content/experience-fragments, car la cq:allowedTemplates propriété de ce dossier inclut tous les modèles dont le nom commence par experience-fragment . Les clients peuvent mettre à jour cette propriété pour inclure leur propre modèle de dénomination ou emplacement de modèle.
  2. Les modèles autorisés peuvent être configurés dans la console Fragments d’expérience.

Composants pour les fragments d’expérience

Le développement de composants à utiliser avec/dans les fragments d’expérience est conforme aux pratiques standard.
La seule configuration supplémentaire consiste à s’assurer que les composants sont autorisés sur le modèle, ce qui se fait avec la stratégie de contenu.