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.