Integración

Banners

Los banners son espacios donde se pueden cargar imágenes o porciones de código HTML desde el panel de control.
Cada posición de banners admite múltiples banners.
Las posiciones de banners pueden utilizarse en uno o más tipos de contenidos.

Al igual que los datos comunes que se describieron en la sección previa, los banners son tipos de contenidos que están disponibles en todos los tipos de contenido.
Sin embargo, a diferencia de los datos comunes, los datos de estes módulo varían de acuerdo al contenido que se esté representando, o a su tipo.

En el esquema XML del template deben definirse las posiciones de banners que podrá tener el sitio web.
Para ver un ejemplo de cómo definir posiciones de banners en el esquema XML haga click aquí.

Acceso a los datos XML de Banners

Todos los menús del sitio aparecen dentro del nodo /xml/banners del flujo de datos, y están disponibles en todos los tipos de contenido.
Los elementos que aparecen en los banners son:

Position: Nodo de base de cada menú, posee los siguientes elementos.
Id: Valor numérico, no se utiliza (para identificar la posición debe utilizarse el atributo name).
name: Nombre de la posición de banners, definido en el esquema XML. Este es el valor por el cual se debe acceder a la posición desde el código XSLT.
Banner: Por cada banner que se haya cargado en la posición, aparece un nodo "Banner" con los siguientes elementos
Id: Valor numérico, no se utiliza.
FileCode: En caso del que el banner cargado sea de tipo imágen, este valor corresponde al código de imágen.
En los banners de tipo HTML, este valor aparecerá vacío
Priority: Valor numérico, representa la prioridad del banner en caso de que se desee ordenarlos.
Name: Nombre del banner asignado al ser creado.
Url: Enlace de destino del banner.
Target: Tipo de enlace (_self, _blank).
Html: En caso de que el banner sea de tipo HTML, el código del mismo. Si es de tipo imagen, el nodo aparecerá vacío
Height: Discontinuado.
Width: Ancho de referencia de la posición de banners, no es el archo real del contenido subido.
Type: Tipo de Banner cargado.
id: Id del tipo de banner.
Description: Nombre del tipo de banner (Image / Html).

Integración de Banners

Ejemplo

En el esquema XML de template que se está utilizando como ejemplo en este manual, se definieron 4 posiciones de banners:

header (encabezado)
left (columna izquierda)
body (cuerpo central)
footer (pie de página)

Las posiciones header y footer serán utilizadas en todos los archivos XSLT de cada tipo de contenido, mientras que las posiciones left y body sólo se utilizarán en las categorías de producto y resultados de búsqueda (category.xsl y searchresult.xsl)

En este ejemplo se instanciará la posición header en el archivo home.xsl, utilizando una función definida en el archivo commons/modules.xsl.

---