4. Come fare semplici personalizzazioni
Document Actions
Capitolo 4: Come fare semplici personalizzazioni
- Amministrare siti
- Personalizzare l'aspetto di Plone
- Comprendere i Portlet
- Modifica del portlet di navigazione
- Sito web del Plone Book: modifica della navigazione
- Modificare il formato delle date
- Aggiungere parole chiave e tipi d'evento
- Cambiare la pagina predefinita
- Come fare affinché l'elenco delle notizie sia la pagina predefinita?
- Modificare le schede del sito
- Modificare le immagini e il CSS
Dopo aver visto come aggiungere e modificare i contenuti, potremmo desiderare di personalizzare il nostro sito. Questo capitolo spiega come eseguire delle semplici personalizzazioni in Plone utilizzando le opzioni a disposizione degli amministratori. Per eseguire le personalizzazioni in questo capitolo è necessario essere un utente autenticato con il ruolo di manager, come discusso nel capitolo 2.
Queste personalizzazioni sono tutte opzioni di configurazione che possono venir fatte da Web. Piuttosto che spiegarle tutte in dettaglio, questo capitolo da una panoramica su alcuni argomenti, e spiega come compiere certi compiti mostrando parte del meccanismo che ci sta sotto. Questi concetti saranno ampliati e spiegati nei seguenti capitoli del libro.
Il primo posto in cui guardare, e anche il più utile, è il pannello di controllo di Plone, che offre varie possibilità per l'amministrazione del sito. Tutte i componenti di un sito Plone sono studiati per essere facilmente modificati e personalizzati; le linguette blu che puoi osservare nella parte alta della pagina possono essere facilmente aggiunte e rimosse. Un altro esempio sono i box nelle colonne di sinistra e destra, che sono chiamati portlets. Plone ha molti portlets, ed è possibile con facilità scegliere quali visualizzare.
In ultimo, questo capitolo spiega come personalizzare i fogli di stile a cascata (CSS: Cascading Style Sheets) e le immagini in Plone. I CSS influiscono su tutto in un sito Plone. In effetti, come vedrai in questo capitolo, i CSS determinano tutti i colori, le posizioni, e molte delle immagini che vedi. Se sei in grado di modificare il codice CSS, allora puoi cambiare quasi tutto l'intero look and feel del tuo sito Plone. Tutte le opzioni considerate in questo capitolo mostrano l'alto livello di controllo che puoi avere suo tuo sito Plone.
Amministrare siti
Il primo posto che deve essere visitato dagli amministratori del sito è il pannello di controllo di Plone. È il modo per accedere ad alcune delle funzioni del sito, inclusi il nome e la descrizione del tuo sito Plone, l'amministrazione degli utenti e dei gruppi, e la visualizzazione degli errori eseguiti dal tuo sito.
Il termine pannello di controllo è generico, e non deve essere confuso con il pannello di controllo della Zope Management Interface (ZMI), che mostra le opzioni a basso livello della ZMI. Il pannello di controllo di Plone è più un continuo tentativo di fornire un'interfaccia amichevole alle funzioni offerte dalla ZMI. Poiché il progetto è in sviluppo, è difficile predire quali funzionalità vi verranno incluse in futuro. Piuttosto ti raccomandiamo di andare al pannello di controllo e vedere quali funzioni sono correntemente disponibili; se non c'è l'opzione che ti serve sarai costretto ad andare nella ZMI.
Per accedere al pannello di controllo, autenticati in Plone come utente con il ruolo di manager. Se non hai un utente con questo ruolo ma sei un amministratore del sito, consulta il capitolo 9 per avere informazioni su come fare. Se non sei un amministratore e vuoi questo livello di accesso, devi chiedere all'amministratore del tuo sito. Per accedere al pannello di controllo, clicca plone setup in alto nella pagina (vedi figura 4-1).
Figura 4-1. Accedere al pannello di controllo
Questa operazione aprirà il pannello di controllo (vedi figura 4-2)
Figura 4-2. Il pannello di controllo di Plone
Nel pannello di controllo sono disponibili le seguenti funzioni:
- Inserimento/rimozione di prodotti
- Questo link permette di automatizzare l'installazione di prodotti (come spiegato dettagliatamente nel capitolo 10).
- Registro degli errori
- Questo link permette di accedere la log degli errori occorsi durante l'esecuzione del sito Plone.
- Impostazioni Mail
- Questo link permette di modificare l'indirizzo SMTP (Simple Mail Transfer Protocol) che Plone utilizza per inviare e-mail.
- Impostazioni del portale
- Questo link permette di modificare le impostazioni del portale (come discusso nella sezione Cambiare titolo, descrizione, e indirizzo e-mail di questo capitolo).
- Skin
- Questo link permette di impostare lo skin corrente (come spiegato nel capitolo 7).
- Amministrazione utenti e gruppi
- Questo link permette di modificare utenti e gruppi (come spiegato nel capitolo 8).
- Interfaccia di gestione Zope
- Questo link ti porta alla ZMI.
Attraverso il resto del libro, farò riferimento al pannello di controllo di Plone, se starò parlando di una funzionalità accessibile da esso; il resto del libro userà invece la ZMI per le modifiche alle proprietà del sito.
Cambiare titolo, descrizione, e indirizzo e-mail
Il titolo, la descrizione e l'indirizzo e-mail di un sito Plone vengono memorizzati come proprietà di un oggetto nel sito stesso. Puoi accedere a questi campi cliccando il link Portal Settings nel pannello di controllo di Plone (vedi figura 4-3).
I settaggi del portale sono i seguenti:
- Titolo del portale
- è il titolo del sito che appare nel titolo del browser, nel breadcrumbs, nella navigazione, nelle e-mail, e così via. Per default è Portal.
- Descrizione del portale
- è la descrizione del portale, usata per ora solo nelle syndication.
- Nome del mittente usato per la posta inviata dal portale
- questo campo si riferisce a varie funzioni, come la funzione per il recupero della password dimenticata o la funzione 'segnala ad un amico'. Per default è Portal Administrator.
- Indirizzo del mittente usato per la posta inviata dal portale
- è l'indirizzo del mittente delle e-mail inviate da Plone. Per default è postmaster@localhost.
- Lingua di default
- è la lingua di default, data nelle proprietà di un oggetto (??).
- Politica delle password
- i nuovi utenti hanno due possibilità; possono o inserire una password, o inserire una password che gli verrà recapitata per e-mail (??). In entrambi i casi sono tenuti ad inserire un indirizzo e-mail, la seconda opzione assicura che l'indirizzo e-mail sia valido.
- Abilita la funzionalità External Editor
- questa opzione abilital'External Editor, uno strumento avanzato per l'editing. Richiede che l'External Editor sia istallato sul computer dell'utente. Il capitolo 10 lo spiega più in dettaglio.
Dopo aver selezionato le opzioni desiderate, clicca su Save per confermarle. Tutte le modifiche effettuate da questa maschera saranno subito attive.
Figura 4-3. Opzioni del portale
Impostare un Mail Server
Plone invia e-mail utilizzando l'oggetto MailHost, che fornisce un'interfaccia ad un server SMTP e permette agli sviuppatori Plone di scrivere form e strumenti per l'invio di e-mail. La funzione 'invia ad un amico' e l'invio e-mail in caso di password dimenticata usano le impostazioni configurate qui.
La configurazione di default è impostata su un mail server su localhost alla porta 25. Se il server SMTP si trova altrove in rete, puoi accedere a questa impostazione cliccando su plone setup e poi su Mail Settings. A questo punto è possibile cambiare il mail server e la porta affiché riflettano la tua configurazione. Sulla mia rete, il mail server è monty.clearwind.ca sulla porta 1025, cosicché ho impostato il server come mostrato in figura 4-4; tuttavia, in molti casi, non avrai bisogno di modificare quest'impostazione.
Figura 4-4. Impostazioni del mail server
Nota
L'oggetto MailHost è un oggetto Zope accessibile dalla ZMI. Questo oggetto non necessita attualmente di autenticazione sul server. Se ce n'è bisogno, cambia le impostazioni sul server.
Registrazione degli errori
Il registro degli errori (error log) cattura gli errori generati da un sito Plone; ci sono caratteristiche come gli errori di Pagina non trovata (404), errori di mancata autorizzazione, e così via. Non è stato studiato per intercettare gli errori dalle form. Se per caso qualcuno non inserisce un valore richiesto nel campo di una form, questo non verrà riportato; questo non viene considerato errore fintanto che non è catturato dal framework di validazione. Questo errore log è studiato per intercettare gli errori interni del server.
Dall'interfaccia di Plone clicca su Plone Setup e poi su Error Log, per visualizzare gli errori riportati dal sito Plone. Clicca sull'eccezione nella lista (se ce n'è almeno una) per visualizzare l'errore. La figura 4-5 mostra un errore capitato compilando erroneamente la form delle impostazioni mail. È una pagina lunga, che include un traceback Python completo e la request ricevuta.
Figura 4-5. Un esempio di errore
Questi sono le impostazioni per la form dell'error log:
- Numero delle eccezioni di cui tenere traccia
- Il numero di eccezioni da tenere a video nel registro. Per default sono 20.
- Copia le eccezioni nel registro degli eventi
- Consente di copiare ogni eccezione in un file di log basato su un file fisico. Disabilitare questa opzione significa che non verrà tenuta traccia permanente delle eccezioni. Per default questa opzione è attivata.
- Tipi di eccezione ignorati
- È una lista (una per riga) di tipi di eccezioni da ignorare. Per default sono ignorati Unauthorized (accesso alla risorsa non autorizzato), NotFound (risorsa non trovata), e Redirect.
Puoi registrare ogni eccezione e visualizzarla a video. Ciò significa che se mentre un utente sta visitando il tuo sito viene generato un errore, puoi di seguito andare alla pagina dell'error log e vedere cosa è successo. I tre componenti di un errore sono l'error type (ovvero il tipo di errore), l'error value (che è una stringa che spiega quando questo tipo di errore capita), e il traceback. I primi due vengono visualizzati al'utente su una pagina standard di errore (vedi figura 4-6).
Figura 4-6. Un esempio di messaggio di errore
Quindi, se un utente riporta un errore, il registro spesso includerà un messaggio con il nome dell'errore e il suo valore. Se l'utente non ha avuto il permesso di compiere una determinata azione e quindi è stato generato un errore Unauthorized, oppure è stata raggiunta una Pagina non trovata (404), allora verrà presentata una una pagina di errore personalizzata piuttosto che quella standard mostrata in figura 4-6. Questi sono i tipi standard di errore:
- Unauthorized
- Accade quando un utente non ha i privilegi per eseguire una funzione.
- NotFound
- Quando l'elemento richiesto da un utente non esiste.
- Redirect
- È un errore causato da un redirect HTTP (HyperText Transfer Protocol).
- AttributeError
- Quando un oggetto non ha l'attributo richiesto, viene generato questo errore.
- ValueError
- Accade quando un valore dato è incorretto, e non può essere gestito correttamente dalla validazione o da qualche altro framework.
Personalizzare l'aspetto di Plone
La sezione seguente descrive le altre personalizzazioni che possono essere fatte ad un sito; qusi tutte richiedono l'accesso alla ZMI.
Comprendere i Portlet
In un sito Plone, vengono visualizzare per default tre colonne: la colonna di sinistra, la centrale, e quella di destra. La colonna centrale ospita il contenuto dell'oggetto correntemente visualizzato. È il posto dove risiedono la maggior parte delle funzionalità utente per l'aggiunta e la modifica di contenuti, la compilazione delle form, e così via. Le colonne di sinistra e destra contengono invece una serie di box che mostrano informazioni. Ognuno di quest box è chiamato portlet. Una variabile definisce che portlet devono essere mostrati in un certo momento. Il modo migliore per capire i portlet è guardare come funzionano i portlet forniti di default con Plone. I parametri dei portlet si trovano nell'oggetto portal. Per accedervi, entra nella ZMI, assicurati di essere sulla root del sito Plone, e clicca sul tab delle proprietà. Verrà aperta una lista di proprietà, incluse left_slots, right_slots, e document_action_slots (vedi figura 4-7).
Nota
Nelle precedenti versioni di Plone i portlet si chiamavano slot. È un termine comune che causa confusione con il termine slot usato nei page template, così è stato sostituito con portlet nella versione 2. In alcuni punti del codice o ne testo potresti imbatterti nel termine slot. In questo contesto le parole slot e portlet sono da considerare sinonimi.
Figura 4-7. Le proprietà del portlet di default
La proprietà left_slots fa riferimento ai portlet mostrati nella parte sinistra della pagna, mentre right_slots si riferisce ai portlet della parte destra. I portlet sono visualizzati nell'ordine in cui sono inseriti nella proprietà, dall'alto verso il basso; da notare che ogni portlet occupa una riga. Tuttavia, moti portlet hanno al loro interno del codice che assicura che il portlet venga visualizzato solo quando ha senso che lo sia. Per esempio, è superfluo che il portlet per il login venga visualizzato se l'utente si è già autenticato. In questo caso, anche se il portlet logi è incluso nella lista dei portlet, esso viene mostrato solo quando c'è bisogno.
Il valore di ogni portlet è uno speciale valore che rappresenta il percorso di un'espressione Template Attribute Language Expression Syntax (TALES). Gli sviluppatori possono aggiungere i loro portlet personalizzati al sito, creando semplici macro e page tempate. I portlet di default sono i seguenti:
- left_slots
- Include i portlet navigation, login, e related (tradurre?).
- right_slots
- Include i portlet review, news, events, recently published, e calendar.
Per default non sono configurati in Plone tutti i portlet disponibili. La sezione seguente descrive uno per uno i portlet in Plone, e mostra come si presentano. Quindi verrà mostrata l'espressione percorso (come tradurre?) che deve essere aggiunta alla proprietà slots affinché vengano visualizzati.
Per esempio, per mostrare il portlet del calendario a sinistra, basta inserire here/portlet_calendar/macros/portlet nella proprietà left_slots e cliccare su Save Changes. Per rimuoverlo dalla proprietà right_slots, è sufficiente rimuovere la stessa riga dalla proprietà e cliccare su Save Changes.
Calendario
Il portlet calendario è uno dei portlet di default, che mostra il calendario alla destra della pagina di Plone. Questo portlet mostra gli eventi pubblicati nel mese visualizzato in un piccolo calendario. Il portlet calendario viene visualizzato indipendentemente dalla presenza di eventi da visualizzare. Puoi configurare il calendario usando il tool portal_calendar nella ZMI (vedi figura 4-8).
Figura 4-8. Il portlet calendario
L'espressione da aggiungere è here/portlet_calendar/macros/portlet.
Eventi
Il portlet eventi mostra la lista degli eventi imminenti pubblicati. Anche se abilitato inserendolo nella lista, questo portlet non apparirà fin tanto ché non ci saranno degli eventi pubblicati da mostrare (vedi figura 4-9).
Figura 4-9. Il portlet eventi
L'espressione da aggiungere è here/portlet_events/macros/portlet.
Favoriti
Nell'angolo in alto a destra di un documento Plone puoi vedere un icona con il logo di Plone. Un utente può cliccare questo logo per aggiungere un elemento ai favoriti. Il concetto di favorito è molto similare al concetto di segnalibro o link alle pagine alla quale vuoi in futuro ritornare; La differenza consiste nel fatto che questo favorito viene memorizzato nel sito Plone. La figura 4-10 mostra l'icona per aggiungere un favorito.
Figura 4-10. L'icona per aggiungere un elemento ai favoriti
I favoriti vengono aggiunti alla cartella home dell utente, e in seguito mostrati nel portlet favoriti assieme ad un link per organizzarli (vedi figura 4-11). I favoriti mostrati sono i favoriti che l'utente ha memorizzato, quindi, anche se abilitato, questo portlet si mostrerà solo se l'utente ha qualche registrato in precedenza qualche favorito.
Figura 4-11. Il portlet favoriti
L'espressione da aggiungere è here/portlet_favorites/macros/portlet.
Fatti riconoscere
Il portlet login mostra il form per il login, consentendo ad un utente di autenticarsi fornendo username e password. Se la password è stata dimenticata, c'è un'opzione che consente di farsela inviare per e-mail. Anche se abilitato, questo portlet non verrà visualizzato se l'utente si è già autenticato (vedi figura 4-12).
Figura 4-12. Il portlet login
L'espressione da aggiungere è here/portlet_login/macros/portlet.
Navigazione
Il portlet di navigazione mostra una semplice struttura ad albero delle cartelle nella posizione corrente. Fornisce uno strumento comodo e semplice per la navigazione. Questo portlet è estremamente personalizzabile; scegliendo dalla ZMI portal_properties e poi navtree_preperties, poi accedere a delle modifiche che saranno spiegate nella sezione Modifica del portlet di navigazione (vedi figura 4-13).
Figura 4-13. Il portlet navigazione
L'espressione da aggiungere è here/portlet_navigation/macros/portlet.
Ultime notizie
Il portlet news mostra una lista di link alle news recenti (vedi figura 4-14). Anche se abilitato, questo portlet verrà mostrato solo in presenza di news pubblicate. Le news di un sito sono ancre raggiungibili cliccando sul tab news.
Figura 4-14. Il portlet news
L'espressione da aggiungere è here/portlet_news/macros/portlet.
Modifiche recenti
Il portlet degli elementi recenti elenca gli elementi di recente pubblicazione, a partire dall'ultima volta che l'utente si è autenticato (vedi figura 4-15). Se non ci sono elementi di questo tipo, allora il portlet non viene mostrato.
Figura 4-15. Il portlet modifiche recenti
L'espressione da aggiungere è here/portlet_recent/macros/portlet.
Inerenti
Il portlet dei relativi mostra la lista degli elementi correlati all'elemento che si sta visualizzando, come determinato dalle parole chiave ad esso associate. Se l'elemento correlato è un link ad un altro sito web, verrà mostrato in una lista separata delle risorse esterne al sito. Anche se abilitato, quaso portlet verrà visualizzato sono se sono presenti elementi relativi da mostrare (vedi figura 4-16).
Figura 4-16. Il portlet relativi
L'espressione da aggiungere è here/portlet_related/macros/portlet.
Da esaminare
Il portlet revisione mostra la lista degli elementi nello stato di revisione e che sono in attesa di essere revisionati. Viene mostrato solo se l'utente autenticato ha il ruolo di revisore e se ci sono elementi in attesa di revisione (vedi figura 4-17).
Figura 4-17. Il portlet revisione
L'espressione da aggiungere è here/portlet_review/macros/portlet.
Sito web del Plone Book: modifica degli slot
Molti degli slot sulla parte destra non hanno senso per il sito Plone Book. Questo libro non ha eventi, quindi il calendario non serve. Mi aspetto che vengano ancora aggiunte delle cose al sito, ma saranno veramente cose minime fino al completamento del sito. Ho deciso quindi di rimuovere completamente tutti gli slot di destra dal mio sito. Per ottenere ciò sono andato alla root del portale attra verso la ZMI, e ho cliccato sul tab delle proprietà. Quindi ho cancellato gli slot di destra. I portlet che abitualmente sono ospitati sulla parte destra, navigazione, login, relativi, mi sono tutti utili, così li ho tenuti.
Così è come si mostrano a questo punto le proprietà dei portlet per il sito Plone book:
Configurare portlet differenti in parti differenti del sito
Il database Zope che sta alla base di Plone ha una funzionalità chiamata acquisizione. Nella sua forma piu' semplice, significa che quando viene richiesto un elemento, come ad esempio right_slots, Plone ricerca l'oggetto piu' vicino che contiene questa proprietà. In questo modo, cercando quali portlet mostrare nella colonna di destra, normalmente Plone trova l'oggetto radice e considerà la sua proprietà right_slots.
Questo è il motivo per cui puoi cambiare le proprietà nell'oggetto root del portale per cambiare l'intero sito. Si puo' notare pero' che cliccando sul link my folder e andando alla cartella personale, non appare il calendario. Se clicchi su Members e poi su Properties dalla ZMI, noterai che c'è una proprietà right_slots. Per questa cartella questa proprietà è una lista vuota. Quando il sito Plone si mette alla ricerca valore di questa proprietà per quali portlet devono essere presenti nella colonna di destra, si muove lungo la gerarchia di cartelle fino al raggiungimento della cartella Members. Qui trova un valore per right_slots e lo usa. Fintantoché il valore di right_slot nella cartella Members è vuoto, guardando contenuti presenti in Members, gli slot di destra saranno vuoti.
Gli amministratori del sito possono personalizzare la disposizione dei portlet all'interno del sito, aggiungendo e eliminando proprietà delle cartelle attraverso la ZMI. Basta selezionare l'elemento e cliccare sul tab Properties. Per aggiungere la proprietà per gli slot a destra o sinistra, usa la form Add, in fondo alla pagina, e assicurati che il tipo della proprietà sia list.
Modificare il formato delle date
Lungo le portlet di tutto il sito, Plone rappresenta le date in un formato costante, personalizzabile internamente usando i formati. Ogni volta che una data viene mostrata in Plone, viene invocato un formato tra due disponibili. Puoi trovare questi formati accedendo alla ZMI, cliccando portal_properties e poi site_properties. I formati sono questi:
- localTimeFormat
- È il formato da utilizzare per le date che devono apparire in forma compatta.
- localLongTimeFormat
- È il formato da utilizzare per le date che devono apparire nel formato esteso, mostrando anche i secondi.
Il formato delle date è basato sul modulo Python time. Informazioni riguarda a questo formato possono essere trovate all'indirizzo http://www.python.org/doc/current/lib/module-time.html. Per la data compatta, il valore di default è %Y-%m-%d che significa anno-mese-giorno (ndt: in inglese dalle iniziali year-month-day) rappresentati come numeri decimali (ad esempio 2003-10-26). Per il formato esteso, il valore di default è invece %Y-%m-%d %I:%M %p, ovvero anno-mese-giorno ore:minuti am/pm (per esempio, 2003-10-26 07:32 PM).
Ecco un breve sommario delle opzioni disponibili (il nome dei giorni e dei mesi può variare a seconda del Locale del browser):
- %a
- Abbreviazione in lingua locale del giorno della settimana (ad esempio Lun)
- %A
- Il nome locale del giorno della settimana (ad esempio Lunedì)
- %b
- L'abbreviazione locale del nome del mese (ad esempio Gen)
- %B
- Il nome locale del mese (ad esempio Gennaio)
- %d
- Il giorno del mese, rappresentato come numero decimale
- %H
- L'ora (orologio a 24 ore) come numero decimale
- %I
- L'ora (orologio a 12 ore) come numero decimale
- %m
- Il mese come numero decimale
- %M
- I minuti come numero decimale
- %S
- I secondi come numero decimale
- %y
- Le ultime due cifre dell'anno, come numero decimale
- %Y
- L'anno completo, in quattro cifre decimali
Se vuoi includere il nome del giorno nel formato compatto della data, devi semplicemente cambiare il formato della data compatta in %A, %d %b., %Y. L'effetto di questa modifica sarà Lunedì, 20 Set., 2004. Questa data viene usata nei box a destra e a sinistra dello schermo, nel risultati delle ricerche, nei contenuti per linea, e così via.
Aggiungere parole chiave e tipi d'evento
C'è uno strumento in Plone, portal_metadata, che permette all'amministratore del sito di definire alcuni metadati per gli elementi. Plone utilizza i metadati definiti nel tool portal_metadata per parecchio scopi.
Ad esempio, quando inserisci un evento, ti viene proposta una lista di possibilit tipi di evento. Puoi fare aggiunte a questa lista cliccando dalla ZMI su portal_metadata, quindi elements, e poi subject. Vedrai un vocabolario di eventi che elencano gli oggetti per questo content type (...uhm... controllare la frase...). È semplice modificare o integrare questa lista, un elemento per riga, per ottenere i tipi di eventi relativi. Questi tipi di evento appariranno nella machera per l'aggiunta e la modifica di un evento.
Un altro uso del portal_metadata è la selezione delle parole chiave disponibili sul sito. Nella form in portal_metadata/elements/subject, potrai notare un vocabolario per il tipo di contenuto di <default>. Se aggiungi degli elementi nel campo vocabolario di questa pagina e clicchi su Update, li aggiungerai alla lista delle parole chiave disponibili per tutti i tipi di contenuto.
Se vuoi che le parole chiave appaiano, diciamo, solo nei documenti, usa la form add (aggiungi) in fondo alla pagina. Scegli un tipo di contenuti, e aggiungi qualche vocabolo, uno per ogni riga. Questi diverranno parole chiave che gli utenti possono selezionare solo per questo tipo di contenuto.
Se sei autenticato come utente con ruolo di manager o reviewer, cliccando sul tab proprietà di un oggetto nell'interfaccia di Plone, vedrai il box nuova parola chiave per aggiungere parole chiave ad-hoc. Queste non appariranno nel vocabolario portal_metadata, ma appariranno in tutti i tipi di contenuti che gli altri utenti inseriranno.
Cambiare la pagina predefinita
Come già accennato nel capitolo 3, quando un utente visualizza una cartella, gli viene mostrata, se presente, la pagina di default contenuta nella cartella. Nelle vecchie versioni di Zope e Plone, il nome di questa pagina doveva essere index_html. Lo si nota in molti siti Plone, in cui l'indirizzo Web termina con index_html. Se modifichi questo nome di file con un estensione più comunemente riconosciuta, come index.html, sarà più facile modificare questi file con editor o strumenti di sviluppo Web.
In Plone puoi definire un elenco di pagine da prendere in considerazione per essere presentate come pagina di default (vedi figura 4-18). Per default queste pagine sono index_html, index.html, index.htm, e FrontPage. Puoi configurare questa lista in site_properties/portal_properties/default_page property, seguendo la regola di un nome per riga. Quando viene richiesta la pagina di default, Plone va alla ricerca di ogni pagina in questa lista, partendo dalla prima, fino a che non ne incontra una corrispondente. Inoltre, se vuoi cambiare questa impostazione solo per una cartella, puoi accedere a questa tramite la Zmi, cliccare sulla scheda delle proprietà, e aggiungere una nuova proprietà lista chiamata default_page.
Figura 4-18. Rendere index.asp la pagina di default preferenziale
Come fare affinché l'elenco delle notizie sia la pagina predefinita?
Il funzionamento esatto di questo sistema richiede una certa conoscenza del meccanismo sottostante. Per ora, vai semplicemente sulla radice del portale e clicca su Properties. A questo punto, sul fondo della pagina, completa la maschera add new property con queste informazioni, e poi premi il pulsante Add:
Per il campo Name: default_page Per il campo Value: news Per il campo Type: lines
Ora ritorna al sito Plone. Al posto della home page standard vedrai la pagina delle news. Anche la scheda delle news riporta alla pagina delle news, ma nella prossima sezione ti mostrerò come rimuoverlo.
Modificare le schede del sito
In un sito Plone le varie schede si riferiscono a differenti sezioni o parti del sito. L'uso delle schede è un concetto familiare nel design dei siti Web, ed è comune in siti tipo Amazon, MSN, e Plone stesso.
Esistono due tipi principali di schede: le schede di portale e le schede di contenuto. Le schede di portale sono blu e appaiono in alto nel sito Plone. Quelle di default sono home, news e member. La sezione che segue mostra come personalizzarle. Le schede di contenuto sono verdi, e appaiono quando un elemento può essere modificato. Le schede di contenuto, come il nome steswso suggerisce, sono relative al contenuto. Il capitolo 11 spiega come modificarle. Le schede in un sito Plone sono costruite a partire da una collezione di azioni quindi, per capire come modificarle, è necessaria una panoramica veloce sulla azioni.
Introduzione alle azioni
In Plone ci sono persone che possono compiere azioni differenti, in momenti differenti o in parti differenti del sito. Queste azioni vengono chiamate actions. Plone le traduce in schede, link, ed elementi di altri generi. C'è un metodo altamente configurabile per produrre questi elementi di navigazione per un sito.
Ogni azione ha le seguenti proprietà configurabili nella ZMI. Dove configurarle dipende da dove queste azioni sono immagazzinate. Qui c'è una lista delle proprietà per un'azione di default:
- Name
- È il nome amichevole dato all'azione. Spesso questo nome viene utilizzato nell'interfaccia. Per esempio, se questa azione sarà utilizzata come scheda, questo nome sarà quello che comparirà come testo nella scheda.
- Id
- L'identificativo univoco dell'azione.
- Actions
- Questa è l'azione vera e propria che deve essere compiuta. Ad esempio, se è un'azione per una scheda, l'azione usata sarà un link. Questo campo è un'espressione TALES (vedi il capitolo 5 per maggiori informazioni).
- Condition
- È la condizione che deve essere verificata affinché l'azione possa essere compiuta. Ad esempio, usandola come scheda, se questa condizione è verificata, allora lascheda viene visualizzata. Il campo contiene un'espressione TALES(vedi il capitolo 5 per maggiori informazioni).
- Permission
- Il permesso che l'utente deve possedere per avere questa azione. Questo permesso deve coincidere affinché l'azione possa essere compiuta (vedi il capitolo 9 per informazioni sulla sicurezza).
- Category
- In questo modo le azioni vengono categorizzate. In Plone questo metodo viene utilizzato per distinguere le azioni e poterle utilizzare in differenti contesti dell'interfaccia utente. Per le schede del portale questa categoria corrisponde a portal_tabs.
- Visible
- Indica se la categoria è attiva. Poiché perloppiù ci si riferisce ad elementi visibili, è stato usato il termine visible.
Introduzione alle schede principali
Nella sezione seguente modificherai come esempio le schede principali seguendo due vie differenti. Cambierai il testo della scheda portale in benvenuto, e sposterai la scheda dei collaboratori a sinistra della scheda notizie. Le azioni per le schede del portale sono immagazzinate nel tool portal_action, quindi per modificarle clicka su portal_action dalla ZMI. Come mostrato in figura 4-19, verrà aperta una lunga lista di azioni presenti di default. Ancune di queste ti sembreranno famigliari, poiché rappresentazno parti del sito Plone.
Figura 4-19. Le azioni sul portale di un sito Plone
Scendi attraverso le azioni, fino a trovare l'elemento Home, e cambia il suo nome in benvenuto. Quindi scendi sino al fondo della pagina, e clicka su Save. Ritornando all'interfaccia di Plone, noterai che ora sulla scheda c'è scritto benvenuto.
L'ordine delle schede da sinistra verso a destra ricalca l'ordine nell delle azioni dall'alto verso il basso. Quindi, mmuovere una scheda è solo questione di selezionarla attraverso il checkbox, scendere fino al fondo della pagina, dove sono presenti i pulsanti Move Up e Move Down, per spostare rispettivamente la scheda verso l'alto o verso il basso della lista. Può essere un pò tedioso, ma continuando a selezionare l'azione e cliccando sui pulsanti Move Up e Move Down, puoi modificare l'completamente ordine delle schede. Fatto ciò, puoi tornare al portale e notare come ora le schede appaiano nel nuovo ordine.
Perché il testo viene messo in minuscolo?
Plone cambia in minuscolo (attraverso i fogli di stile) i testi di molte parti del sito attraverso, come ad esempio le schede. Per disabilitare questa opzione è sufficiente modificare il foglio di stile, come spiegato più avanti in questo capitolo, nella sezione 'Modificare le immagini e il CSS'.
Modificare l'icona di un documento
Guardando un elenco di link o opzioni in un sito Plone, è facile che questo elenco sia prodotto da una serie di azioni. Se non si tratta di azioni, si tratta di codice, ma molte delle funzionalità dell'interfaccia di Plone sono generate dinamicamente attraverso settaggi della ZMI. Altri due esempio di azioni sono le azioni del documento, e le azioni del sito.
Le azioni del sito appaiono nell'angolo in alto a destra e sono i link per cambiare la grandezza del testo. These links could be anything but just happen to reference some client-side script functions. Questi link sono nuovamente configurati in portal_actions, sono solo azioni appartenenti ad una differente categoria. Se dai un'occhiata a portal_actions, noterai tre azioni in fondo alla pagina. Hanno come categoria site_actions. Per rimuoverle è sufficiente deselezionare l'opzione Visible. Le icone derivano dallo strumento portal_actionicons, che è una altro semplice strumente delegato a mappare le icone alle azioni. Guardando portal_actionicons, puoi notare che normal_text di site_actions corrisponde ad un'icona (vedi figura 4-20).
Figura 4-20. Site actions
Similmente, le azioni per il documento presenti in portal_action appartengono alla categoria document_actions. Anche in questo caso, editando queste azioni puoi modificarne l'ordine, le icone, il testo, e aggiungere o rimuovere icone dall'interfaccia.
Modificare le immagini e il CSS
Il look and feel di un sito Plone è un grosso argomento che si porta via tre capitoli, i capitoli 5, 6, e 7. La prossima sezione ne copre le basi, e piuttosto di tentare di spiegare tutto, mostra solo come fare velocemente alcune modifiche.
Uno skin è una serie di CSS, immagini, template, e script che collaborano per creare il look and feel di Plone. L'idea alla base dello skin è che puoi lo modificare cambiando in questo modo l'aspetto del sito, senza doverne toccare i contenuti.
Modificare lo skin
Lo skin di default può essere cambiato usando il form dello skin accessibile dal pannello di controllo. Puoi rappresentare il sito Plone in modi differenti, applicando diverse combinazioni di colori, fogli di stile, template.
La form dello skin ha queste tre scelte:
- Aspetto di default
- E' lo skin di default da presentare all'utente quando questi accede al sito. Solo uno skin viene fornito di default, il Plone Default.
- Consenti ai collaboratori di scegliere l'aspetto del portale
- Questa opzione decide se dare agli utenti la possibilità di scegliere lo skin che preferiscono. Con questa opzione abilitata, un utente può andare nelle sue preferenze e scegliere un altro skin. Per default questa opzione è abilitata.
- Persistenza dello Skin nel Cookie
- Se un utente può scegliersi lo skin, questa opzione fa in modo che questa scelta venga mantenuta anche ai suoi successivi accessi, mandanendo l'informazione nel cookie. Per default è disabilitata.
Una volta scelte le opzioni che desideri, bisogna premere Save per renderle effettive. Per aumentare le performance del sito, conviene usare la cache per le immagini e i fogli di stile. Per essere sicuro di guardare la nuova skin come dovrebbe, cancella la cache del browser (in Internet Explorer dovrebbe essere sufficiente premere Ctrl+F5).
Impostare un logo differente
Cambiare il logo in un sito Plone è un'operazione semplice, ma i passi possono creare un pò di confusione, quindi devono essere seguiti attentamente.
Per prima cosa è necessario accedere alla ZMI, cliccare su portal_skins, poi su plone_images, e infine su logo.jpg. Si aprirà una pagina corrispondente a questo oggetto. Dovrebbe assomigliare alla figura 4-21.
Figura 4-21. Il logo di default
Questo oggetto rappresenta il logo, così come viene visto in Zope. Nella figura 4-21 si vedono le informazioni riguardanti l'immagine, le sue dimensioni, e la posizione all'interno del file system. A metà pagina c'è il pulsante Customize (personalizza); clickalo. Verrà creata una copia dell'oggetto chiamata logo.jpg nella cartella custom (vedi figura 4-22).
Nota
- Se a questo punto appare un messaggio d'errore del tipo
- bad request, torna in in portal_skins/custom, e vedrai che c'è già un oggetto chiamato logo.jpg. Clicka su questo oggetto. Può esserci un solo oggetto chiamato logo.jpg nella cartella custom; l'errore mostrato è un avvertimento che l'operazione di personalizzazione di questo oggetto è già stata eseguita. Se vuoi personalizzare l'oggeto originale (in parole povere, ripetere questi passi), basta cancellare l'oggetto presente in custom.
Figura 4-22. L'immagine personalizzata
Questa pagina assomiglia molto alla pagina mostrata in figura 4-21, ma ci sono alcune diffrenze. In primo luogo, se guardi in alto a destra nella pagina, noterai che meta_type e posizione di questo oggetto sono cambiati. Non stai più guardando in portal_skins/plone_images/logo.jpg, ma in portal_skins/custom/logo.jpg. In secondo luogo, noterai la presenza del pulsante Sfoglia, che ti permette di selezionare un'immagine e inviarla, il che significa che puoi modificarla. Premi questo pulsante per scegliere la tuo nuova immagine, e clicka Save per rendere effettive le modifiche. In figura 4-23 si vede come ho aggiunto il logo Canadian Plone come esempio.
Figura 4-23. Il logo di Canadian Plone logo
Ora ritorna all'interfaccia di Plone, e nota come l'immagine sia cambiata. Per essere sicuro di stare veramente guardando la nuova immagine, cancella la cache del browser (con Internet Explorer puoi premere Ctrl+F5).
Cosa fare quando l'immagine non è in formato JPG?
Zope non basa il tipo MIME (Multipurpose Internet Mail Extensions) sull'estensione, ma piuttosto sul contenuto. Per questa ragione puoi benissimo inserire un immagine GIF all'interno di logo.jpg, e funzionerà alla perfezione poiché verrà applicato il MIME corretto image/gif. In ogni caso, potresti coler rinominare l'immagine in logo.gif o logo.png per fare meno confusione.
Modificare il codice CSS
Il CSS è responsabile la maggior parte del look and feel del tuo sito, incluse le schede, le immagini, i box, e il layout in generale. Il fatto che il CSS di Plone è totalmente personalizzabile significa attraverso pochi fogli di stile gli utenti possono personalizzare molto del suo aspetto.
Il capitolo 7 spiega cosa fatto tutti gli elementi; in questa sezione avrai una veloce panoramica su come cambiare il codice CSS di un sito Plone. Come prima cosa accedi alla ZMI, seleziona portal_skin, quindi plone_styles e infine ploneCustom.css. In questo modo si aprirà la pagina di questo oggetto, per ora nacora vuoto. Plone sta utilizzando le proprietà a cascata dei CSS. Poiché l'HTML (Hypertext Markup Language) di Plone importa prima plone.css e poi ploneCustom.css, ogni modifica successiva sovrascrive il foglio di stile standard. Perché questa dovrebbe essere una buona cosa? Perché in questo modo puoi creare una serie di modifiche incrementali in ploneCustom.css senza danneggiare o alterare il foglio di stile centrale di Plone.
Allora, per personalizzare l'oggeetto ploneCustom.css, seleziona portal_skins/plone_styles/ploneCustom.css e premi il pulsante Customize. Ancora una volta, piuttosto di personalizzare l'oggetto in portal_skins/plone_styles/ploneCustom.css, puoi notare come ora ti trovi in portal_skins/custom/ploneCustom.css. Poiché gli oggetti di tipo file possono essere modificati da Web, puoi editare da Web anche questo foglio di stile.
Come esempio, mettiamo un'immagine in mezzo allo sfondo (non è necessariamente il massimo come interfaccia utente, ma è un esempio chiaro di come personalizzare il codice CSS). Prima di tutto hai bisogno di inserire un immagine in Plone. Per farlo seleziona portal_skins/custom, premi il pulsante Add e seleziona Image, come mostrato in figura 4-24.
Figura 4-24. Aggiungere una nuova immagine
Come file ho scelto un'immagine trovata sul Web (disponibile anche nel sito web Plone book), ma è possibile scegliere qualunque immagine. Presta attenzione che l'ID dell'immagine sia background.gif, come mostrato in figura 4-25.
Figura 4-25. Controllo della nuova immagine
Successivamente, ha bisogno di cambiare il codice CSS affinché punti a questa nuova immagine. Hai già richiesto la personalizzazione del CSS, quindi basta che torni a portal_skins/custom/ploneCustom.css e cambi il testo in questo modo:
/* DELETE THIS LINE AND PUT YOUR CUSTOM STUFF HERE */
to the following:
body {
background-image: url(background.jpg);
background-repeat: no-repeat;
background-position: center;
}
Premi il pulsante Save Changes per rendere effettive le modifiche. Quindi ritorna all'interfaccia di Plone. Se tutto è andato per il verso giusto, dovresti vedere la nuova immagine (vedi figura 4-26).
Figura 4-26. La nuova immagine di sfondo
Andy McKay: The Definitive Guide to Plone. Apress 2004
It was last updated by lallo on 2005-04-09 07:08 from the cvs source using
svn export http://docit.bice.dyndns.org/Plone/PloneBook2/it LibroPlone.