Content Fragments Configuring Components for Rendering content-fragments-configuring-components-for-rendering
There are several advanced services related to the rendering of content fragments. To use these services, the resource types of such components must make themselves known to the content fragments framework.
This is done by configuring the OSGi Service - Content Fragment Component Configuration.
Definition of Advanced Services that need Configuration definition-of-advanced-services-that-need-configuration
The services that require the registration of a component are:
- Determining dependencies correctly during publication (that is, ensure that fragments & models can be automatically published with a page if they have changed since last publication).
- Support for content fragments in full text search.
- The management/handling of in-between content.
- The management/handling of mixed media assets.
- Dispatcher flush for referenced fragments (if a page containing a fragment is re-published).
- Using paragraph-based rendering.
If you need one or more of these features, then (typically) it is easier to use the out-of-the-box functionality, instead of developing it from scratch.
OSGi Service - Content Fragment Component Configuration osgi-service-content-fragment-component-configuration
The configuration needs to be bound to the OSGi service Content Fragment Component Configuration:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
For example:
The OSGi configuration is:
For some functionality (for example, to render only a paragraph range) you will have to adhere to some conventions:
Example example
As an example, see the following (on an out-of-the-box AEM instance):
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config
This contains:
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"