<?php print render($page['$page_top']);?>

Transcript

1 Creare un tema Drupal 7 Guida By Uffissim3000 Oltre al file.inf l unic file che è davver indispensabile al tema è page.tpl.php, vviamente dat che vgliam dagli un aspett gradevle e facilmente persnalizzabile, diventa indispensabile anche il file style.css. Per prima csa creare un tema vut (esempi: page.tpl.html) legat ad un più fgli di stile (esempi: style.css). Nella guida tralascerò cmpletamente i fgli di stile. Quand il risultat ci sddisfa, adatterem il tema a Drupal 7 prcedend in quest md: Rinminiam il file page.tpl.html in page.tpl.php Cancelliam tutta la parte <head> ed anche i tag <bdy> e </bdy>, avend l accrtezza di inserire in cima al nstr script: <?php print render($page['$page_tp']);?> Questa riga risulta indispensabile, dat che stamperà tutt l script html che cmprrà l head della nstra pagina. Alla fine dell script inserirem la riga di chiusura: <?php print render($page['$page_bttm']);?> Che stamperà tutt l script html che andrà a chiudere la nstra pagina. Ora prcediam cn l inseriment delle regini, immaginiam di avere un file html cmpst in quest md: <div id= pagina > <div id= testa > <div id= cntenitre > <div id= sinistra > <div id= centr > <div id= destra > <div class= clr > <div id= fter >

2 Le nstre regini in quest esempi sn 5 (per cmdità h dat cme id ai div l stess nme che userò per le regini): 1 testa 2 sinistra 3 centr 4 destra 5 fter Oltre a queste dbbiam però bbligatriamente cnsiderare almen un altra regine ssia cntent, che stamperà i cntenuti della pagina. Ptremm infine aggiungere anche message ed help. Ogni regine avrà un script simile a quest: <?php if($page['$regine']);?>  <?php print render($page['$regine']);?>  <?php endif;?>  Quindi il nstr file si trasfrma csì: <?php print render($page['$page_tp']);?> <div id= pagina > <div id= testa > <?php if($page['$testa']);?> <?php print render($page['$testa']);?> <?php endif;?> <div id= cntenitre > <div id= sinistra > <?php if($page['$sinistra']);?> <?php print render($page['$sinistra']);?> <?php endif;?> <div id= centr > <?php if($page['$centr']);?> <?php print render($page['$centr']);?>

3 <?php endif;?>  <?php if($page['$cntent']);?> <?php print render($page['$cntent']);?> <?php endif;?> <div id= destra > <?php if($page['$destra']);?> <?php print render($page['$destra']);?> <?php endif;?> <div class= clr > <div id= fter > <?php if($page['$fter']);?> <?php print render($page['$fter']);?> <?php endif;?> <?php print render($page['$page_bttm']);?> Ptremm aggiungere variabili per stampare dati aggiuntivi nel nstr tema, cme ad esempi il lg e il nme del sit. (le altre variabili sn riprtate nell appendice A1) <div id= testa > <?php if($lg);?> <img src= <?php print $lg;?> /><?php endif?> <?php if($site_name);?> <h2><?php print $site_name;?></h2><?php endif?> <?php if($page['$testa']);?> <?php print render($page['$testa']);?> <?php endif;?>

4 Incredibile ma ver, abbiam fatt un tema mlt basilare, ma funzinante, anche se ci rimane da vere il file inf. Le infrmazini che pssiam inserire in quest file sn mlteplici, limitiamci all indispensabile: ; $Id: tema.inf,v /03/06 12:22:00 dries Exp $ Name = Tema descriptin = un tema qualunque versin = 1.0 cre = 7.x php = engine = phptemplate regins[testa] = regine in cima regins[sinistra] = regine a sinistra regins[centr] = regine spra ai cntenuti regins[cntent] = regine cntenuti regins[destra] = regine a destra regins[fter] = fter features[] = lg features[] = name features[] = slgan features[] = missin features[] = nde_user_picture features[] = cmment_user_picture features[] = search features[] = favicn stylesheets[all][] = thestyle.css ; Infrmatin added by drupal.rg packaging script n versin = "7.0" prject = "drupal" H divis il file in parti per spiegare megli.

5 La prima parte sn delle infrmazini sul tema, ptremm aggiungere un file per l screensht ad esempi, ma cmunque nn c è mlt da spiegare. La secnda parte è un elenc delle regini che abbiam inserit nel nstr tema, c è il nme che abbiam usat nel file page.tpl.php e il nme che verrà usat nell amministrazine di Drupal. La terza parte è un esempi di tutte quelle inf aggiuntive che si può scegliere di visualizzare men nel tema (h riprtat alcuni esempi, vviamente ni abbiam inserit sl lg e nme del sit nel tema). La quarta parte è l elenc dei fgli di stile usati, ptremm sia elencarli tutti, che legare i secndari al fgli style.css ed inserire sl quest nel file inf, csì ci risparmiam rgne nel cas ne inseriam un nuv cambiam il nme ad un già creat. L ultima parte sn delle inf aggiuntive (superflu). nde.tpl.php E ver cn page.tpl.php abbiam creat un tema di base, quest tema per la stampa di ndi e blcchi userà infrmazini standard, ma perché nn sfruttare le grandi pprtunità che ffre Drupal creand un nstr layut anche per questi elementi? Vediam cme fare. Cs è un nd? Il cntenut delle nstre pagine sarà tutt divis in ndi, tutti i ndi cntengn i dati necessari a stampare il prpri cntenut: titl, data di creazine, autre, cntenuti ecc. Creand un layut per i ndi pssiam decidere dve psizinarli, all intern di quali tag e di quali classi ecc. Prcediam: Nel nstr tema vgliam che gni nd sia precedut dalle infrmazini che l riguardan, cme la data e l ra in cui sn stati inseriti gli articli (se si tratta di un articl); dpdiché deve seguire il titl del nd vviamente, ed infine i cntenuti. Ovviamente tutt dvrebbe essere racchius in un cntenitre.

6 Prcediam all impaginazine html: <div id= nd class= nd > <div class= dati > <div class= titl > <div class= cntenut > Ora nn ci rest ache inserire le variabili che il cre di Drupal trasfrmerà nelle infrmazini estate. Nterete che la prcedura è la stessa usata per il file page.tpl.php <div id= nd class= nd > <div class= dati > <?php if($submitted);?> <span class= submitted ><?php print $submitted;?></spam> <?php endif?> <div class= titl > <h2><?php print $title;?></h2> <div class= cntenut > <?php print $cntent;?> Anche in quest cas pssiam aggiungere variabili facltative, nel esempi andrem semplicemente a definire l id del cntenitre in base a quell del nd (per le altre variabili vedere appendice A2). <div id= nd-<?php print $title->nid;?> class= nd >

7 Oltre a quest pssiam persnalizzare la stampa di gni variabile, immaginiam di nn vler vedere visualizzati I link in fnd ai nstri cntenuti, andrem a mdificare l script cme segue: <div class= cntenut > <?php hide ($cntent[ links ] );?> <?php print $cntent;?> Nell stess md pssiam decidere di reinserirli in seguit scrivend: <?php print render ($cntent[ links ] );?> blck.tpl.php, cmment.tpl.php e regin.tpl.php Spend semplicemente due parle per questi file, dicend che si ccupan dell impaginazine rispettivamente dei blcchi, dei cmmenti e delle regini; e che struttura e funzinalità sn del tutt simili al nde.tpl.php quindi anche il prcediment per creare questi file è il medesim. Trvate tutte le lr funzini nell appendici (blck.tpl.php : Appendice A3, cmment.tpl.php: Appendice A4; regin.tpl.php: Appendice A5).

8 Appendice A1 Variabili che è pssibile inserire nel file page.tpl.php Variabili Generali: $base_path: la URL di base (il percrs dell installazine Drupal) $directry: La directry in cui si trva il tema $is_frnt: TRUE se la pagina crrente è la hme $lgged_in: TRUE se l utente è registrat $is_admin: TRUE se l utente è un amministratre Identità del sit: $frnt_page: l URL della pagina $lg: il percrs per l immaigne del lg. Cme definite nella cnfigurazine del tema. $site_name: Il nme del sit. $site_slgan: L slgan del sit. Navigazine: $main_menu (array): Un Array cntenente I link del menu principale del sit, se sn stati cnfigurati. $secndary_menu (array): Un Array cntenente I link del menu secndari del sit, se sn stati cnfigurati. $breadcrumb: Il fil di Arianna per la pagina crrente. Cntenut della pagina: $title_prefix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate PRIMA del tag titl principale che appare nel tema. $title: Il titl della pagina. $title_suffix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate DOPO del tag titl principale che appare nel tema. $messages: HTML per I messaggi di stat di errre. $tabs (array): Schede cllegament a qualsiasi pagine secndarie stt la pagina crrente (ad esempi, la visualizzazine e la mdifica schede quand la visualizzazine di un nd).

9 $actin_links (array): Azni lcali per la pagina (ad esempi il link aggiungi sul menu interfaccia amministrativa). $feed_icns: la stringa e la feed-icn della pagina crrente. $nde: L'ggett del nd, se c'è un nd autmaticamente caricat assciat alla pagina, e l'id del nd è il secnd argment nel percrs della pagina (ad es nde/12345 e nde/12345/revisins, ma nn cmment / rispsta / 12345).Regins: Regini: $page['help']: Dynamic test di aiut, sprattutt per le pagine di admin. $page['highlighted']: Items per il cntenut evidenziat della regine. $page['cntent']: il cntenut principale della pagina crrente. $page['sidebar_first']: Items per la regine first sidebar (di default quella a sinistra). $page['sidebar_secnd']: Items per la regine secnd sidebar (di default quela a destra). $page['header']: Items per la regine header. $page['fter']: Items per la regine fter.

10 Appendice A2 Tutte le variabili che è pssibile inserire in nde.tpl.php Variabili Generali: $title: titl del nd. $cntent: il cntenut. Usare render($cntent) per stampare tutt il cntenut, ppure render($cntent['field_example']) per stampare sl la parte desiderata. Usare hide($cntent['field_example']) per nn stampare la parte indicata $user_picture: L immagine dell autre del nd da user-picture.tpl.php. $date: data. Preprcess functins: si può rifrmattare la data usand: frmat_date() cn I parametri desiderati. $name: username dell autre del nd da theme_username(). $nde_url: url dirett al nd crente. $display_submitted: Se le infrmazini di presentazine devn essere visualizzate. $submitted: infrmazini di presentazine: creat da: $name creat il: $date da template_preprcess_nde(). $classes: stringa di classi che pssn essere utilizzate per l stile tramite CSS. Può essere maniplati in Preprcess tramite la funzine: $classes_array. I valri di default pssn essere un più dei seguenti: nde: tip di mdell crrente nde-[type]: Il tip di nd crrente. Ad esempi, se il nd è un "blg " che si tradurrebbe in "nd-blg". Si nti che il nme della macchina sarà spess in una frma breve del marchi leggibile. nde-teaser: I ndi in frma teaser. nde-preview: I ndi in mdalità anteprima. I valri seguenti dipendn dale pzini di publicazine del nd. nde-prmted: Ndi prmssi in prima pagina. nde-sticky sticky: Ndi rdinati spra gli altri ndi nn-sticky, nelle inserzini teaser. nde-unpublished: Ndi nn pubblicati visibili sl all amministratre. $title_prefix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate PRIMA del tag titl prncipale che appare nel mdell. $title_suffix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate DOPO del tag titl prncipale che appare nel mdell.

11 Altre variabili: $nde: Inter ggett, cntiene tutti I dati del nd, maneggiare cn cura, cntiene anche infrmazini che ptrebber nn essere sicure. $type: Tip di nd (stria, pagine, blg, ecc. ) $cmment_cunt: Numer di cmmenti al nd. $uid: User ID dell autre del nd. $created: Time the nde was published frmatted in Unix timestamp. $classes_array: Array dei valri di attribute HTML class. Inserit in una stringa all itenrn della variabile $classes. $zebra: restituisce alternativamente even dd, utile nelle inserzini teaser. $id: Psizine del nd. Variabili dell stat del nd: $view_mde: Mdalità di visualizzazine, esempi: 'full', 'teaser'... $teaser: Flag per teaser $page: Flag per full page $prmte: Flag per frnt page prmtin $sticky: Flags per sticky pst $status: Flag per published status $cmment: Stat dell impstazini cmmenti per il nd $readmre: Restituisce true se il cntenut del teaser del nd nn può cntenere il cntenut principale del crp. $is_frnt: Restituisce true se è presente in hme $lgged_in: Restituisce true se l utente è lggat $is_admin: Restituisce true se se l utente è l amministratre

12 Appendice A3 Tutte le variabili che è pssibile inserire in blck.tpl.php Variabili Generali: $title: il titl del blcc. $cntent: Il cntenut principale del blcc. $blck->mdule: il mdul che ha generat il blcc. $blck->delta: un ID per il blcc, unic all intern di gni mdul. $blck->regin: la regine che incrpra il blcc attuale. $classes: stringa di classi che pssn essere utilizzate per l stile tramite CSS. Può essere maniplati in Preprcess: blck: tip di mdell crrente blck-[mdule]: il tip di mdell crrente. first: il prim blcc nella regine. last: l ultim blcc nella regine. dd: blcchi dispari nella regine. even: blcchi pari nella regine. $title_prefix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate PRIMA del tag titl prncipale che appare nel mdell. $title_suffix (array): Un array cntenente infrmazini aggiuntive destinate ad essere visualizzate DOPO del tag titl prncipale che appare nel mdell. Variabili Generali: $classes_array: Array dei valri di attribute HTML class. Inserit in una stringa all itenrn della variabile $classes. $blck_zebra: restituisce alternativamente even dd a tutti i blcchi di una regine. $blck_id: Cntatre dei blcc dipendente per regine. $ id: Cntatre dei blcc indipendente da qualsiasi regine. $is_frnt: Restituisce true se è presente in hme $lgged_in: Restituisce true se l utente è lggat $is_admin: Restituisce true se se l utente è l amministratre $blck_html_id: un cdice HTML valid ID e sicuramente unic.

13 Un esempi: <div id="<?php print $blck_html_id;?>" class="<?php print $classes;?>"> <?php if ($title):?> <h2><?php print $title;?></h2> <?php endif;?> <div class="cntenut"> <?php print $cntent;?>

14 Appendice A4 Tutte le variabili che è pssibile inserire in cmment.tpl.php $authr nme dell'autre cllegat al su prfil se ne ha un. $cmment l'ggett del cmment cntenente tutti i sui attributi. $cntent il crp del cmment. $date la data di creazine del cmment. $directry la directry in cui si trva il tema crrente, es. themes/garland r themes/garland/minelli. $id l'id numeric del cmment. $is_frnt questa variabile è vera (true) se ci si trva nell'hmepage. $links links cntestuali al cmment. $new se il cmment è nuv, mstra il test "New". $picture Ft avatar dell'utente linkata al prfil dell'utente stess. La funzine deve essere abilitata nei settings del tema e degli users, e l'utente deve prima inserire un'immagine. $submitted "scritt da" + nme dell'autre e data di creazine. $title titl ipertestuale del cmment. $zebra questa variabile alterna even/dd di cmment in cmment (utile per theming avanzat).

15 Appendice A5 Tutte le variabili che è pssibile inserire in regin.tpl.php $authr: Cmment authr. Can be link r plain text. $cntent: An array f cmment items. Use render($cntent) t print them all, r print a subset such as render($cntent['field_example']). Use hide($cntent['field_example']) t temprarily suppress the printing f a given element. $created: Frmatted date and time fr when the cmment was created. Preprcess functins can refrmat it by calling frmat_date() with the desired parameters n the $cmment->created variable. $changed: Frmatted date and time fr when the cmment was last changed. Preprcess functins can refrmat it by calling frmat_date() with the desired parameters n the $cmment->changed variable. $new: New cmment marker. $permalink: Cmment permalink. $submitted: Submissin infrmatin created frm $authr and $created during template_preprcess_cmment(). $picture: Authrs picture. $signature: Authrs signature. $status: Cmment status. Pssible values are: cmment-unpublished, cmmentpublished r cmment-preview. $title: Linked title. $classes: String f classes that can be used t style cntextually thrugh CSS. It can be manipulated thrugh the variable $classes_array frm preprcess functins. The default values can be ne r mre f the fllwing: cmment: The current template type, i.e., "theming hk". cmment-by-annymus: Cmment by an unregistered user. cmment-by-nde-authr: Cmment by the authr f the parent nde. cmment-preview: When previewing a new r edited cmment. The fllwing applies nly t viewers wh are registered users: cmment-unpublished: An unpublished cmment visible nly t administratrs. cmment-by-viewer: Cmment by the user currently viewing the page. cmment-new: New cmment since last the visit. $title_prefix (array): An array cntaining additinal utput ppulated by mdules, intended t be displayed in frnt f the main title tag that appears in the template.

16 $title_suffix (array): An array cntaining additinal utput ppulated by mdules, intended t be displayed after the main title tag that appears in the template. These tw variables are prvided fr cntext: $cmment: Full cmment bject. $nde: Nde bject the cmments are attached t. Other variables: $classes_array: Array f html class attribute values. It is flattened int a string within the variable $classes. Un esempi: <?php if ($cntent):?> <div class="<?php print $classes;?>"> <?php print $cntent;?> <?php endif;?>