Joomla - GNU - Linux - Programación

En el capítulo anterior hemos armado una primera aproximación o lo que será la estructura y composición final de la plantilla que estamos adaptando, pero antes de continuar es preciso comprender de qué se trata una plantilla Joomla.

En primer lugar podemos decir que no solo hay plantillas  para el front-end sino que además también para el back-end o administración. Para esto último se utiliza casi siempre la llamada "Khepri" que se instala por defecto pero muchas veces, generalmente cuando es más de una persona la que "administra" el sitio necesitamos incluir algunas modificaciones para hacer más comprensible la gestión web. No es lo más común ni tampoco lo más fácil de realizar pero es posible. En este tutorial solo veremos las primeras, las que se ubican en la carpeta "joomla-raíz/templates/". Si se animan a crear o "retocar" alguna para el back-end, estas las pueden encontrar en "joomla-raíz/administrator/templates".

LOS ARCHIVOS
Una plantilla contiene por lo menos los siguientes archivos:
- index.php: Este archivo, que en una web no Joomla sería el index.html, se utiliza para representar en forma lógica y estructurada la vista de los contenidos. Dichos contenidos serán generados por las extensiones (módulos, componentes y plugins) que tengamos instalados. Dicho de otra forma, es de tipo "php" pero en realidad se convierte en un html  que se crea "al vuelo" tomando de la base de datos y de las distintas extensiones los contenidos. Es el primer archivo que se abrirá cuando pongamos en el navegador la dirección web de la página y reviste importancia extrema, por eso mismo es muy común que falle la web si alguna extensión tiene problemas de programación.

- templateDetails.xml: Representa la composición de la plantilla, su nombre, el de su autor,  correo y web del mismo, fecha de creación, versión, copyright y licencia, descripción, archivos que la componen, posiciones definidas y eventualmente parámetros y lenguajes. Este archivo es leído por el "Gestor de Plantillas" del back-end y por eso mismo se debe respetar cierta estructura de etiquetas. No puede contener ningún error de sintaxis ya que de ser así no solo no podremos instalarla sino que  además no podremos verla y administrarla desde el Gestor de Plantillas.

- template.css: Es la hoja de estilo que le da la maquetación a la web. Aquí se indican márgenes, colores de fondo, de fuentes, tamaño de los espacios o DIVS y demás cuestiones relacionadas. También se incluyen dentro los estilos propios del Joomla como veremos más adelante. Podemos encontrar más de un archivo CSS ya que muchas veces se dividen para hacer más fácil el trabajo de diseño. El nombre del archivo "template" no es obligatorio pero los autores de Joomla recomiendan que se respete, aunque he visto que es común que se utilice el nombre "template_css".

- component.php:  Este archivo se utiliza para proporcionar un estilo distinto de los artículos a imprimir o de el "Enviar enlace a un amigo". Lo que hace generalmente es utilizar otro archivo CSS para presentar en pantalla, de forma más "limpia", el artículo a imprimir. Es común encontrar plantillas que dentro de los CSS tienen un archivo llamado "template_rtl.css" utilizado para este fin. En este archivo php lo que hacemos es vincular este CSS "distinto" para hacer la impresión más leíble o imprimible.

- template_thumbnail.ext: Es una miniatura de la vista de la plantilla, generalmente de 200 x 150 pixeles. (ext puede ser jpg, png, gif)

- params.ini: Si definimos parámetros para la plantilla, este archivo es el que los contendrá. Se trata de un archivo de texto plano en donde línea por línea se colocan los nombres de las variables de los parámetros y su valor por defecto.

También es común que aquí encontremos el archivo favicon.ico que es el que aparece a la izquierda del navegador, en la barra de direcciones. Es un minilogo que identifica nuestra web.

LAS CARPETAS O DIRECTORIOS
Una plantilla típica puede incluir estos directorios o carpetas:
- css: aquí estarán almacenados todos los archivos de hojas de estilos propios de la plantilla. Un ejemplo típico es encontrar algunos como estos: template.css (para la plantilla en general), editor.css (para el editor que utilicemos), template_rtl.css (para la impresión), ie7.css (para usar en caso de que se esté navegando con Internet Explorer 7), etc.

- images: es la carpeta donde estarán todas las imágenes que utiliza la plantilla (banners, fondos, esquinas, etc.). También aquí se guardaran los iconos que se utilizarán por defecto en los artículos y en reemplazo de los existentes. Para esto último solo debemos respetar los nombres, por ejemplo si queremos reemplazar el ícono por defecto para "Imprimir" debemos utilizar el nombre "printButton" con la extensión: gif, png o jpg.

- html: dentro de esta carpeta se guardan: el módulo básico de Chrome (com_content) que se utiliza para modificar la apariencia de los artículos, categorías y secciones y los módulos modificados que se utilizaran en lugar de los que trae Joomla por defecto, por ejemplo para el login (mod_login), encuestas (mod_poll), más leídos (mod_mostread), etc.

Eventualmente podemos encontrar además una carpeta "js" en donde estarán los archivos Javascripts propios de la plantilla, también una carpeta "admin" con archivos de lenguaje para la administración del template, etc.