Este artículo está basado en el artículo de Tuan Bui en The Joomla! Community Magazine (inglés). En este artículo se explica cómo realizar la conversión de una plantilla de Joomla 1.5 a Joomla 2.5. Para ello se utiliza cómo ejemplo la plantilla por defecto de Joomla, “rhuk_milkyway”. En este artículo se asume que ya tienes una instalación de Joomla 2.5 realizada.
Paso 1. Crea una copia de la plantilla Joomla 1.5
Para ello deberás de copiar de forma integra la carpeta de la plantilla original. Al pegarla en la carpeta de plantillas de Joomla 2.5 deberás de renombrar su carpeta de “rhuk_milkway” a “rhuk_milkway25″.
Paso 2. Editar estructura de ficheros
El siguiente paso es adaptar la estructura de la plantilla a una estructura válida para Joomla 2.5. Para ello se renombrarán algunos ficheros y se eliminarán los que actualmente son obsoletos.
- Elimina el fichero “params.ini”. En la versión 1.5 este fichero se encargaba de guardar la configuración de la plantilla. Ahora la configuración se guarda a través de la base de datos. Por tanto este fichero ya no es necesario. Si tu plantilla no lo tiene, es por que no lo usaba.
- Copiar el fichero error.php. El fichero error.php es el encargado de definir las plantillas para las vistas de error de Joomla. Este fichero lo deberás de copiar desde la plantilla por defecto de Joomla 2.5, “atomic”.
- Crear template_preview.png. Este fichero deberá de ser una imagen de 640×480 que lo habitual es que sea una captura de la plantilla funcionando. Joomla 2.5 la utilizará para mostrar la previsualización del tema.
Paso 3. Editar el fichero templateDetails.xml
Ahora será necesario modificar el templateDetails.xml para hacerlo compatible con Joomla 2.5. Para ello será necesario aplicar una serie de modificaiones.
- Renombrar el tag <install> a <extension>. Además en el atributo version será necesario indicar 2.5.
- Cambia el nombre de la plantilla dentro de la etiqueta <name>.
- Reemplazar los tags <filename> por un sólo <folder>. Esto se deberá de hacer para cada una de las carpetas que conforman el raíz de tu plantilla. Los ficheros del raíz deberán seguir estando presentes bajo la etiqueta <filename>. Es importante acordarse de quitar la línea correspondiente a params.ini.
- Añadir declaración para los nuevos ficheros. Bajo la etiqueta <filename> se deberá de incluir el error.php y el template_preview.png.
- Actualizar las etiquetas de los parámetros. Para ello se deberá de renombrar las etiquetas cómo se indica en la siguiente tabla. Si tu plantilla no tiene esta etiqueta es por que no la usa. no habrá que hacer nada en este paso.
| Original | Nuevo |
|---|---|
| params | <config><fields name=”params”><fieldset name=”advanced”> |
| param | fiedl |
Paso 4. Editar el index.php
Por último se deberá de adaptar el index.php a Joomla 2.5
- Añade la línea para cargar Mootools. Para eso se deberá de añadir la sentencia “JHtml::_(‘behavior.framework’, true);” al principio de todo, justo después del “define(‘_JEXEC’) or die;”.
- Reemplazar las menciones al nombre de la plantilla. En las cadenas donde se use el nombre de la plantilla, especialmente en el caso de las rutas se podrá reemplazar el nombre de la plantilla por $this->template. Así que en este caso las ocurrencias que pongan rhuk_milkway serán reemplazadas por <?php echo $this->template; ?>. Esta sentencia ya se encarga de recuperar el nombre de la plantilla.
Paso 5. Instalar y probar la plantilla
Para instalar la plantilla deberás de acceder al gestor de extensiones de Joomla y entrar en el “Discover”. El discover se encargará por ti de detectar la plantilla que copiaste manualmente a dicha instalación de Joomla y de instalarla de forma adecuada realizando los cambios pertinentes en la base de datos.
Una vez instalada tan sólo será necesario ir al gestor de plantillas y seleccionarla cómo plantilla por defecto.
Fuente: http://blog.zarovich.org/