Convertire template HTML per Joomla

Lorenzo Bruschetti

Convertire un template in HTML in modo da poterlo utilizzare in Joomla non è difficile come si potrebbe pensare. In effetti bastano 5 brevi passaggi, che tra l'altro non richiedono particolari nozioni tecniche. Vediamoli in ordine.

Passaggio 1

Per prima cosa è necessario preparare il template HTML in modo che possa venire riconosciuto come tale da Joomla. Il template dovrà essere conforme alle specifiche (X)HTML e CSS.

Create una cartella nella directory "Templates" di Joomla sul vostro web server e uploadate il template che volete modificare, assicurandovi che tutti i file associati siano contenuti nella cartella che avete creato.

Rinominate il vostro file index.html come index.php. In questo modo Joomla potrà identificare il vostro template

Passaggio 2

Rimpiazzate il codice prima del body tag del vostro file index.php con questo codice:

<?php

// no direct access

defined( '_JEXEC' ) or die( 'Restricted access' );

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<head>

<jdoc:include type="head" />

</head>

Una volta fatto questo, concentratevi su questa riga:

type="text/css" />

Inserite i nomi esatti e la directory del vostro template e del vostro file CSS. Nel caso il template preveda più file CSS dovrete aggiungerli uno per uno seguendo la stessa struttura e lo stesso varrà per eventuali file javascript.

Passaggio 3

Possiamo ora passare alle definizione delle posizioni dei moduli. Quelle standard sono identificate da nomi come breadcrumb, left, right, top, user1, user2, footer, debug, etc.. Sul sito ufficiale di Joomla potrete consultare la mappa completa delle posizioni disponibili e dei relativi nomi.

Per creare un modulo bisognerà inserire il codice <jdoc:include type=”modules” name=”nome_posizione_modulo” /> nella posizione appropriata. Dovremo quindi creare una posizione con questo codice, dove l'attributo "name" indica la posizione:

<jdoc:include type="modules" name="top" />

</div>

Dopo questo bisognerà posizionare un componente, con questo codice:

<jdoc:include type="component" />

Per includere un messaggio, aggiungete questo codice:

<jdoc:include type="message" />

Passaggio 4

A questo punto siamo quasi pronti per l'installazione, ma manca ancora un passaggio fondamentale: il manifest file. In pratica in questo file .xhtml dovranno essere elencati tutti i file utilizzati dal template. Se il manifest file è incompleto l'installazione fallirà. Ecco un esempio di manifest file:

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://dev.joomla.org/xml/1.5/template-install.dtd">

<name>nome_del_template</name>

<author>Hosting-Linux.biz</author>

<authorEmail> This e-mail address is being protected from spambots. You need JavaScript enabled to view it </authorEmail>

<authorUrl>http://hosting-linux.biz</authorUrl>

<description>template description goes here</description>

<files>

<filename>index.php</filename>

<filename>templateDetails.xml</filename>

<filename>template_thumbnail.png</filename>

<filename>images/arrow.png</filename>

<filename>images/logo.png</filename>

<filename>css/template.css</filename>

</files>

<position>breadcrumb</position>

<position>right</position>

<position>footer</position>

<position>debug</position>

<position>syndicate</position>

</positions>

</install>

Passaggio 5

Giunti a questo punto non resta altro da fare se non creare un archizio .zip contenente tutti i file del template e installarlo attraverso il tool di gestione di Joomla.

www.joomla.it

Tieni d'occhio gli ultimi articoli pubblicati su Hosting-linux.biz!

Hosting economico

Hosting LAMP economico.

A soli 3,30 € / mese prova Lunarpages basic: cPanel, spazio disco illimitato, illimitati domini gestibili, illimitati DB MySQL / PostgreSQL, illimitate caselle di posta POP3, IMAP4, SMTP, ...