In questa guida vi mostreremo i passi principali per realizzare un template front-end per Elxis CMS Open Source.
Questa guida è rilasciata liberamente e senza nessuna garanzia sul risultato da parte vostra. Inoltre non siete autorizzati ad utilizzare il contenuto di questa guida, o una parte di essa, per pubblicazioni commerciali come libri ed e-book.. Se desiderate pubblicare questa guida on-line siete pregati di mettere all’interno della vostra pagina un link alla guida originale di Elxis.org. Quando avrete finito di leggere questa guida, speriamo che sarete pronti a realizzare il vostro primo template per Elxis 2008.x e versioni successive.

Cos’è un template?

Elxis CMS è un applicativo web Content Management System Open Source, sviluppato in PHP e che usa un database per archiviare i dati che inserite. Il codice sorgente di Elxis è assai complesso per la maggioranza degli utilizzatori, ma per questo non vi dovete preoccupare perché non ha alcuna importanza sapere come lavora internamente Elxis CMS per realizzare un sito internet. Questo perché in Elxis la logica PHP è separata dal layout del sito. In questa maniera voi potete cambiare quando desiderate il layout e il look del vostro sito senza nemmeno conoscere un codice di PHP. Per questo scopo si assegneranno al layout del sito delle speciali estensioni chiamate templates.
Un template è composto da una serie di files che servono per definire l’apparenza del sito e può essere installato o disinstallato come le estensioni di Elxis. Ma non solo: nel sito potrete avere più templates che potranno essere abbinati a singole o più pagine a seconda delle vostre necessità.

Template files.

Un template di Elxis è costituito, come minimo, dai seguenti files.

• index.php
• templateDetails.xml
• template_thumbnail.png
• css/template_css.css
• css/index.html
• images/index.html

index.php
Questo è il file principale del template. È come una normale pagina HTML con un suo personale layout e css. La differenza tra una normale pagina HTML e questo tipo di pagina è che Elxis la riempirà in automatico con i contenuti prelevati dal database, immagini ed altro. In questa maniera anziché scrivere il vostro articolo direttamente nella pagina HTML, tramite questa pagina direte ad Elxis di prelevare i dati dal database e di piazzarli in una determinata posizione che avete definito nel vostro template.
Allo scopo dovrete inserire nel vostro template dei semplici comandi in PHP.
Per poter richiamare il contenuto principale della pagina dovrete utilizzare:
<?php mosMainBody(); ?>
Oltre al contenuto potete caricare anche i moduli. Per far questo avrete due possibilità:
esempio:
<? mosLoadModules('left', -2); ?>
//or
<? elxLoadModule('mod_banners', -1); ?>
Se non avete familiarità con questo codice, non preoccupatevi, vi sarà spiegato più avanti.

templateDetails.xml
Questo è il file XML di installazione del vostro. Tutte le estensioni di Elxis hanno un file di installazione di questo tipo nel quale dovrete inserire tutte le informazioni riguardanti il vostro template e i nomi dei files che lo compongono. (Riferimento: Come realizzare un file XML per l'installazione di moduli).

template_thumbnail.png
È un file immagine di anteprima del vostro layout finale.

css/template_css.css
Il file CSS del vostro template.
Si raccomanda di inserirlo sempre in una cartella chiamata “css” del vostro template.
Se volete creare un template RTL compatibile, dovrete andare a creare anche un fille css e chiamarlo css/template_css-rtl.css . Elxis userà questo file automaticamente quando qualcuno avrà scelto una lingua RTL ( esempio persiano, arabo, etc.).

Si raccomanda di separare i file css in due file CSS: uno dedicato esclusivamente al layout del vostro template (“layout.css”) e l’altro che gestisce tutte le classi native di Elxis CMS (“customize.css”). All’interno del vostro file index.php andrete a richiamare un file css “template_css.css” nel quale dovete inserire queste righe che importano i due files css:
@import url("layout.css"); /*layout css file*/
@import url("customize.css"); /*Use this file to customize your website*/
Per le lingue RTL dovrete realizzare due files css, layout-rtl.css e customize-rtl.css che a loro volta sraranno richiamati nel file template_css-rtl.css.

css/index.html
File vuoto usato per prevenire l’apertura e la visione del contenuto della directory.

Altri files.
Il vostro template userà nel 99,999% dei casi anche delle immagini, Mettere le vostre immagini in una cartella “images/”.

Download Elxis template tutorial

Traduzione by Speck - Elxisitalia.com
Testo in lingua originale di Elxis.org