Plantillas de página: estáticas page-templates-static
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 properties-and-child-nodes-of-a-template
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 how-templates-are-structured
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 the-structure-of-a-template
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 the-content-produced-by-a-template
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 default-templates
AEM El paquete incluye 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 displaying-default-templates
Para ver una lista de todas las plantillas del repositorio, siga este procedimiento:
-
En CRXDE Lite, abra el Herramientas y haga clic en Consulta.
-
En la pestaña Consulta
-
Como Tipo, seleccione XPath.
-
En el Consulta campo de entrada, introduzca la siguiente cadena: //element(*, cq:Template)
-
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(https://experienceleague.adobe.com/.&?lang=es#42;)?
Aplicación de los diseños de plantilla how-template-designs-are-applied
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 design-path-resolution
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 decision-tree
Esta es una representación gráfica del Resolución de ruta de diseño lógica.
Ejemplos example
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 developing-page-templates
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) creating-a-new-template-based-on-an-existing-template
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:
-
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>.
note note NOTE 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. -
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.
note note NOTE 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(/.*)?
-
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>.
-
Actualice el jcr:título y jcr:description del nuevo componente.
-
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).
-
Actualice el sling:resourceType de la plantilla jcr:contenido para hacer referencia al nuevo componente.
-
Realice cambios adicionales en la funcionalidad o el diseño de la plantilla, en su componente subyacente o en ambos.
note note NOTE 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.
cq.shared
en las páginas de contenido y, si está ausente, el error de JavaScript Uncaught TypeError: Cannot read property 'shared' of undefined
resultados.cq.shared
, de modo que cualquier contenido basado en ellos incluye automáticamente cq.shared
. Sin embargo, si decide crear sus propias páginas de contenido desde cero sin basarlas en contenido de ejemplo, debe asegurarse de incluir la variable cq.shared
namespace.Disponibilidad de una plantilla existente making-an-existing-template-available
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.
-
En CRXDE Lite, vaya a la plantilla que desee utilizar para la página, por ejemplo, la plantilla Newsletter.
-
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
.