Integración
Crear los archivos XSLT
Los templates Masify poseen un archivo XSLT por cada tipo de contenido que representarán.
Estos archivos poseen nombres predefinidos que no deben ser modificados.
De acuerdo a las funcionalidades que quieran implementarse en el template, no necesariamente deberán utilizarse todos.
El único archivo XSLT requerido en todos los casos es el de la página de inicio (home), llamado home.xsl
Adicionalmente, pueden utilizarse otros archivos XSLT complementarios, por ejemplo, para organizar o reutilizar fragmentos de código.
Todos los archivos XSLT del template deberán estar ubicados dentro de la carpeta xsl del directorio correspondiente al template.
Dentro de esa carpeta podrán crearse carpetas complementarias para organizar archivos adicionales.
Para descargar un template completo de ejemplo y utilizarlo como referencia, haga click en el siguiente enlace:
Archivos XSLT de acuerdo al tipo de contenido que representan
home.xsl: Página de inicio (home).
Contenidos de catalogo de productos
category.xsl: Listado de productos.
searchresult.xsl: Resultado de búsqueda de productos.
tagitem.xsl: Listado de productos por tag.
item.xsl: Detalle de un producto.
Contenidos CMS
listarticles.xsl: Listado de artículos / notas / posteos.
tag.xsl: Listado de artículos / notas / posteos por tag.
article.xsl: Detalle de un artículo / nota / posteo.
Otros contenidos
page.xsl: Páginas informativas / institucionales / formularios.
listbranches.xsl: Listado de locales / sucursales.
Carrito de compras
cartindex.xsl: Listado (modificable) de productos en la compra.
checkout.xsl: Listado de productos en la compra + opciones de pago y envío + opciones de descuentos / promociones / cupones.
Requiere previa identificación de usuario (login)
checkoutorder.xsl: Listado final de productos en la compra con los costos adicionales de pago, envío, y aplicación de descuentos y promociones.
cartpaymentresult.xsl: Pantalla final de compra con el resultado de la misma.
Usuarios
user.xsl: Datos del usuario (algunos de ellos son editables).Requiere previa identificación de usuario (login)
listofordersforuser.xsl: Listado de compras del usuario.
Requiere previa identificación de usuario (login)
stocklist.xsl: Listado de productos agregados a listas personalizables (wishlists, favoritos).
Requiere previa identificación de usuario (login)
Facebook App
facebooksearch.xsl: Listado de productos. Se muestra al inicio de la aplicación y cuando se realiza una búqueda.
facebookcategory.xsl: Listado de productos por categoría.
facebookitem.xsl: Detalle de un producto
Código XSLT básico
Todos los archivos XSLT de cualquier tipo de contenido, deben estár basados en un código común a todos ellos.
Al incorporar este código en cada uno, podrán utilizarse en el sitio web, aunque no produzcan todavía ningún resultado visible.
Estructura básica XSLT
Los archivos XSLT comienzan con los siguientes nodos de declaración del tipo de contenido.
En ellos se define el tipo y codificación de contenido, la versión XSLT sobre la que se trabaja (siempre 1.0), y el tipo de salida que se producirá (html).Estos nodos no deben ser modificados ni alterados salvo casos específicos de implementación de funcionalidades adicionales del lado del servidor.
El nodo template
Todo el contenido del template que deba estar presente en la salida html, deberá ser instanciado dentro de un nodo <xsl:template>.Este nodo posee el atributo match='/' que significa que tendrá acceso a todos los datos XML que el server provee para este tipo de contenidos, desde el nodo raíz (/) de los mismos.
Subir los archivos XSLT al Cloud Masify
La subida de archivos al Cloud Masify se realiza vía FTP, al directorio correspondiente al template creado.
El directorio poseerá el mismo nombre que se asigne al template (ver: Crear esquema XML del template).
Los datos de acceso FTP son provistos en el momento de crear su cuenta de integrador, y son los mismos para cada uno de los templates que desarrolle.
Sólo cambia la carpeta de ubicación de los archivos.
Acceso a los datos correspondientes a cada Tipo de Contenido
Cada uno de los archivos XSLT listados al comienzo de esta página posee acceso a los datos correspondientes al contenido que representan.
También poseen acceso a los datos comunes a todo el sitio web (menús, diccionarios, opciones de diseño, etc.)
Estos datos son provistos por el sistema en formato XML y están implícitos al ser procesado el archivo XSLT en el servidor.
Es decir no deben ser invocados de forma explícita.
El hecho de
crear el archivo XSLT correspondiente a un tipo de datos ya genera el acceso a los mismos en el momento de ser procesados.
