Fragments de contenu – Configuration des composants pour le rendu content-fragments-configuring-components-for-rendering
Il existe plusieurs services avancés liés au rendu des fragments de contenu. Pour l’utilisation de ces services, les types de ressources de ces composants doivent être connus de la structure de fragments de contenu.
Pour ce faire, définissez la Configuration du composant de fragment de contenu du service OSGi.
Ces informations sont requises dans les cas suivants :
- Vous devez mettre en œuvre votre propre composant basé sur les fragments de contenu.
- Et doivent utiliser les services avancés.
Adobe recommande d’utiliser les composants principaux.
-
Si vous n’avez pas besoin des services avancés décrits ci-dessous, vous pouvez ignorer cette configuration.
-
Lorsque vous étendez ou utilisez les composants prêts à l’emploi, il n’est pas recommandé de modifier la configuration OSGi.
-
Vous pouvez créer de A à Z un composant n’utilisant que l’API de fragments de contenu, sans services avancés. Cependant, dans ce cas, vous devrez développer votre composant de sorte qu’il traite le traitement approprié.
Définition des services avancés nécessitant une configuration definition-of-advanced-services-that-need-configuration
Les services qui nécessitent l’enregistrement d’un composant sont les suivants :
- Déterminer correctement les dépendances au cours de la publication (c’est-à-dire s’assurer que les fragments et les modèles peuvent être publiés automatiquement avec une page s’ils ont été modifiés depuis la dernière publication).
- Prise en charge des fragments de contenu dans la recherche de texte intégral.
- Gestion/traitement du contenu intermédiaire.
- Gestion/traitement des ressources multimédias mixtes.
- Purge par le Dispatcher des fragments référencés (si une page contenant un fragment est republiée).
- Utilisation du rendu basé sur les paragraphes.
Si vous avez besoin d’une ou de plusieurs de ces fonctionnalités, il est alors (généralement) plus facile d’utiliser les services avancés prêts à l’emploi, au lieu de les développer de A à Z.
Service OSGi – Configuration du composant de fragment de contenu osgi-service-content-fragment-component-configuration
La configuration doit être liée au service OSGi Configuration du composant de fragment de contenu :
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Par exemple :
La configuration OSGi est la suivante :
dam.cfm.component.resourceTypeLe type de ressource à enregistrer ; par exemple,
.
core/wcm/components/contentfragment/v1/contentfragment
dam.cfm.component.fileReferencePropfragmentPath ou fileReferencedam.cfm.component.elementsPropelementNamedam.cfm.component.variationPropvariationNamePour certaines fonctionnalités, votre composant devra respecter des conventions prédéfinies. Le tableau suivant décrit les propriétés à définir, par votre composant, pour chaque paragraphe (c’est-à-dire jcr:paragraph pour chaque instance de composant) afin que les services puissent les détecter et les traiter correctement.
paragraphScopePropriété de chaîne qui définit le mode de sortie des paragraphes en mode de rendu d’élément unique.
Valeurs :
all: pour restituer tous les paragraphesrange: pour restituer la plage de paragraphes fournie parparagraphRange
paragraphRangePropriété de chaîne qui définit la plage de paragraphes à sortir en mode de rendu d’élément unique.
Format :
-
1ou1-3ou1-3;6;7-8ou*-3;5-*-Indicateur de plage;séparateur de liste*caractère générique
-
évalué uniquement si
paragraphScopeest défini surrange
paragraphHeadingsh1, h2, h3) sont comptés comme des paragraphes (true) ou non (false)Exemple example
À titre d’exemple, reportez-vous aux sections suivantes (sur une instance AEM prête à l’emploi) :
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config
Contient :
dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"