Leandono's Blog

Tercera y última parte sobre como crear un template funcional para Joomla!

• Ver Primera parte
  
• Ver Segunda parte

Como bien dije antes , solo queda por explicar la creación del archivo 'templateDetails.xml'. Además había quedado en poner un par de puntos que no pude mostrar anteriormente.

El archivo templateDetails.xml

Dicho es una parte esencial para la instalación y reconocimiento de la plantilla en la administración de Joomla!. Además con él podemos brindar información sobre el autor, datos de contacto, licencia, etc. Básicamente tendremos las siguientes etiquetas y sus correspondientes datos:

Más alla de los datos de autor y nombres, es muy importante que especifiquemos correctamente todos los archivos de la plantilla, con su correspondiente carpeta contenedora y formato de archivo. En caso de no especificar alguno, sencillamente ese archivo no será reconocido ni instalado...

En nuestro caso, con la plantilla de ejemplo que estamos creando tendremos:

Guardamos el archivo y lo situamos en la carpeta raiz de la plantilla.

Queda crear la imagen 'template_thumbnail.png' que actuará de preview en la administración. Lo ideal es que sea una captura de la plantilla, con un tamaño aproximado de 200x150 px.

Una vez hecho, seleccionamos todos los archivos (index.php, templateDetails.xml, template_thumbnail.png)  y carpetas (css e images) y los comprimimos en zip. Y eso es todo, ya hemos terminado una plantilla para Joomla!. Me quedan aclarar unos puntos más.

Notas aparte sobre index.php

• .En la primera parte del tutorial, al crear el index, dentro de la cabecera teníamos:

Lo cual no está mal, pero añadiendo un par de cosas podemos mejorarlo: 

En primer lugar se incorporó la directiva PHP '<?php echo _ISO; ?>' para mostrar una codificación correcta en la plantilla. En segundo lugar además de mostrar el titulo, metatags y favicon con 'mosShowHead()', se agregó una función condicional, para que, si configuramos al sitio 'fuera de línea', aun asi podamos seguir viéndolo nosotros, no así las demás personas (veran el mensaje que hayamos especificado en la configuración). Finalmente se incorporó la directiva '<?php echo $mainframe->getTemplate(); ?>' en la ruta de obtención del estilo en cascada. Esta es la manera genérica para cargar un CSS en Joomla!, así no será necesario poner el nombre de la plantilla para cada index.php que hagamos.

• Mostrar un diseño si tal modulo está publicado. Para eso:

Se creó una función condicional, en palabras, si el modulo user1 está publicado - mosCountModules('user1') - mostramos todo que hay entre las llaves contenedoras (el div "caja" y el contenido del modulo). En caso de no estar publicado dicho modulo, no se mostrará nada (ni el div "caja" ni el modulo)

Notas aparte sobre el CSS

En la segunda parte del tutorial ponía énfasis en las reglas que vamos a incorporar al body del documento. El problema radica que el editor WYSIWYG de Joomla! toma estas reglas para mostrar el contenido a medida que lo vamos agregando. Si no podemos cumplir con esto, una solución es crear un estilo en cascada aparte y  especificar en las opciones del editor WYSIWYG que cargue a este cuando estamos creando contenido. El archivo en cuestión se llamará 'editor_content.css', lo guardamos junto a 'template_css.css' dentro del directorio 'CSS' y tendrá estas reglas:

Lo siguiente será ir a las opciones del editor (Administrador de Mambots --> Editor WYSIWYG TinyMCE) y en la opción Template CSS classes ponemos No. Guardamos y listo, cada vez que estemos trabajando con el editor, el contenido se mostrará según editor_content.css.

Ahora si, eso es todo, sientanse libres de hacer con la plantilla lo que quieran.

Descargar Green Joomla!