TYPO3.it: golive tutorial

Golive tutorial in italiano
IMPOSTARE UN TEMPLATE ORDINARIO IN HTML

12/11/2005

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

Traduzione diVirginio Carabba

The content of this document is related to Typo3

- a GNU/GPL CMS/Framework available from www.typo3.com

Impostare un template ordinario in HTML

Benvenuti in questo tutorial dedicato all'impostazione di templates ordinari con Typo3.

Originariamente la creazione di templates per Typo3 avveniva tramite TypoScript, che permetteva di portare un determinato contenuto dal sistema al codice HTML.

Il Typo Script non è molto semplice da apprendere ma è uno strumento molto potente e costituisce ancora la spina dorsale del sistema Typo3.

Questo tutorial prende ad esempio una pagina di prova costruita con GoLive.

In primo luogo è necessario installare il sito di prova standard di Typo3

In secondo luogo copiate i files e le cartelle di questo tutorial nel root del sito di prova, fatta eccezione per “tmplpage.html” e "main.css” che vanno invece copiati nella cartella “fileadmin/”. Questo file è il template di base del vostro sito e deve risiedere in questa cartella, poiché Typo3 presume di accedere a quel file.

A questo punto effettuate il login nel Typo3 del sito di prova con l'utente “admin” e create un nuovo record “Template” sulla pagina “Startpage”, in questo modo:

Inserite a questo punto il titolo del template. Si tratta di un semplice titolo e non verrà visualizzato altrove. Potete utilizzare il campo di descrizione in fondo per descrivere il vostro template. Inserite quindi il titolo del sito. Riflettete sul titolo più opportuno visto che verrà visualizzato nel campo titolo di ogni pagina (è comunque opzionale).

Spuntate il flag “Clear” (così facendo sarete sicuri che il TypoScript avrà cancellato ogni precedente template nel page-tree) ed il flag “Rootlevel” (per indicare che volete che questo template costituisca una nuova root di un sito web).

Nel campo „Setup“ inserite i seguenti valori:

page = PAGE

page.typeNum = 0

page.10 = TEMPLATE

page.10.template = FILE

page.10.template.file = fileadmin/tmplpage.html

Questi comandi TypoScript avviano un nuovo template definendo un oggetto-Pagina (page) ed assegnando ad esso il type-number di default “0”. A questo punto il file template è caricato come input per un oggetto contenuto del template posto nella lista cObject della pagina pageobject.

Vi sembra incomprensibile? Non preoccupatevi, non è necessario che comprendiate tutti i dettagli (è per questo che state leggendo questo tutorial, no?). Il template dovrebbe a questo punto apparire così:

...se ora salvate il template e andate al frontend del sito questo è quello che dovreste vedere

Il template GoLive vi apparirà esattamente così, e fin qui tutto bene. Se date un'occhiata al codice HTML della pagina vedrete che il codice di testa del TypoScript è ancora inserito. Ci sono due tag body e di conseguenza dobbiamo concludere che non abbiamo ancora finito. Raccomanderei di mantenere il codice di testa di Typo (anche se potete disabilitare l'output di testa dal TypoScript). Ho già preparato il template GoLive per questo. Date un'occhiata alla posizione subito dopo il tag body del template GoLive. Ho inserito un commento HTML:

e lo stesso codice si trova anche in fondo al documento stesso. Questo è un “subpart”.

Modificate il record template all'interno di Typo3 in questo modo:

page = PAGE

page.typeNum = 0

page.10 = TEMPLATE

page.10 {

template = FILE

template.file = fileadmin/tmplpage.html

workOnSubpart = DOCUMENT_BODY

}

La novità qui è l'aggiunta di DOCUMENT-BODY. Il resto è soltanto un modo più intelligente di scrivere codice TypoScript... Salvate il template e ricordate di pulire tutta la cache (dovete farlo tutte le volte che aggiornate un template!).