La plantilla rhuk milkyway: el archivo templateDetails.xml

Accede a la carpeta rhuk milkyway de la carpeta templates de Joomla para localizar el archivo y ábrelo con un editor de textos. En Ubuntu utiliza la opción del botón derecho del ratón y selecciona Abrir con – editor de textos.

Detalles básicos

La prímera línea ya te indica que se trata de un archivo XML (<?xml version=”1.0” encoding=”utf-8”?>). Estos archivos utilizan una estructura muy sencilla consistente en anidar entre elementos / etiquetas diferentes fragmentos de información.

Este archivo contiene un elemento principal de tipo install (<install version=”1.5” type=”template”>) en el que se definen, como atributos, que se trata de una plantilla (type=”template”) y la versión de Joomla a la que está destinada (version=”1.5”).

Dentro de este elemento principal se anidan todos los demás; algunos simplemente para aportar datos sobre la plantilla, como su nombre (<name>rhuk_milkyway</name>), su versión (<version>1.0.2>/version>), su descripción (<description>TPL_RHUK_MILKYWAY</description>), el nombre de su autor (<author>Andy Miller</author>), ciertos datos para contactar con él como su email ( <authorEmail> Esta dirección electrónica esta protegida contra spam bots. Necesita activar JavaScript para visualizarla </authorEmail>) o la dirección URL de su web (http://www.rockettheme.coml>) , la fecha de creación de la plantilla (<creationDate>11/20/06</creationDate>) o su licencia (<license>GNU/GPL</license>). 

La estructura de archivos

En esta sección se referencian todos los archivos de los que hace uso la plantilla, incluido el propio templateDetails.xml, añadiendo sus rutas de acceso relativas. Fíjate en el código que las imágenes se ubican en la carpeta images que se localizará en la carpeta raíz de la plantilla y observa que su formato es png. Es fundamental, pues, que si editas estos archivos de imagen o realizas los tuyos propios para personalizar aún más la plantilla, se localicen en esta carpeta y que, además, su nombre siga siendo el mismo, el que se encuentra recogido en este código.

Por ejemplo, la línea de código <filename>images/mw_joomla_logo.png</filename> te indica que el archivo imagen que muestra el logo en el Frontend del sitio cuando utilizas esta plantilla como predeterminada se llama mw_joomla_logo, tiene formato png y se encuentra en la carpeta images de la carpeta raíz de la plantilla:

Posiciones

En esta sección se recogen los nombres de las posiciones predefinidas en la plantilla que luego podrán ser seleccionadas por el usuario para colocar ciertos elementos del sitio: módulos, menús de navegación, botones de navegación, etc. Estos nombres deben coincidir exactamente con los que se indicarán en el archivo index.php de la plantilla.

Nota

Por tanto, si deseas añadir posiciones en la plantilla además, de las establecidas de manera predeterminada en el diseño de la plantilla tendrás que editar ambos archivos, el archivo index.php de la carpeta raíz de la plantilla y este archivo, templateDetails.xml.

Observa que el nombre del marcador de posición no determina realmente cuál es su posición, es sólo un nombre identificativo: todos los aspectos estéticos (incluida también la posición que realmente ocupan en la plantilla) recaen sobre las hojas de estilo; es decir, una marcador de posición podría llamarse left pero, en cambio, mostrarse a la derecha si así lo determinase la hoja de estilo.

Observa que en esta plantilla están configuradas las posiciones breadcrumb, left, right, top, user1, user2, user3, user4, footer, debug y syndicate. Recuerda que puedes previsualizar estas posiciones desde la administración de Joomla seleccionando en la pantalla de configuración de la plantilla el enlace Previsualización).

 http://nombredelsitio/portal/?tp=1

o en el caso de que estés trabajando en un servidor local:

 http://localhost/portal/?tp=1

Parámetros

En esta sección es posible definir los parámetros de configuración de la plantilla, parámetros que serán configurables por el usuario a través del formulario de configuración de la plantilla, tal y como ya te hemos mencionado en el artículo La plantilla rhuk milkyway: los parámetros de configuración.

La configuración que establezcas en la administración de Joomla se almacenará automáticamente en el archivo params.ini dentro de la carpeta raíz de la plantilla.

El diseñador de la plantilla accede a sus valores desde el archivo index.php mediante el código $this->params->get (nombre del parámetro).

Como ves en la plantilla Rhuk milkyway el archivo index.php incluye varios de estos códigos

$this->params->get('colorVariation');

$this->params->get('backgroundVariation');

evidentemente uno por cada parámetro de configuración que se muestra en la administración de Joomla.

Además este archivo params.ini también tiene que estar referenciado en la sección <files> de este archivo templateDetails.xlml.

Por tanto, y en resumen, para que todo funcione adecuadamente son varios los archivos de la plantilla afectados y que lógicamente influyen en el funcionamiento. Y si deseas hacer modificaciones en este sentido tendrás que editar consecuentemente todos los archivos en cuestión.

Observa cómo se estructura esta sección para cada uno de los parámetros de configuración que puedes apreciar en la administración de la plantilla rhuk milkyway.

Para el parámetro de configuración Variante del color:

Joomla - Plantillas