Fragmentos de conteúdo configuram componentes para renderização

Há vários serviços avançados relacionados à renderização de fragmentos de conteúdo. Para usar esses serviços, os tipos de recursos desses componentes devem se tornar conhecidos pela estrutura de fragmentos de conteúdo.

Isso é feito configurando o Serviço OSGi - Configuração do componente de fragmento de conteúdo.

CUIDADO

Se você não precisar dos serviços avançados descritos abaixo, poderá ignorar esta configuração.

CUIDADO

Ao estender ou usar os componentes predefinidos, não é recomendável alterar a configuração.

CUIDADO

Você pode gravar um componente do zero que usa somente a API Fragmentos de conteúdo, sem serviços avançados. No entanto, nesse caso, você terá que desenvolver seu componente para que ele lide com o processamento apropriado.

Portanto, é recomendável usar os componentes principais.

Definição dos Serviços Avançados que precisam de Configuração

Os serviços que exigem o registro de um componente são:

  • Determinar as dependências corretamente durante a publicação (isto é, garantir que os fragmentos e modelos possam ser publicados automaticamente com uma página se tiverem sido alterados desde a última publicação).
  • Suporte para fragmentos de conteúdo na pesquisa de texto completo.
  • O gerenciamento/tratamento de conteúdo intermediário.
  • O gerenciamento de ativos de mídia mista.
  • O Dispatcher libera fragmentos referenciados (se uma página que contém um fragmento for republicada).
  • Uso de renderização baseada em parágrafo.

Se você precisar de um ou mais desses recursos, então (normalmente) é mais fácil usar a funcionalidade predefinida, em vez de desenvolvê-la do zero.

Serviço OSGi - Configuração do componente de fragmento de conteúdo

A configuração precisa estar vinculada ao serviço OSGi Configuração do componente de fragmento de conteúdo:

com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl

OBSERVAÇÃO

Consulte Configurando o OSGi para obter mais detalhes.

Por exemplo:

cfm-01

A configuração do OSGi é:

Etiqueta Configuração do OSGi
 Descrição
Tipo de recurso dam.cfm.component.resourceType O tipo de recurso a ser registrado; por exemplo,

core/wcm/components/contentfragment/v1/contentfragment
Propriedade de referência dam.cfm.component.fileReferenceProp O nome da propriedade que contém a referência ao fragmento; por exemplo, fragmentPath ou fileReference
Propriedade do(s) elemento(s) dam.cfm.component.elementsProp O nome da propriedade que contém os nomes dos elementos a serem renderizados; por exemplo,elementName
Propriedade de variação
 dam.cfm.component.variationProp O nome da propriedade que contém o nome da variação a ser renderizada; por exemplo,variationName

Para algumas funcionalidades (por exemplo, para renderizar apenas um intervalo de parágrafos), você terá que aderir a algumas convenções:

Nome da Propriedade Descrição
paragraphRange

Uma propriedade de string que define o intervalo de parágrafos a serem enviados se estiver em modo de renderização de elemento único.

Formato:

  • 1 ou 1-3 ou 1-3;6;7-8 ou *-3;5-*
  • avaliado somente se paragraphScope estiver definido como range
paragraphScope

Uma propriedade de string que define como os parágrafos devem ser exibidos se em modo de renderização de elemento único.

Valores:

  • all : para renderizar todos os parágrafos
  • range : para renderizar o intervalo de parágrafos fornecido por paragraphRange
paragraphHeadings Uma propriedade booleana que define se os cabeçalhos (por exemplo, h1, h2, h3) são contados como parágrafos (true) ou não (false)
CUIDADO

Isso pode mudar em mais de 6,5 marcos.

Exemplo

Como exemplo, consulte o seguinte (em uma instância AEM predefinida):

/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config

Ele contém:

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"

Nesta página