Modelos de fragmento de contenido para crear todos los fragmentos de contenido nuevos.
Los modelos de fragmentos de contenido se utilizan en todos los ejemplos de WKND.
Antes de AEM 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. Pueden seguir utilizándose para crear fragmentos, pero se recomienda utilizar modelos de fragmento 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 incluyen 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 integradas o proporcionar plantillas específicas del cliente y para toda la aplicación que no se pretendan ampliar o 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
.
You must no cambie nada en la variable /libs
ruta.
Esto se debe a que el contenido de /libs
se sobrescribe la próxima vez que actualice la instancia (y puede sobrescribirse al aplicar una corrección o un paquete de funciones).
El método recomendado para la configuración y otros cambios es:
Volver a crear el elemento requerido (es decir, tal como existe en /libs
) en /apps
Realice cambios dentro de /apps
La estructura básica de una plantilla se mantiene en:
conf
global
settings
dam
cfm
templates
<template-name>
...
Con una 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
Nombre | Tipo | Value |
---|---|---|
<template-name> |
nt:unstructured |
Este nodo es la raíz de cada plantilla. Es obligatorio y debe tener un nombre único. |
jcr:title |
required |
El título de la plantilla (se muestra en la Crear fragmento ). |
jcr:description |
opcional |
Texto que describe el propósito de la plantilla (mostrado en la Crear fragmento ). |
initialAssociatedContent |
opcional |
Matriz con rutas a colecciones que deben asociarse a un fragmento de contenido recién creado de forma predeterminada. |
precreateElements |
required |
Nota: actualmente, este parámetro debe establecerse como |
version |
obligatorio |
Versión de la estructura de contenido; compatible actualmente: Nota: actualmente, este parámetro debe establecerse como |
Elementos
Nombre | Tipo | Valor |
---|---|---|
elements |
obligatorio |
Nodo que contiene la definición de los elementos del fragmento de contenido. Es obligatorio y debe contener al menos un nodo secundario para la variable Principal pero puede contener [1..n] nodos secundarios. Cuando se utiliza la plantilla, la subrama de elementos se copia en la subrama de modelo del fragmento. El primer elemento (como se ve en el CRXDE Lite) se considera automáticamente como el main elemento; 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
Nombre | Tipo | Valor |
---|---|---|
<element-name> |
nt:unstructured |
Este nodo define un elemento. Es obligatorio y debe tener un nombre único. |
jcr:title |
obligatorio |
Título del elemento (mostrado en el selector de elementos del editor de fragmentos). |
defaultContent |
opcional predeterminada: "" |
Contenido inicial del elemento; solo se usa si precreateElements = true |
initialContentType |
opcional predeterminada: |
Tipo de contenido inicial del elemento; solo se usa si
|
name |
obligatorio |
El nombre interno del elemento; debe ser único para el tipo de fragmento. |
Variaciones
Nombre | Tipo | Valor |
---|---|---|
variations |
opcional |
Este nodo opcional contiene la definición de las variaciones iniciales del fragmento de contenido. |
Nombre de la variación
Nombre | Tipo | Valor |
---|---|---|
<variation-name> |
obligatorio si hay un nodo de variación |
Define una variación inicial. La variación tendrá el mismo contenido inicial que el elemento respectivo (consulte |
jcr:title |
obligatorio |
El título de la variación (se muestra en la sección Variación (carril izquierdo). |
jcr:desciption |
opcional predeterminada: "" |
Texto que proporciona una descripción de la variación (se muestra en el Variación (carril izquierdo). |