Elxisitalia.com!
Il portale sull'open source Elxis CMS.

Home News Downloads Guide Elxis F.A.Q. Elxis Wiki Elxis Forum Link SiteMap Info

Elxis Templates Guide - Parametri XML Template Elxis

Inserimento Parametri nel file XML del template.

Aprire (creare) il file templateDetails.xml del template. Come per i moduli, bots e componenti di Elxis, creare una sezione geneale chiamata params e per ogni parametro che desiderate aggiungere, creare una sottosezione che inizia con param.
Di seguito di parametri supportati da Elxis:

text visualizza un campo input testo
radio visualizza un gruppo di radio boxes
list visualizza una lista di selezione drop down
mos_section visualizza una una lista drop down di tutto il contenuto sezioni
mos_category visualizza una una lista drop down di tutto il contenuto categorie
mos_menu visualizza una una lista drop down di tutti i tipi menù
imagelist visualizza una lista di immagini in una determinata categoria (attributo directory)
textarea visualizza una campo textarea (colonne e righe sono controllati dagli attributi attributes cols and rows)
spacer visualizza una linea di separazione
folderlist visualizza una lista di cartelle di in determinata directory (attributo directory)

Esempio di parametri nel file XML del template.

Etichette (labels) e descrizioni in mutlingua

Si possono avere anche etichette (labels) e descrizioni XML in multilingua per ciascun parametro da usare. Possono essere variabili già presenti nel file XML della lingua amministrativa e contrassegnate con "AX_" o delle variabili personali che iniziano con "CX_", Per richiamare il contenuto delle variabili che si vogliono utilizzare, bisogna usare il parametro cxlangdir posto all’inizio (header) del file XML.
Per vedere le variabili "AX_" disponibili aprire il file administrator/language/english/english.xml.php

Esempio di dichiarazione del parametro cxlangdir nel file templateDetails.xml

<cxlangdir>/templates/demotemplate/language</cxlangdir>
All’interno della cartella cxlangdir inserire i files lingua personalizzati e nominati come: english.php, italian.php, french.php, etc.
In ogni file lingua personale, dichiarare le stringhe di testo come costante PHP. Ogni stringa di testo dovrà essere abbinata a un nome variabile che inizia con CX_

Esempio: define('CX_DEMOTPL_HELLO', 'Benvenuto!');
Vedere anche: Parametri Multilingua XML.

Inserire la funzionalità dei parametri nel file index.pho del template.

Quando sono stati settati i parametri del file templateDetails.xml e l'inserimento dei dati è funzionale nell’area amministrativa di Elxis, si può procedere a lavorare sul file index.php del template, inserendo i parametri definiti in precedenza e che cambieranno il layout e lo stile del template.
Aprire il file index.php del template e procedere con l’inserimento dei parametri. Di seguito un esempio su come inserire i parametri nel template.

//Get the value of a parameter
//general syntax
$tplparams->get('parameter_name', 'default_value');
//example
$tplparams->get('csscolor', 'Red');

//Define the value of a parameter if it is not set
//general syntax
$tplparams->def('parameter_name', 'default_value');
//example
$tplparams->def('csscolor', 'Red');

Terminato l’inserimento dei parametri bisogna aggiungere alcune funzionalità nel template.
Esempio settaggio del logo:

<?php
//get the parameter value
$logo = $tplparams->get('logo', 'logo.png');
//check if the logo is not empty and the image file exists
if (($logo == '') || !file_exists($mainframe->getCfg('absolute_path').'/templates/demotemplate/logos/'.$logo)) {
//in case logo is invalid, use the default one
$logo = 'logo.png';
}
?>

<img src="<?php echo $mainframe->getCfg('live_site'); ?>/templates/demotemplate/logos/<?php echo $logo; ?>" alt="logo" />