Plantillas de fragmentos de contenido content-fragment-templates

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Se aplica a:
Experience Manager 6.5

Temas:

Creado para:

Desarrollador

CAUTION

Se recomiendan modelos de fragmentos de contenido para crear todos los fragmentos de contenido nuevos.

Los modelos de fragmento de contenido se utilizan para todos los ejemplos en WKND.

NOTE

AEM Antes de la versión 6.3, los fragmentos de contenido se creaban en función de plantillas en lugar de modelos.

Las plantillas de fragmento de contenido ya no se utilizan. Todavía se pueden utilizar para crear fragmentos, pero se recomienda utilizar Modelos de fragmentos de contenido en su lugar. No se agregarán nuevas funciones a las plantillas de fragmento y se eliminarán en una versión futura.

Las plantillas se seleccionan al crear un fragmento de contenido. Proporcionan al nuevo fragmento la estructura básica, los elementos y la variación. Las plantillas utilizadas para los fragmentos de contenido están sujetas al Administrador de configuración de Granite.

Las plantillas listas para usar se encuentran en:

/libs/settings/dam/cfm/templates

Puede crear plantillas específicas del sitio para fragmentos de contenido en:

/apps/settings/dam/cfm/templates
La ubicación para superponer plantillas predeterminadas o proporcionar plantillas específicas del cliente para toda la aplicación que no se van a ampliar/cambiar durante la ejecución.
/conf/global/settings/dam/cfm/templates
La ubicación de las plantillas específicas del cliente para toda la instancia que deben cambiarse durante la ejecución.

El orden de prioridad es (en orden descendente) /conf, /apps, /libs.

CAUTION

Usted no debe cambiar nada en la ruta de acceso /libs.

Esto se debe a que el contenido de /libs se sobrescribirá la próxima vez que actualice la instancia (y es posible que se sobrescriba al aplicar una revisión o un paquete de características).

El método recomendado para la configuración y otros cambios es:

Vuelva a crear el elemento necesario (es decir, tal como existe en /libs) en /apps
Realizar cambios en /apps

La estructura básica de una plantilla se encuentra debajo de:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Con la estructura específica:

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

Más detalles sobre los nodos y sus propiedades son:

Plantilla

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 html-authored
Nombre	Tipo	Valor
`<template-name>`	`nt:unstructured`	Este nodo es la raíz de cada plantilla. Es obligatorio y debe tener un nombre único.
`jcr:title`	`String` obligatorio	El título de la plantilla (se muestra en el asistente Crear fragmento).
`jcr:description`	`String` opcional	Un texto que describe el propósito de la plantilla (mostrado en el asistente Crear fragmento).
`initialAssociatedContent`	`String[]` opcional	Matriz con rutas a colecciones que deben asociarse a un fragmento de contenido recién creado de forma predeterminada.
`precreateElements`	`Boolean` Requerido	`true`, si los subrecursos que representan los elementos (excepto el elemento principal) del fragmento de contenido deben crearse cuando se cree el fragmento de contenido; false si deben crearse "sobre la marcha". Nota: actualmente este parámetro debe establecerse en `true`.
`version`	`Long` Requerido	Versión de la estructura de contenido; compatible actualmente: Nota: actualmente este parámetro debe establecerse en `2`.

Elementos

table 0-row-3 1-row-3 html-authored

Nombre Tipo Valor

elements

nt:unstructured

Requerido

Nodo que contiene la definición de los elementos del fragmento de contenido. Es obligatorio y debe contener al menos un nodo secundario para el elemento Main, pero puede contener [1..n] nodos secundarios.

Cuando se utiliza la plantilla, la subrama de elementos se copia en la subrama del modelo del fragmento.

El primer elemento (tal como se ve en el CRXDE Lite) se considera automáticamente como el elemento main; el nombre del nodo es irrelevante y el nodo en sí no tiene una relevancia especial, aparte del hecho de que está representado por el recurso principal; los demás elementos se gestionan como subrecursos.

Nombre de elemento

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 html-authored
Nombre	Tipo	Valor
`<element-name>`	`nt:unstructured`	Este nodo define un elemento. Es obligatorio y debe tener un nombre único.
`jcr:title`	`String` Requerido	El título del elemento (mostrado en el selector de elementos del editor de fragmentos).
`defaultContent`	`String` opcional predeterminado: ""	Contenido inicial del elemento; sólo se usa si `precreateElements` = `true`
`initialContentType`	`String` opcional valor predeterminado: `text/html`	Tipo de contenido inicial del elemento; sólo se usa si `precreateElements` = `true`; actualmente se admite: `text/html` `text/plain` `text/x-markdown`
`name`	`String` Requerido	El nombre interno del elemento; debe ser único para el tipo de fragmento.

Variaciones

table 0-row-3 1-row-3 html-authored

Nombre Tipo Valor

variations

nt:unstructured

opcional

Este nodo opcional contiene la definición de las variaciones iniciales del fragmento de contenido.

Nombre de variación

table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored
Nombre	Tipo	Valor
`<variation-name>`	`nt:unstructured` obligatorio si hay un nodo de variación	Define una variación inicial. La variación se agrega de manera predeterminada a todos los elementos del fragmento de contenido. La variación tendrá el mismo contenido inicial que el elemento respectivo (consulte `defaultContent/ initialContentType` )
`jcr:title`	`String` Requerido	El título de la variación (mostrado en la pestaña Variación del editor del fragmento (carril izquierdo)).
`jcr:desciption`	`String` opcional predeterminado: ""	Un texto que proporciona una descripción de la variación (mostrada en la ficha Variación del editor del fragmento (carril izquierdo)).

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2