Introduzione
Installazione
Introduzione ai modelli
Design con AutoTheme
Funzionalità aggiuntive
Amministrazione
Bugs e Feedback
AutoTheme è un sistema di organizzazione dei temi in HTML per i seguenti sistemi di gestione contenuti, meglio noti come Content Management Systems (CMS): eNvolution, MDPro, PHP-Nuke, PostNuke. Normalmente il gestore temi in uso richiede che voi abbiate una certa familiarità con PHP e con l'architettura dei CMS. Se invece non siete pratici di PHP e/o CMS, AutoTheme fa per voi in quanto elimina questo problema.
Il primo vantaggio di AutoTheme è quello di offrire agli utenti la possibilità di creare temi in HTML utilizzando il proprio editor preferito, senza fare alcun uso di PHP. In aggiunta, AutoTheme offre una facile personalizzazione di ogni parte del vostro sito, compresa la visualizzazione dei blocchi, modelli personali per la Home Page, pagine degli utenti, pagine di amministrazione e moduli individuali. L'aggiunta di AutoBlocks offre infine la possiblità di collocare i blocchi ovunque all'interno delle pagine e in qualsiasi posizione. Tutte le impostazioni di AutoTheme sono facilmente configurabili attraverso un'interfaccia di amministrazione grafica integrata nel CMS.
Benché non sia necessario sapere come sono costruiti i temi, una comprensione di base sul funzionamento di un CMS è comunque necessaria. Un'installazione standard del CMS fa uso di quattro elementi principali nel layout: i blocchi di sinistra, i blocchi centrali, i blocchi di destra e i moduli. Si possono creare e modificare blocchi attraverso il menu di amministrazione del CMS, ma non i controlli del tema, cioè quando, dove e come questi quattro elementi vengono visualizzati. Due elementi ulteriori vengono utilizzati per le news: il sommario dell'articolo (visualizzato nella pagina principale) e l'articolo completo (visualizzato quando l'utente legge l'articolo, di solito cliccando sul collegamento "leggi tutto"). Vedi esempio:
[ Sito di esempio ]
AutoTheme, inoltre, utilizza AutoBlocks, ovvero la possibilità di aggiungere blocchi in posizioni illimitate oltre alle quelle note: a sinistra, destra e centrale. Avete inoltre il controllo totale su quando mostrarli a sinistra, destra, in centro o tramite AutoBlocks. Vedi l'esempio:
[ Sito di esempio (con AutoBlocks) ]
Scompatta AutoTheme nella cartella del tuo CMS. in questo modo si creerà una cartella modules/AutoTheme/ ed alcune cartelle di temi sotto la radice themes.
Dopo aver installato i files necessari e quelli opzionali, vai in Amministrazione/ Moduli, e clicca su Rigenera. Inizializza e attiva AutoTheme. AutoTheme è ora accessibile attraverso l'area di amministrazione principale.
*** Attenzione! il file: modules/AutoTheme/autotheme.cfg e ogni theme.cfg nella vostra cartella dei temi devono avere i permessi di scrittura dal server!
La maniera più semplice in Unix/Linux è CHMOD 777 autotheme.cfg e CHMOD 777 theme.cfg
Windows non dovrebbe essere un problema a meno che non abbiate impostato particolari permessi sulle cartelle o sui files.
AutoTheme è un sistema per organizzare temi, non un tema. I modelli e le immagini inclusi in HTML possono essere utilizzati come sono o modificati secondo le vostre necessità; sono semplicemente esempi. Potete usare la vostra creatività per costruire un tema personalizzato utilizzando le funzionalità di AutoTheme. I file modello del vostro AutoTheme possono essere nominati come volete e organizzati in qualsiasi struttura di cartella sotto la vostra cartella del tema. Il vostro sito può quindi richiedere pochi o tanti files a seconda delle impostazioni che darete.
Gli unici files richiesti per AutoTheme sono elencati qui sotto. Con questi, creati e definiti nell'amministrazione di AutoTheme, avrete un CMS di base.
Anche la posizione di ciascun blocco può avere il proprio modello (sinistra, centro, destra e AutoBlocks). Inoltre ogni blocco ha un unico nome configurabile tramite il pannello di amministrazione/blocchi. Potete definire modelli personalizzati validi solo per uno specifico blocco.
Ogni modulo o pagina del vostro sito può avere il proprio modello. Ne consegue che ogni pagina visualizzabile è completamente personalizzabile. Ogni modulo ha un nome unico assegnato tramite il pannello di amministrazione/moduli. Potete definire modelli personalizzati, fogli di stile, immagini, colori e contenuto dell'intestazione validi per ciascun specifico modulo. Inoltre potete controllare quali blocchi vengono visualizzati in quale modulo o pagina. Oltre che per i moduli installati sul vostro sito, AutoTheme offre la possibilità di definire modelli separati per: Home Page (indipendentemente dal modulo che la compone), pagine di amministrazione, pagine utenti (My Account, ecc.).
E' molto facile disegnare modelli in AutoTheme. Semplicemente utilizzate il vostro editor HTML preferito e disegnate un modello di pagina principale (theme.phtml), un modello per i blocchi di sinistra (leftblock.phtml), un modello per i blocchi di centro (centerblock.phtml) e infine un modello per i blocchi di destra (rightblock.phtml). Inoltre il modulo news usa il tema per due tipi di visualizzazione articolo: Sommario dell'articolo (summary.phtml) e articolo completo (article.phtml). I modelli per il tema principale devono essere files HTML contenenti i tag <html>, <head>, <body>e i relativi tag di chiusura. I files per blocchi e articoli non devono contere <html>, <head>, <body> o i relativi tag di chiusura. Solo i tag necessari per costruire il vostro blocco o articolo.
Nel disegnare il modello per la vostra pagina principale, tenente in mente gli elementi di base di layout per un sito. Le locazioni in cui questi devono essere messi sono specificate nei vostri modelli HTML utilizzando i commenti, che sono commenti HTML standard con all'interno un comando AutoTheme. I comandi di AutoTheme sono racchiusi da parentesi quadre [ ] ed hanno la seguente sintassi:
esempio: <!-- [command] -->
<td><!-- [left-blocks] --></td>
I comandi utilizzati all'interno di tag HTML non vanno messi in forma di commento e sono racchiusi da parentesi graffe { }.
Esempio: {command}
<font color="{color7}">
Ecco di seguito la lista con spiegazione dei comandi inclusi:
[ Comandi ]
In molti sistemi di base (core) e moduli aggiuntivi dei CMS si usano due tabelle per i temi e diversi colori. Il bordo e lo sfondo delle tabelle può essere configurato nell'amministrazione di AutoTheme. Inoltre potete configurare modelli per la tabella1 e la tabella2. Questi prevarranno sui colori di tabella che avete specificato.
La locazione di base del vostro CMS è quella in cui si trova il file index.php del CMS. Quindi, le immagini e gli altri files, quali ad esempio scripts che si trovano in una sottocartella del vostro tema dovranno usare un percorso relativo per trovare il file index.php del vostro CMS. Se ad esempio le vostre immagini si trovano nella cartella images un tag <image>e <script> saranno di questo tipo:
Esempio: <img src="themes/AutoTheme/images/image.gif">
Esempio: <script src="themes/AutoTheme/javascript/script.js">
Sono a disposizione due comandi per referenziare percorsi nei vostri modelli. Il primo serve per la vostra cartella del tema, il secondo per la cartella delle immagini del vostro tema:
Comando: {theme-path}
Esempio: <script src="{theme-path}javascript/script.js">
Comando: {image-path}
Esempio: <img src="{image-path}image.gif">
Nel preparare il vostro modello potete utilizzare cascading style sheets (CSS) o fogli di stile a cascata, per definire l'aspetto di alcuni elementi o tag. Questo foglio di stile deve essere salvato sotto la cartella style del vostro tema come style.css (foglio di stile principale) e styleNN.css (per Netscape navigator). Questi possono contenere differenze di stile ma probabilmente funzioneranno anche se sono identici. Potete includere i vostri fogli di stile nell'header del vostro modello di tema quando lo editate, ma la referenza <link> verrà rimossa da AutoTheme e il CMS includerà in modo dinamico uno o l'altro dei fogli di stile a seconda del browser del visitatore. Potete anche definire un foglio di stile aggiuntivo da includere dopo quelli di default del CMS.
Ovviamente se non c'è un comando per quello che volete fare o se non vi piace il modo in cui un comando funziona, potete sempre usare codice PHP nel vostro modello HTML.
Esempio: <td><?php echo $username." AutoTheme is cool!"; ?></td>
Il supporto per le lingue è compreso in AutoTheme ed è disponibile creando un file global.php nella cartella del vostro tema sotto la cartella lang/tualingua/. Tutto il testo dei comandi di AutoTheme presenti e futuri utilizza variabili di linguaggio dal file global.php del tema o da quello principale del CMS. L'inglese è incluso in AutoTheme nella cartella lang/eng/.
Anche la scrittura da destra a sinistra è supportata e viene attivata automaticamente quando la lingua dell'utente è una lingua RTL (Right-To-Left ). Arabo ed ebraico sono attualmente attivate.
Multi-Sites è supportato automaticamente in AutoTheme. I temi di AutoTheme possono essere inclusi nella cartella principale themes/ del vostro CMS o in una cartella themes/ di una cartella multi-site senza alcuna modifica al codice del tema o di AutoTheme. Quando si usa un tema di AutoTheme in una cartella multi-site, solo quel sito ha la possibilità di usare il tema. Quando si usa nella cartella principale themes/, tutti i site possono usare quel tema. Come è detto nella documentazione multi-site, non va incluso un tema con lo stesso nome nella cartella principale del vostro sito e in quella del tema multi-site.
La configurazione di AutoTheme avviene attraverso il sistema di amministrazionet del CMS. Le aree seguenti sono disponibili per la configurazione di AutoThemes:
*** IMPORTANTE! Non amministrare o configurare un AutoTheme quando il tema è impostato come il vostro tema di default!
Gli AutoTemi vengono rilevati automaticamente e se cliccate su un AutoTheme da una versione precedente, esso verrà automaticamente importato.
*** Dopo aver importato un tema, dovete sostituire theme.php con quello nuovo e cambiare i comandi [color], [theme-path] e [image-path] nei vostri modelli nel nuovo formato per i comandi all'interno di tag, {command}!
Una volta verificato che il vostro AutoTheme importato funziona perfettamente, potete cancellare senza problemi i files seguenti dalla cartella del vostro tema:
Qui è dove configurate i modelli di default, la visualizzazione blocchi, colori e contenuto per il vostro vostro AutoTheme. Per ogni modello che volete definire basta fornire il nome del file del modello e il percorso relativo alla vostra cartella del tema. Potete scegliere quale posizione dei blocchi mostrare per default e quali colori sono utilizzati dal sistema del CMS. Questi sono gli elementi usati per deafult a meno che non venga definito un Modulo personalizzato.
Qui è dove aggiungete modelli da personalizzare.Potete anche avere un'anteprima dei modelli come li avete configurati.
Per aggiungere un Modelli personalizzato, basta inserire il nome del modello nel riquadro di Aggiunta modelli personalizzati. Questo può essere o meno il nome della cartella del modulo. Il nome del modulo si può trovare nel menu Amministrazione/moduli.
Esempio: Web_Links
Oltre ai vostri moduli installati, potete personalizzare tre altre aree del vostro sito:
Potete così configurare modelli, visualizzazione blocchi, colori e contenuto dei vostri specifici moduli. Per ogni modello che volete definire basta fornire il nome del file del modello e il percorso relativo alla vostra cartella del tema. Potete scegliere quale posizione dei blocchi mostrare per default per ogni modulo e quali colori sono utilizzati dal sistema del CMS.
Qui è dove definite modelli per blocchi specifici secondo il nome. Per ogni blocco che volete personalizzare basta aggiungere il nome del blocco e il modello associato.
Per aggiungere un blocco personalizzato, basta inserire il nome del blocco nel riquadro in cui si chiede di aggiungere un blocco personalizzatoa. Questo è il nome del blocco o titolo che può essere trovato all'interno del menu Amministrazione/blocchi.
Esempio: Main Menu
I comandi possono anche essere dinamicamente generati per ogni blocco personalizzato che definite e sono disponibili solo per questo all'interno di quel tipo di AutoTheme.
Esempio: [Main Menu]
Inviate un report dei bug, una richiesta di supporto e feedback a autotheme@mckenzies.net oppure visitate il Forum di Spidean.
Copyright (c) 2002-2003 Shawn McKenzie
http://spidean.mckenzies.net