Plantillas de página: estáticas

Se utiliza una plantilla para crear una página y define qué componentes se pueden utilizar dentro del ámbito seleccionado. Una plantilla es una jerarquía de nodos que tiene la misma estructura que la página que se va a crear, pero sin contenido real.

Cada plantilla le presenta una selección de componentes disponibles para su uso.

• Las plantillas están compuestas por Componentes;
• Los componentes utilizan los widgets y permiten el acceso a ellos, y se utilizan para procesar el contenido.

Propiedades y nodos secundarios de una plantilla

Una plantilla es un nodo de tipo cq:Template y tiene las siguientes propiedades y nodos secundarios:

Una plantilla es la base de una página.

Para crear una página, se debe copiar la plantilla (árbol de nodos) /apps/<myapp>/template/<mytemplate>) a la posición correspondiente en el árbol del sitio: esto es lo que sucede si se crea una página con el Sitios web pestaña.

Esta acción de copia también proporciona a la página su contenido inicial (normalmente solo contenido de nivel superior) y la propiedad sling:resourceType, la ruta al componente de página que se utiliza para procesar la página (todo en el nodo secundario jcr:content).

Estructura de las plantillas

Hay dos aspectos que hay que tener en cuenta:

• la estructura de la propia plantilla
• la estructura del contenido producido cuando se utiliza una plantilla

La estructura de una plantilla

Se crea una plantilla en un nodo de tipo cq:Template.

Se pueden configurar varias propiedades, en particular:

• jcr:título - título de la plantilla; aparece en el cuadro de diálogo al crear una página.
• jcr:description - descripción de la plantilla; aparece en el cuadro de diálogo al crear una página.

Este nodo contiene un nodo jcr:content (cq:PageContent) que se utiliza como base para el nodo de contenido de las páginas resultantes; esto hace referencia, mediante sling:resourceType, al componente que se va a utilizar para procesar el contenido real de una nueva página.

Este componente se utiliza para definir la estructura y el diseño del contenido cuando se crea una nueva página.

El contenido producido por una plantilla

Las plantillas se utilizan para crear páginas de tipo cq:Page (como se mencionó anteriormente, una página es un tipo especial de componente). AEM Cada página de tiene un nodo estructurado jcr:content. Así pues:

• es de tipo cq:PageContent
• es un tipo de nodo estructurado que contiene una definición de contenido definida
• tiene una propiedad sling:resourceType para hacer referencia al componente que contiene los scripts de sling utilizados para procesar el contenido

Plantillas predeterminadas

AEM La variable viene con varias plantillas predeterminadas disponibles de forma predeterminada. A veces, es posible que desee utilizar las plantillas tal cual. En ese caso, debe asegurarse de que la plantilla esté disponible para el sitio web.

AEM Por ejemplo, la viene con varias plantillas, incluidas una página de contenido y una página de inicio.

Visualización de plantillas predeterminadas

Para ver una lista de todas las plantillas del repositorio, siga este procedimiento:

1. En CRXDE Lite, abra el Herramientas y haga clic en Consulta.

2. En la pestaña Consulta

3. Como Tipo, seleccione XPath.

4. En el Consulta campo de entrada, introduzca la siguiente cadena: //element(*, cq:Template)

5. Clic Ejecutar. La lista se muestra en el cuadro de resultados.

Normalmente, se toma una plantilla existente y se desarrolla una nueva para uso propio. Consulte Desarrollo de plantillas de página para obtener más información.

Para habilitar una plantilla existente para el sitio web y desea que se muestre en la Crear página diálogo al crear una página justo debajo de Sitios web desde el Sitios web , establezca la propiedad allowedPaths del nodo de la plantilla en: /content(/.&?lang=es#42;)?

Aplicación de los diseños de plantilla

Cuando los estilos se definen en la interfaz de usuario mediante Modo de diseño, el diseño se mantiene en la ruta exacta del nodo de contenido para el que se define el estilo.

Si los diseños solo se aplican mediante el modo de diseño, a continuación, las siguientes secciones, Resolución de ruta de diseño, Árbol de decisión, y el Ejemplo no son aplicables.

Resolución de ruta de diseño

AEM Al procesar contenido basado en una plantilla estática, intenta aplicar los estilos y el diseño más relevantes al contenido en función de un recorrido de la jerarquía de contenido.

AEM determina el estilo más relevante para un nodo de contenido en el siguiente orden:

• Si hay un diseño para la ruta completa y exacta del nodo de contenido (como cuando el diseño se define en el modo Diseño), utilice ese diseño.
• Si hay un diseño para el nodo de contenido del elemento principal, utilice ese diseño.
• Si hay un diseño para cualquier nodo en la ruta del nodo de contenido, utilice ese diseño.

En los dos últimos casos, si hay más de un diseño aplicable, utilice el más cercano al nodo de contenido.

Árbol de decisión

Esta es una representación gráfica del Resolución de ruta de diseño lógica.

Ejemplos

Considere una estructura de contenido simple como se muestra a continuación, donde un diseño podría aplicarse a cualquiera de los nodos:

/root/branch/leaf

AEM En la tabla siguiente se describe cómo elige el diseño el usuario.

Desarrollo de plantillas de página

AEM Las plantillas de página de son simplemente modelos utilizados para crear páginas. Pueden contener tan poco contenido inicial como sea necesario, y su función es crear las estructuras de nodos iniciales correctas, con las propiedades necesarias (principalmente sling:resourceType) configuradas para permitir la edición y el procesamiento.

Creación de una plantilla (basada en una plantilla existente)

Se puede crear una plantilla nueva completamente desde cero, pero a menudo se copia una plantilla existente y se actualiza para ahorrarle tiempo y esfuerzo. Por ejemplo, las plantillas dentro de Geometrixx se pueden utilizar para ayudarle a empezar.

Para crear una plantilla basada en una plantilla existente:

1. Copie una plantilla existente (preferiblemente con una definición lo más cercana posible a lo que desea lograr) en un nuevo nodo.

   Las plantillas se almacenan en /apps/<website-name>/templates/<template-name>.

   NOTA

   La lista de plantillas disponibles depende de la ubicación de la nueva página y de las restricciones de colocación especificadas en cada plantilla. Consulte Disponibilidad de plantillas.

2. Cambie el jcr:título del nuevo nodo de plantilla para reflejar su nueva función. También puede actualizar el jcr:description si procede. Asegúrese de cambiar la disponibilidad de la plantilla de la página según corresponda.

   NOTA

   Si desea que la plantilla se muestre en la variable Crear página diálogo al crear una página justo debajo de Sitios web desde el Sitios web consola, configure el allowedPaths del nodo de plantilla a: /content(/.*)?

   

3. Copie el componente en el que se basa la plantilla (esto se indica mediante la variable sling:resourceType propiedad del jcr:contenido dentro de la plantilla) para crear una instancia.

   Los componentes se almacenan en /apps/<website-name>/components/<component-name>.

4. Actualice el jcr:título y jcr:description del nuevo componente.

5. Reemplace thumbnail.png si desea que se muestre una nueva imagen en miniatura en la lista de selección de plantillas (tamaño 128 x 98 px).

6. Actualice el sling:resourceType de la plantilla jcr:contenido para hacer referencia al nuevo componente.

7. Realice cambios adicionales en la funcionalidad o el diseño de la plantilla, en su componente subyacente o en ambos.

   NOTA

   Cambios realizados en /apps/<website>/templates/<template-name> afectan a la instancia de plantilla (como en la lista de selección).

   Cambios realizados en /apps/<website>/components/<component-name> afectan a la página de contenido creada cuando se utiliza la plantilla.

   Ahora puede crear una página dentro del sitio web con la nueva plantilla.

Disponibilidad de una plantilla existente

Este ejemplo ilustra cómo permitir que se utilice una plantilla para determinadas rutas de contenido. Las plantillas disponibles para el autor de la página al crear páginas están determinadas por la lógica definida en Disponibilidad de plantillas.

1. En CRXDE Lite, vaya a la plantilla que desee utilizar para la página, por ejemplo, la plantilla Newsletter.

2. Cambie el allowedPaths y otras propiedades utilizadas para disponibilidad de plantillas. Por ejemplo, allowedPaths: /content/geometrixx-outdoors/[^/]+(/.*)? significa que esta plantilla está permitida en cualquier ruta de /content/geometrixx-outdoors.

   

Recursos de Business.Adobe.com

Content Insights Automated Onboarding Asset Collections Theme Editor Managed Cloud Content As A Service