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.
This information is required when:
- You need to implement your own Content Fragment-based component,
- And need to use the advanced services.
Adobe recommends using the Core Components.
-
If you do not need the advanced services described below, you can ignore this configuration.
-
When you are extending or using the out-of-the-box component(s), it is not recommended to change the OSGi configuration.
-
You can write a component from scratch that uses the Content Fragments API only, with no advanced services. However, in such a case, you will have to develop your component so that it handles the appropriate processing.
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 Advanced Services, instead of developing them from scratch.
OSGi Service - Content Fragment Component Configuration osgi-service-content-fragment-component-configuration
The configuration must be bound to the OSGi service Content Fragment Component Configuration:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
For example:
The OSGi configuration is:
dam.cfm.component.resourceType
The resource type to register; for example,
core/wcm/components/contentfragment/v1/contentfragment
dam.cfm.component.fileReferenceProp
fragmentPath
or fileReference
dam.cfm.component.elementsProp
elementName
dam.cfm.component.variationProp
variationName
For some functionality your component will have to adhere to predefined conventions. The following table details the properties that need to be defined, by your component, for each paragraph (that is, jcr:paragraph
for each component instance) so that the services can detect and process them correctly.
paragraphScope
A string property that defines how paragraphs are to be output if in single element render mode.
Values:
all
: to render all paragraphsrange
: to render the range of paragraphs provided byparagraphRange
paragraphRange
A string property that defines the range of paragraphs to be output if in single element render mode.
Format:
-
1
or1-3
or1-3;6;7-8
or*-3;5-*
-
range indicator;
list separator*
wildcard
-
only evaluated if
paragraphScope
is set torange
paragraphHeadings
h1
, h2
, h3
) are counted as paragraphs (true
) or not (false
)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"