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 gabarit et/ou une variation du fragment d’expérience utilise :
  • sling:resourceType  : /libs/cq/experience-fragments/components/xfpage
En l’absence de /libs/cq/experience-fragments/components/xfpage/xfpage.html , il revient à
  • sling:resourceSuperType  : wcm/foundation/components/page

Rendu HTML brut

Le sélecteur .plain. de l’URL permet d’accéder au rendu HTML brut.
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 :
  • sont du type src , href ou action  ;
  • se terminent par -src ou -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 module Sling Rewriter est utilisé comme transformateur. Cette configuration se trouve dans l’emplacement suivant :
  • /libs/experience-fragments/config/rewriter/experiencefragments

Variations sociales

Les variations sociales peuvent être publiées sur les réseaux sociaux (texte et image). Dans AEM, ces variations sociales peuvent contenir des composants ; des composants texte ou image, par exemple.
L’image et le texte de la publication sur le réseau social 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 fonctionnel ou dans le conteneur de mises en page).
Les variations sociales autorisent également les blocs fonctionnels et les prennent en compte lors de l’exécution d’actions sur les réseaux sociaux (dans l’environnement de publication).
Pour publier le contenu texte et image approprié sur le réseau social, il convient de respecter certaines conventions 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 composants qui ne respectent pas cette convention ne sont pas pris en compte.

Modèles de fragments d’expérience

Seuls les modèles modifiables sont pris en charge pour les fragments d’expérience.
Lors du développement d’un nouveau modèle pour les fragments d’expérience, vous pouvez suivre les pratiques standard en vigueur pour un modèle 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 ensembles de règles suivants :
  1. Les deux :
    1. Le type de ressource du modèle (le nœud 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, étant donné que la propriété cq:allowedTemplates de ce dossier inclut tous les modèles dont le nom commence par experience-fragment . Les clients peuvent mettre à jour cette propriété afin d’inclure leur propre schéma d’affectation de noms ou emplacement de modèle.
  2. Les modèles autorisés peuvent être configurés dans la console des fragments d’expérience.

Composants des 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. Pour ce faire, la stratégie de contenu est utilisée.