Login
Nome utente:

Password:

Ricorda



Recupero password

Registrati!
Navigazione
Utenti Online
17 utente(i) online
(1 utente(i) in Tutorial)

Iscritti: 0
Ospiti: 17

altro...
Tutorial :: Tutorial Xoops 2.0.x

Override di un template: tutorial introduttivo


Override di un template: tutorial introduttivo
http://www.xoops.org/modules/news/article.php?storyid=3367
Questo articolo, spiega il concetto di override (sovrascrittura) di un Template, una caratteristica introdotta in XOOPS 2.0.14.
E' stato realizzato per aiutare gli utenti a capire questo nuovo concetto tramite una serie di esempi.
Intestazione
  1. 1) Che cos'è un template
  2. 2) Il concetto di Override
  3. 3) Esempio pratico #1
  4. 4) Esempio pratico #2
  5. 5) Override delle immagini
  6. 6) Note e altri override

1) Che cos'è un template


Prima di tutto, cos'è un template?
I template possono visualizzare dati (come possono allo stesso modo ordinarli, posizionarli, e visualizzarli condizionatamente...).
I template sono usati per separare il processo di visualizzazione dati da quello di recupero e manipolazione.
Questo consente a quanti non sono programmatori di formattare facilmente i dati per la presentazione, senza modificare il codice sottostante, semplicemente modificando il file del template.

XOOPS ha di base dei template (quelli del modulo system sono 26 file), per esempio:
- system_redirect.html (Pagina di reindirizzamento)
- system_siteclosed.html (Pagina sito chiuso)
- system_block_login.html (Blocco di login)
- system_block_online.html (Blocco utenti online)
- system_block_comments.html (Blocco commenti)...
Inoltre tutti i moduli recenti usano template (pagine e blocchi).

Esempio:
Modulo News (15 template):
- news_archive.html (pagina archivio)
- news_block_new.html (blocco nuove notizie)
- news_block_top.html (blocco notizie più lette)...

Per visualizzare questi template, vai a admin -> system -> templates e clicca nella lista del modulo che vuoi vedere, nell'insieme dei template di default.
La sezione superiore mostra la pagina dei template, con i template dei blocchi nella parte inferiore.

Se queste pagine e blocchi non sono visualizzate nei tuoi link, non è un problema, puoi modificarli con la nuova funzionalità inclusa nel core dalla versione XOOPS 2.0.14:
Overriding dei template.

Un estratto dall'annuncio di rilascio di XOOPS 2.0.14:
Citazione:
I progettisti possono aggiungere template ai loro temi, e questi saranno usati al posto di quelli di default.
Per sfruttare questa caratteristica, i template devono essere creati in sottocartelle dei temi duplicando la struttura delle cartelle e rimuovendo la sezione "templates":
Per sovrascrivere:
system_userinfo.html (template che si trova in modules/system/templates/system_userinfo.html), devi creare la tua versione personalizzata in:
/modules/system/system_userinfo.html

Per sovrascrivere:
system_block_login.html (template che si trova in modules/system/templates/blocks/system_block_login.html), devi creare la tua versione personalizzata in:
/modules/system/blocks/system_block_login.html


2) Il concetto di Override


Ora, non c'è più bisogno di clonare il tuo template set di default, puoi continuare ad usarlo (infatti, per l'override, DEVI utilizzarlo),
sarà sufficiente creare una copia del template orginale de modulo nella directory themes//modules/.

Vantaggi:
- Nel caso di "Aggiornamento" del modulo, i file modificati non devono essere cancellati
- Solo i template modificati saranno presenti nella directory
- La traccia delle personalizzazioni dei template è ora molto semplice (struttura dei file)
- Facile da usare
- Puoi cambiare temi molto facilmente sovrascrivendo il pacchetto dei template di default (per esempio, blocco di login, blocco di ricerca, blocco sito chiuso...)

3) Esempio pratico #1


Personalizzazione del template "blocco commenti" (system_block_comments.html del modulo system)

0a) Verifica le modifiche nel tuo server di test prima di effettuare cambiamenti in produzione.
0b) Devi utilizzare una versione di XOOPS 2.0.14 o superiore, (o la versione 2.3.x)
0c) Se stai utilizzando un insieme di template clonati, devi attivare il template set default per poter usare l'Overriding.
In questo caso, puoi scaricare i template personalizzati dal tuo set clonato in modo da spostarli nella cartella appropriata per l'overriding.
0d) Il tuo blocco deve essere visibile per vedere le modifiche al template! (per i nuovi utenti)

1) Prima di tutto esegui il download del template del blocco:
admin system / templates / elenco System / linea system_block_comments.html, [Download]/i]
<table width="100%" cellspacing="1" class="outer">
 <{foreach 
item=comment from=$block.comments}>
 <
tr class="<{cycle values="even,odd"}>">
   <
td align="center"><img src="<{$xoops_url}>/images/subject/<{$comment.icon}>" alt="" /></td>
   <
td><{$comment.title}></td>
   <
td align="center"><{$comment.module}></td>
   <
td align="center"><{$comment.poster}></td>
   <
td align="right"><{$comment.time}></td>
 </
tr>
 <{/foreach}>
</
table>


2) Modifica il file appena scaricato e che ora è in locale.
<table width="100%" cellspacing="1" class="outer">
 <{foreach 
item=comment from=$block.comments}>
           <
tr class="<{cycle values="even,odd"}>">
               <
td style="text-align: left; vertical-align: middle;">
                   <
img src="<{$xoops_url}>/images/commentaires_ico_16.gif" alt="Commentaire" /> <{$comment.title}>
                   <
div style="text-align:right"><br /><{$comment.module}> - <{$comment.time}> - <{$comment.poster}></div>
               </
td>
           </
tr>
 <{/foreach}>
</
table>


3) Se il mio tema è 7dana-soft, tramite ftp, vai alla cartella
/themes/7dana-soft Crea una cartella 'modules' e poi all'interno crea la cartella 'system' (il nome del modulo di cui si sovrascrive il template) e poi la cartella 'blocks'.
4) Esegui l'upload del file locale system_block_comments.html in /themes/7dana-soft/modules/system/blocks/ sul server.
5) Elimina i file nella cartella /template_c (eccetto index.html) (o aggiorniamo la cache del modulo) in modo da visualizzare i risultati dei nostri cambiamenti...


<== blocco commenti di default
blocco personalizzato ==>



4) Esempio pratico #2


Un altro esempio ma con i "contenuti in attesa" del modulo Blocco Estensibile Contenuti in Attesa.

0a 0b 0c 0d Gli stessi dell'esempio 1
1) Prima esegui il download del file blocco template:
admin system / templates / Waiting Contents Extensible [i]lista / linea waiting_block_waiting.html, [Download]
<{foreach item=module from=$block.modules}>
<{
$module.name}>
<
ul>
 <{foreach 
item=pending from=$module.pending}>
 <
li>
   <{if 
$pending.pendingnum}>
     <
span style='font-weight:bold;'>
   <{else}>
     <
span style='font-weight:normal;'>
   <{/if}>

     <
a href="<{$pending.adminlink}>"><{$pending.lang_linkname}></a>:<{$pending.pendingnum}>
   </
span>
 </
li>
 <{/foreach}>
</
ul>
<{/foreach}>


2) Modifica il file appena scaricato e che ora è in locale.
<{foreach item=module from=$block.modules}>
<
b><{$module.name}></b>
<
ul>
 <{foreach 
item=pending from=$module.pending}>
 <
li>
     <
a href="<{$pending.adminlink}>"><{$pending.lang_linkname}></a> :
   <{if 
$pending.pendingnum}>
     <
font color=red><b><{$pending.pendingnum}></b></font>
   <{else}>
     <{
$pending.pendingnum}>
   <{/if}>
 </
li>
 <{/foreach}>
</
ul>
<
hr />
<{/foreach}>


3) Se il tema è 7dana-soft, tramite ftp, vai alla cartella /themes/dana-soft. Crea la cartella modules, e all'interno waiting, e ancora la cartella blocks
4) Eseguiamo l'upload del file locale waiting_block_waiting.html nella cartella /themes/dana-soft/modules/waiting/blocks/ nel server.
5) Cancelliamo i file nella cartella /template_c (eccetto index.html) (o aggiorna la cache del modulo) per visualizzare i risultati...

Immagine vecchia Imagine nuova
<== Blocco di defualt dei contenuti in attesa - Personalizzato ==>

5) Override delle immagini


Infine, è possibile anche l'overriding di immagini. Ci sono 2 casi possibili:
- se il modulo usa l'overriding, puoi semplicemente copiare immagini nella stessa cartella del tema per overriding dei template del modulo,
- Modifichiamo un template in questo modo:
<img src="<{xoImgUrl modules/mymodule/images/image1.gif}>" alt=""/>


Esempio:
Cambiare immagine dal modulo news (l'immagine print.gif) (template article.html dal modulo news)
Sostituiamo il codice seguente nel template article.html:
<img src="<{$xoops_url}>/modules/news/images/print.gif" border="0" alt="<{$lang_printerpage}>" />

con questo:
<img src="<{xoImgUrl modules/news/images/print.gif}>" border="0" alt="<{$lang_printerpage}>" />

Quando questa pagina sarà visualizzata, il template mostrerà l'immagine posizionata in //modules/news/, e se l'immagine non esiste, sarà visualizzata l'immagine iniziale (/modules/news/images).

6) Note e altri override


Nota 1:
In entrambi gli esempi, abbiamo semplicemente modificato i template dei blocchi, per i template delle pagine, fai l'upload dei tuoi file in:
//modules/miomodulo e non in //modules/miomodulo/blocks.

Nota 2:
Dai un'occhiata a questo tema, [url:http://www.7dana.com/download/pafiledb.php?action=file&id=21]7dana-clean[/url].
In questo tema troverai:
- La nuova posizione dei blocchi (blocchi basso centrale, blocchi basso sinistra, blocchi basso destra)
- 7 template per l'overriding

Nota 3:
Copia index.html (dalla cartella templtate_c o in ogni altra cartella del core contenente index.html) nella nuova cartella del modulo nel tuo tema.

Override del CSS
Per i CSS, l'overriding è utilizzato alla stessa maniera, ma il comando è differente:
<{$xoTheme->addStylesheet('modules/news/style.css')}>

javascript overriding
Presto maggiori informazioni.

---------------

Articolo originale: http://www.xoops.org/modules/news/article.php?storyid=3367
Traduzione a cura di flymirko
<< Cloniamo Soapbox!

API: RSS | RDF | ATOM
Copyright© ianez & Xoops Italia
I commenti sono di proprietà degli autori. Si declina ogni responsibilità sul loro contenuto.

Autore Contenuto
Anonymous
Data di invio: 17/7/2012 3:04  Aggiornato: 17/7/2012 3:04
 Re: Override di un template: tutorial introduttivo
oneself. Visualizza immagine originale For a Xmas themed Bride you might choose to put on a silvery white, accessorised using a faux fur bolero or wrap, wedding dress wedding dress alternatively (also to retain you more toasty!) why don't you go to get a cloak or maybe a cape inside a complimenting color way mother of bride dress plus size mother of bride dress plus size kids dresses kids dresses . A fur hand muff can help quit your fingers turning blue and preserve off the chill for the duration of out of doors images. Your bouquet could encompass Christmassy flowers and foliage this sort of as poinsettias plus size mother of bride dress plus size mother of bride dress girl flower dress girl flower dress , mistletoe, holly and ivy or pinecones among the greater common flowers these kinds of as carnations, lilies or roses bridesmaid dress cheap bridesmaid dress cheap . A horse drawn sleigh or carriage, or perhaps a tinsel adorned vehicle with Father Xmas as your driver could transportation you to the venue and with the conclude with the ceremony whenever you exit as newlyweds why don't you have your visitors mother of bride dresses plus sizes mother of bride dresses plus sizes

Autore Contenuto
huff01
Data di invio: 5/9/2012 8:29  Aggiornato: 5/9/2012 8:29
Senior
Iscritto: 5/9/2012
Da:
Inviati: 164
 fake breitling watches
Visualizza immagine originale understood for being very accurate and also to offer you intense dependability to your proprietor with the new Edox WRC Rally Timer Day Day Observe breitling avenger replica breitling avenger replica . fake audemars piguet deva ladies replica watch fake audemars piguet deva ladies replica watch audemars piguet danae replica audemars piguet danae replica fake watches fake watches The method for the sporty style resides also while in the alternative of your strap that is certainly designed from black rubber and fitted that has a folding clasp constructed from chrome steel. Other variations of your new Edox WRC Rally Timer Day Day View involve a chrome steel bracelet or if referred to your dial replica audemars piguet replica audemars piguet , a blue dial made up of a mixture of darkish and light-weight shades of blue. breitling chronospace replica fake watch breitling chronospace replica fake watch Particularly desirable and very appealing to any rally participant, the brand new Edox WRC Rally Timer Day Day Look at will likely be the official WRC timepiece. The tasteful eyesight of Haute Horology imposed because of the individuals at the rear of A armani swiss fake watch armani swiss fake watch . watches replica watches replica Lange Sohne has paid out off at some Armani Swiss Watches Armani Swiss Watches

Autore Contenuto
huff01
Data di invio: 5/9/2012 11:32  Aggiornato: 5/9/2012 11:32
Senior
Iscritto: 5/9/2012
Da:
Inviati: 164
 fake watches
motion ensures a retrograde show, a day window and likewise, 24 neighborhood time-zones exhibiting some time for twenty-four various towns. The dial is obtainable on quite a few versions in line with the cases finishing specifics and it provides awesome legibility. Among two and three oclock, Fake Audemars Piguet Swiss Fake Audemars Piguet Swiss Visualizza immagine originale the dial would make place for your discreet day window, even though two semi-arch windows current the data for your 24 towns plus a winter-summer functionality among three and six oclock and in between nine and twelve oclock positions. Among the 24 unique towns we will note replica watches Audemars Piguet replica watches Audemars Piguet Emporio Armani Mens Chronograph Watches Emporio Armani Mens Chronograph Watches fake audemars piguet watch fake audemars piguet watch : Dubai fake watches for sale fake watches for sale , Moscow, iwc replica iwc replica Athens fake watches for men fake watches for men, La and Big apple. 20 total views, 1 today 20 total views, 1 today Prosperous in truth about the current market of look at producing, fake audemars piguet deva ladies replica watch fake audemars piguet deva ladies replica watch the brand new TX 550 Sequence Entire world Time Activity View will come accompanied by a rubber strap to guarantee that meant sporty attraction and

Autore Contenuto
huff01
Data di invio: 12/9/2012 2:52  Aggiornato: 12/9/2012 2:52
Senior
Iscritto: 5/9/2012
Da:
Inviati: 164
 emporio armani replica
40 years old. Later it was to become one of the most profitable and largest vehicle companies in the world. The company is currently ranked as fourth largest vehicle manufacturer. This is based on sales worldwide. Surprisingly, the enterprise is largely controlled and managed by a family for so many years now. ulysses nardin replica watches ulysses nardin replica watches The business has grown to produce more than a million a year. replica rado replica rado The initial manufacturing companies were located in Michigan and Detroit. replica oris replica oris The models were also named alphabetically. They only had one color, which was black. vacheron constantin replica vacheron constantin replica The business boomed in 1908 when he started selling the first public vehicle. This was a milestone both for this firm and the automobile industry. This company had its challenges with employees in 1920 girard perregaux replica girard perregaux replica . Visualizza immagine originale girard perregaux replica girard perregaux replica replica omega replica omega The management however reacted by doubling employees income and providing

Autore Contenuto
huff01
Data di invio: 12/9/2012 3:44  Aggiornato: 12/9/2012 3:44
Senior
Iscritto: 5/9/2012
Da:
Inviati: 164
 replica philip stein
after the number of protein, moisture and hair attention productions, can be targeted to use some shampoo, hair conditioner and the elite of nutritional supplements, do concern of? oil is also a good choice. porsche design replica watches porsche design replica watches 2. Perming 3 days to avoid using hair sticks and cordless curlers and hair as many for likely, to help the outward of longterm perm. 3 Visualizza immagine originale . Perm replica alain silberstein replica alain silberstein , replica watch replica watch replica jacob co replica jacob co replica roger dubuis replica roger dubuis the combing of the correct way is to use widetooth comb to open the 1st knitted hair comb to avoid pulling force. Best not to use that plastic comb, glashutte replica glashutte replica because the static electricity generated along large plastic comb. 4. Perm do not have to bathe each day. Force should not rub hair shampoo, because it namely simple to mar the hair Panerai Replica, attempt to make the hair dry certainly after washing. Do not use hot hair dryer replica omega watches replica omega watches , rather with great hairdryer,
Sostieni XoopsItalia!
Ultimi Tutorial
Ultime Traduzioni
XOOPS ITALIA © 2002-2012 - Powered by XOOPS