La etiqueta Include inserta el código de la plantilla de presentación referenciada en el elemento de plantilla de presentación actual. Sólo se puede hacer referencia a la segunda platilla de presentación mediante una ruta (templatepath).
Como una Include del lado servidor, la etiqueta Include se usa muy a menudo para mostrar encabezados, pies de página y otros tipos de contenido reutilizable dentro de una página. Mediante el uso de la etiqueta Include, se garantiza que el contenido reutilizado aparezca uniformemente en las diversas páginas y se simplifican los cambios: sólo se modifica el archivo de plantilla incluida en lugar de cada página de plantilla que la utilice.
Las plantillas de presentación incluidas pueden considerarse como cortadas y pegadas en la plantilla de presentación actual. Al ejecutar la plantilla, se puede acceder al elemento que se está publicando desde una plantilla incluida como si se tratara de la plantilla principal para ese elemento.
Una forma de utilizar encabezados y pies de página consiste en poner toda la información de formato y diseño en el encabezado y el pie de página. Y la plantilla principal se ocupa de rellenar una celda de una tabla. Por ejemplo, si extrajo las secciones comentadas y las colocó en tres plantillas de presentación, podría usar varios tipos diferentes de elementos para la plantilla de elemento principal, como en el ejemplo siguiente:
<!-- Start Included Header template: -->
<html>
<head><title><pcs:value expr="item.title ∨ item.name"></pc:value></title></head>
<body>
<table border="1" height="100%">
<tr>
<td
colspan="2">Rellenar con contenido de pancarta superior</td>
</tr>
<tr>
<td
width="10%">Rellenar con navegación izquierda</td>
<td
width="90%" align="left" valign="top">
<!-- End Header Template -->
<!-- Start Main Item Template -->
<pcs:include templatepath="ArticleHeader"><h1>Falta
encabezado de artículo</h1></pcs:include>
<h1><pcs:value expr="headline">HEADLINE</pcs:value></h1>
<p><pcs:value expr="body">BODY</pcs:value>
<pcs:include templatepath="ArticleFooter"><h1>Falta
pie de página de artículo</h1></pcs:include>
<!-- End Main Item Template -->
<!-- Start Included Footer Template
-->
</td>
</tr>
<tr><td colspan="2">El
pie de página va aquí</td></tr>
</table>
</body>
</html>
<!-- End Included Footer Template -->
Si desea que se muestre un mensaje cuando no se encuentre la plantilla, escríbalo en el cuadroTexto si INCLUDE falla. Este texto aparece entre etiquetas <pcs> de apertura y de cierre en el cuadro Etiqueta PCS.
|
Atributo |
Descripción |
| Sintaxis | <pcs:include templatepath="path">texto predeterminado</pcs:include> |
|
Ejemplo: |
<pcs:include templatepath="/includes/footer">Copyright 2004</pcs:include> |
Si no se puede acceder a la plantilla especificada, la inclusión falla y en su lugar se evalúa el contenido del elemento. En este ejemplo, se mostraría "Copyright 2004".