Manual de Templates para Joomla! 1.5.x - templateDetails.xml

Continuando con el manual para templates de Joomla! 1.5.x, la lección de hoy es:

templateDetails.xml

Como indicamos en el post anterior, este archivo incluye la lista de todos los elementos que conforman la plantilla de Joomla! 1.5.x y es muy importante tenerlo bien configurado a la hora de la instalación del mismo, es decir, estar seguro que estamos listando todos los archivos y que todos los archivos listados existan realmente. Este archivo también incluye cierta información de la plantilla, nombre, versión y descripción, como del autor y sobre el copyright.

El código XML del mismo tiene la siguiente estructura:

<?xml version="1.0" encoding="utf-8"?>

<install version="1.5" type="template">

<name>nuestro_template</name>

<creationDate>Septiembre 2008</creationDate>

<author>Madi Malso</author>

<copyright>GPL</copyright>

<authorEmail>micorreo@dominio.com</authorEmail>

<authorUrl>www.muertoperorankeado.com</authorUrl>

<version>1.0</version>

<description>Ejemplo de plantilla para Joomla! 1.5.x</description>

<files>

<!-- Lista de todos los archivos que conforman la plantilla -->

<filename>index.php</filename>

<filename>templateDetails.xml</filename>

<filename>template_thumbnail.png</filename>

<filename>favicon.ico</filename>

<filename>component.php</filename>

<filename>param.ini</filename>

<filename>css/template.css</filename>

<filename>html/pagination.php</filename>

<filename>html/modules.php</filename>

<filename>html/com_nombre/nombre_vistas/diagramado.php</filename>

<filename>html/mod_nombre/diagramado.php</filename>

<filename>images/imagen_demo.jpg</filename>

<filename>jascript/java_demo.js</filename>

</files>

<positions>

<!-- Lista de las posiciones con las que contara nuestra plantilla, estas se encontraran definidas en el archivo index.php -->

<position>user1</position>

<position>top</position>

<position>left</position>

<position>banner</position>

<position>right</position>

<position>footer</position>

</positions>

<params>

<!-- Lista de parámetros con los que contara nuestra plantilla, estos se encontraran definidos en el archivo param.ini -->

<param name="coloresFondo" type="list" default="blanco" label="Color de Fondo" description="Colores de fondo para usar">

<option value="azul">Azul</option>

<option value="rojo">Rojo</option>

</param>

</params>

</install>

Como pueden ver la estructura es bastante sencilla y simple de armar aunque en un plantilla puede ser algo engorrosa lo mejor es mantener todos los archivos en orden he ir agregándolos a medida que los creemos. Bueno pasemos a describir algunas de estas líneas:

<install version="1.5" type="template">: Sirve para indicar al instalador que es una plantilla de Joomla! 1.5

<name>nuestro_template</name>: Nombre de la plantilla, como indicamos antes este debe ser el mismo nombre que colocamos en la carpeta que contiene la plantilla.

<creationDate>Septiembre 2008</creationDate>: Fecha de creación, no hay una estandarización al respecto así que puede colocarse de distintas maneras siempre y cuando indique la fecha en la que la plantilla fue creada.

<author>Madi Malso</author>: Sirve para indicar la autoría de la plantilla

<copyright>GPL</copyright>: Indica el tipo de licencia con la que deseamos distribuir la plantilla para su uso.

<authorEmail>micorreo@dominio.com</authorEmail>: Indica la dirección de correo electrónico del autor en caso de querer ser contactado. Esta dirección se encuentra protegida para evitar el envio de spam a través de robots

<authorUrl>www.muertoperorankeado.com</authorUrl>: Dirección del sitio web del autor.

<version>1.0</version>: Versión de la plantilla

<files>..<files>: Lista de todos los archivos que conforman la plantilla; cada elemento debe de encontrarse dentro de sus propias etiquetas bajo el siguiente esquema: <filename>carpeta/archivo.ext</filename> en caso de que estos archivos se encuentren en carpetas dentro de la plantilla estas se deben de listar de manera relativa a la posición en la que se encuentra el template, por ejemplo si quisiéramos incluir nuestro archivo template.css que se encuentra dentro de la carpeta css/ se debería colocar de la siguiente manera: <filename>css/template.css</filename>

<positions>..</positions>: Lista de las posiciones que luego serán definidas en el archivo index.php donde se integraran los módulos de Joomla! 1.5.x, similar a los archivos estos se definirán dentro de las etiquetas <position>Posición</position>

<params>..</params>: Lista de los parámetros con los que trabajará nuestra plantilla este se encuentra definido de la siguiente manera: <param name=”NombreDelParametro” type=”tipo” label=”Etiqueta para el parametro” description=”Descripción del parametro” default=”valor inicial del parametro”>; según el tipo que hayamos tiene sus propias variaciones.