plone book - italiano (2005) - unife · installazione su gnu/linux ... prefazione alla edizione in...
TRANSCRIPT
-
Plone Book Italiano
2005
formatted in PDF by Andrea Torre
-
Indice
Prefazione alla edizione in italiano
Capitolo 1 - Introduzione
Cos' Plone?
Cos' un sistema di amministrazione di contenuti (Content Management System)?
Perch usare un CMS su web?
Cos' l'ambiente di sviluppo CMF (Content Managment Framework)?
Cos' Zope?
Perch usare Zope e Plone?
Cos' Python?
A chi si rivolge questo libro?
A quale versione di Plone si riferisce questo libro?
Impressioni
Capitolo 2 - Installazione di Plone
Requisiti
Come ottenere Plone
Installazione usando l'installatore per Windows
Contenuti dell'installazione su Windows
Installazione su Mac OSX
Contenuti dell'installazione su Mac OS X
Installazione su GNU/Linux
Installazione dai sorgenti
Aggiungere un sito Plone
Migrazione di una installazione Plone esistente
Capitolo 3 - Utilizzo di Plone
Iscriversi al Sito
Entrare nel Sito (logging in)
Cartelle dei Collaboratori
Impostazione delle Preferenze Utente
Aggiunta e modifica di un documento
Aggiunta e modifica di altri tipi di contenuti
Discussione di contenuti
Ricerca nei contenuti
Capitolo 4 - Il controllo del flusso di lavoro
Stati di un oggetto
Ruoli degli utenti
Transizioni - Modificare lo stato degli oggetti
Ruoli locali
Pubblicazione di un documento
Revisione dei documenti
Modifica di un documento dopo la sua pubblicazione
Capitolo 5 - Configurazione di Plone
-
La Zope Management Interface, l'interfaccia di gestione di Zope
Struttura di un sito Plone nell'interfaccia di gestione
Azioni
Slot
Distribuzione dei contenuti (Syndication)
Capitolo 6 - Personalizzare il look&feel di Plone
Concetti di base
Cambiare il logo, un esempio veloce
Cambiare il logo, la spiegazione
Personalizzare il resto del sito
Costruire uno skin completamente nuovo
Sito di esempio
Altre configurazioni
Rendering della pagina Plone
Capitolo 7: Guida allo stile Plone
HTML
Colori
Fogli di stile
Capitolo 8 - Estendere Plone
Creazione di un nuovo tipo di contenuto
Creazione di un nuovo Prodotto Zope
CMFTypes
Le maschere di Plone e la navigazione
Diagnostica della sicurezza in Plone
Capitolo 9 - Ottimizzare Plone
Modalit di debug
Semplici ottimizzazioni
Uso del "mod_proxy Caching" di Apache per la gestione dei contenuti statici
Aumentare le dimensioni della Cache del ZODB
Come tenere gli slots nella cache
Gestione della cache delle pagine
Pack del sito Plone
Copia del sito Plone
Appendice E - Glossario dei termini
Nota_alla_traduzione_italiana
Prefazione alla edizione in italiano
Il Plone Book ha un suo Glossario che stato tradotto e che vogliamo tenere allineato alla versione inglese per
facilitarne gli aggiornamenti (anche se stato integrato dei termini italiani tradotti: vedi nota iniziale). Anche nella
versione inglese spesso sono usati vocaboli (come object, element, ecc.) sia come parole chiave o nomi sia come
definizioni il che rende, a volte, complessa ed interpretativa la loro traduzione soprattutto se si vuole dare una forma
pi vicina allettore.
http://www.zope.it/Members/lallo/plone/pbithtml/appendice_e.html
-
Capitolo 1 - IntroduzioneCos' Plone?
Plone un sistema di amministrazione di contenuti (Content Management System) libero (free) ed a sorgente aperto.
L'obiettivo di Plone di fornire aiuto ad ogni livello di una organizzazione. dotato all'origine di un controllo di
flusso dei lavori, di sicurezza e ruoli preconfigurati, di una serie di tipi di contenuto ed del supporto multilingue. Ogni
giorno molti sviluppatori, autori utilizzatori in tutto il mondo stanno contribuendo a Plone.
Plone si basa su un ambiente di sviluppo CMF (Content Management Framework)
Homepage: http://www.plone.org
Cos' un sistema di amministrazione di contenuti (Content Management System)?
Trovare una definizione su cosa sia un sistema di amministrazione di contenuti pi difficile che trovare qualcuno
disposto a venderlo. L'utilizzo di un CMS consente di amministrare dei contenuti, generalmente per un sito web. Lo
scopo di un CMS quindi di rendere semplice la creazione, la pubblicazione ed il recupero di contenuti per qualsiasi
richiesta.
"Il problema dell'amministrazione di contenuti che banale o impossibile.",
citazione da OSCOM, 2002.
One common dividing line between different CMS's is the integration of the web and hence can two types of systems:
a web based system, and non-web based system. Plone is a free, open source web based CMS
Perch usare un CMS su web?Crediti: Marco Federighi
La maniera pi semplice per comprendere le funzionalit di un CMS come Plone confrontarlo con un sistema
classico di sviluppo di un sito web, come Macromedia Dreamweaver. In entrambi i casi le pagine possono essere
create da un computer remoto, e sottoposte ad approvazione e pubblicazione. Vi sono tuttavia quattro differenze
fondamentali:
chiunque in possesso delle autorizzazioni necessarie pu produrre pagine web da qualsiasi parte del mondo,
usando un browser standard e senza bisogno di ulteriori software specializzati. Un CMS pi facile da utilizzare di
Dreamweaver e FTP, cosicch necessario molto meno tempo per apprenderne l'utilizzo, e molti pi compiti
possono essere delegati a personale meno qualificato. Di conseguenza, un CMS permette a molti pi utenti di
creare e modificare i contenuti del Web. Il minor tempo di apprendimento e le ridotte capacit richieste
contribuiscono inoltre ad abbassare i costi di produzione e mantenimento.
le pagine sono prodotte scrivendo del testo o caricando dei file nei template precostituiti del sito. Questo
risulta in una maggior consistenza e uniformit allo stile generale del sito, anche quando vi sua un elevato numero
di persone che producono pagine da pubblicare.
il controllo del flusso informativo molto granulare, in un CMS, dove il compito del Webmaster pu essere
effettivamente delegato a svariate persone ognuna facente capo a un settore diverso del sito senza diminuire in
alcun modo n la sicurezza, n tantomeno gli standard qualitativi.
http://www.plone.org/
-
le varie versioni di un documento sono automaticamente preservate, in modo da poter efficamente effettuare
qualsiasi controllo quando necessario.
I vantaggi di un Content Management System sono ovviamente pi significativi in una grande organizzazione, o un
vasto progetto collaborativo, piuttosto che per una piccola impresa o organizzazione.
Cos' l'ambiente di sviluppo CMF (Content Managment Framework)?
L'ambiente di sviluppo CMF una applicazione che contiene una serie di strumenti (tools) di Zope. Questi strumenti
formano un ambiente che fornisce molti dei servizi chiave che servono ad un sistema di amministrazione di contenuti
(CMS). Il CMF pu essere usato come prodotto a s stante o esservi costruito sopra come nel caso di Plone. Il CMF
fornisce gli attrezzi base come il controllo di flusso, la personalizzazione e la catalogazione. Lo sviluppo del CMF a
cura della Zope Corporation ed un prodotto a sorgente aperto che usufruisce del contributo e del grosso lavoro di
moltissimi sviluppatori di tutto il mondo.
Homepage: http://cmf.zope.org
Cos' Zope?
Zope una applicazione web-server a sorgente aperto scritta in Python. un sistema scalabile, stabile, potente che
include un database a oggetti, un server web e svariati sistemi di generazione dinamica delle pagine. Zope sviluppato
e supportato principalmente dalla Zope Corporation ma anche da sviluppatori di tutto il mondo.
Homepage: http://www.zope.org
Perch usare Zope e Plone?Credit: Marco Federighi
Sia Zope che Plone sono Open Source Software (OSS), vale a dire che il sorgente di entrambi disponibile e che
chiunque lo pu modificare. Il modello di business delle persone che producono Zope e Plone si basa sui proventi di
servizi di consulenza, primariamente per personalizzazioni e a uso commerciale. Altri esempi di CMS Open Source
sono Midgard, Bitflux, OpenCMS e Wyona.
Sostanzialmente i CMS proprietari non differiscono poi molto da quelli Open Source. Da entrambe le parti si trovano
prodotto molto buoni, mediocri e scadenti: anche la qualit della documentazione e del supporto varia molto. La
differenza principale che gli strumenti open source sono prodotti da compagnie molto pi piccole di quelle dietro ai
prodotti proprietari. Questo fa sorgere dei dubbi sulla continuit a lungo termine di queste aziende e del supporto che
possono dare. Dal mio punto di vista comunque, questa differenza pi apparente che reale. I produttori open source
sono pi piccoli e perci pi vulnerabili ad esempio alla perdita di un cliente o al licenziamento di una persona chiave;
i produttori tradizionali sono pi grandi, ma sono soggetti alle acquisizioni (vedi Allaire, da parte di Macromedia) e
alle fluttuazione del mercato IT (vedi Broadvision). Dopotutto, entrambi i tipi di produttore possono facilmente
svanire. La differenza che, con un prodotto open source, il codice sorgente disponibile all'utente e cos possibile
continuarne la manutenzione, la personalizzazione e lo sviluppo, cose impossibili da farsi nel caso di prodotti
proprietari senza un attivo coinvolgimento del produttore. Questa la ragione primaria che spinge all'uso di un
prodotto Open Source.
http://cmf.zope.org/http://www.zope.org/
-
Perch usare Plone e Zope piuttosto che altri CMS open source? Plone basato su Zope, che un framework per
costruire software di elaborazione dei contenuti. In un certo senso, Zope un sistema operativo per appicazioni web,
una delle quali il CMF (Content Management Framework), una applicazione che facilita la costruzione di ambienti
CMS. Plone uno di questi CMS, basati su un CMF, che gira dentro Zope ma con un suo livello di template e di tipi di
file. Dal nostro punto di vista (con "nostro" si intende quello del CMS Working Party portato avanti dal Web and
Internet Steering Group, WISG), Zope significativamente migliore degli altri prodotto alternativi per le seguenti
ragioni:
Zope orientato agli oggetti, nel senso che qualunque cosa appaia in un sito web Zope (pagine web, immagini,
link, file) un oggetto ed contenuto in database di oggetti. Questo database gerarchico, non relazionale, ed
particolarlmente adatto a memorizzare strutture gerarchiche di oggetti. I tecnici tendono a pensare a un database
come a una collezione di tabelle di righe e di colonne, relazionate da chiavi primarie. Qui differente, e
rappresenta pi da vicino la struttura di un ordinario file system, con oggetti che contengono altri oggetti.
Il database di Zope contiene tutte le versioni precedenti di un oggetto: questo torna particolarmente utile per
poter annullare certe modifiche, per controllare il versionamento dei documenti scritti in collaborazione con altre
persone, e per quegli oggetti che necessitino di un monitoraggio sugli interventi apportati.
Zope contiene un certo numero di strumenti particolarmente adatti alle grandi organizzazioni e ai lavori
collaborativi, che verranno descritti pi avanti nel manuale. Un esempio per tutti: le ricerche predefinite, basate
su un flessibile sistema di criteri di ricerca, che automaticamente visualizzano tutti gli oggetti che soddisfano
determinate condizioni specificate dall'utente.
Zope pu essere utilizzato su tutte le piattaforme: Unix, Linux, Mac OS, e tutte le varianti di Windows (98,
2000, XP, NT). Questo non pu essere affermato per la stragrande maggioranza degli altri CMS, open source o
meno.
Zope un ambiente molto amichevole per lo sviluppo. La possibilit di creare una copia personalizzata di un
certo script con la semplice pressione di un pulsante e al contempo mantenere di default la versione originale, la
miglior forma di protezione che abbia mai trovato.
In Zope facile definire dei documenti strutturati XML, con un workflow collegato alla struttura del
documento. Si tratta di una funzionalit essenziale per i sistemi di amministrazione nelle grandi organizzazione, e
promuove sia una consistenza nello stile che nella struttura dei documenti ma anche nel processo produttivo del
documento stesso.
Infine, Zope stato creato per essere utilizzato dalle grandi organizzazioni, con le seguenti caratteristiche:
numero elevato di contribuenti ai progetti collaborativi, localizzati in posti differenti e su differenti piattaforme;
forti requisiti di flessibilit e sicurezza, con la necessit di definire ruoli locali con differenti autorizzazioni alla
visione, creazione, modifica e approvazione nelle differenti parti di progetti complessi; scalabilit a numeri elevati
di oggetti e di server.
La settima differenza, culturale, tra il team di Zope e i concorrenti cruciale per le grandi organizzazioni. Uno dei
clienti di Zope la marina americana, che usa Zope nella gestione di progetti R&D: una grande organizzazione, nel
settore pubblico, con un occhio di riguardo alla flessibilit e alla sicurezza. Lo stesso pu essere detto della maggior
parte delle grandi corporation, pubbliche o private.
Per quel che riguarda Plone (come entit distinta da Zope), lo vedo come qualcosa di pi di un generico CMS
casualmente basato su Zope. Plone aggiunge a Zope almeno due utili funzionalit, che sono particolarmente
importanti per gli scopi del sito di Engineering Sciences:
-
Un efficace e elegante framework per la navigazione, basato su cartelle e sul loro contenuto piuttosto che su
collegamenti tra documenti html (che devono essere aggiornati) coadiuvato da strumenti come il Bulletin (che
visualizza gli oggetti creati o modificati negli ultimi giorni, eliminando la necessit di navigare per il sito a
cercarli).
Uno strumento semplice per la creazione di documenti strutturati anche complessi come i modelli PIQ e UPC,
con differenti parti di ogni documento visibile a differenti gruppi di utenti e con un percorso di approvazione
personalizzabile.
La prima funzionalit rende un sito basato su Plone straordinariamente facile e veloce da usare; la seconda lo rende
utilizzabile per compiti amministrativi, a differenza della maggior parte dei CMS che sono adatti primariamente alla
pubblicazione piuttosto che alla elaborazione dei contenuti.
Cos' Python?
Python un potente linguaggio di programmazione orientato agli oggetti, interpretato, interattivo. Python a
sorgente aperto e pu girare su quasi tutte le piattaforme e sistemi operativi. Zope scritto principalmente in Python,
con alcune ottimizzazioni in C.
python, (Gr. Myth. An enormous serpent that lurked in the cave of Mount Parnassus
and was slain by Apollo) 1. any of a genus of large, non-poisonous snakes of Asia,
Africa and Australia that suffocate their prey to death. 2. popularly, any large
snake that crushes its prey. 3. totally awesome, bitchin' language that will
someday crush the $'s out of certain other so-called VHLL's ;-), citazione da "Cos'
Python" su http://www.python.org.
A chi si rivolge questo libro?
Questo libro destinato a chi svolge uno di seguenti ruoli:
amministratore di sistema;
manager dei contenuti del sito (chi sovraintende l'aggiunta e la pubblicazione di contenuti);
collaboratore del sito (chi si iscrive e vorrebbe aggiungere contenuti)
sviluppatore del sito (chi scrive HTML, o codice)
A quale versione di Plone si riferisce questo libro?
Il libro fa riferimento all'ultima versione di Plone scaricabile da plone.org e non adatto quindi alla versione CVS, n
a quelle precedenti. Inoltre le informazioni che contiene sono pertinenti al "sito di default", come definito dalla
politica di personalizzazione. Sebbene possano esistere altre variazioni come il "sito privato", il libro non ne fa
accenno. Molti concetti rimangono comunque validi.
Impressioni
Se hai dei commenti da fare sul libro, ci farebbe piacere sentirli. La cosa migliore da fare spedire un messaggio sulla
mailing list relativa alla documentazione dove qualcuno ti risponderr.
http://www.python.org/
-
Capitolo 2 - Installazione di Plone
Questo capitolo spiega la procedura di installazione di Plone per poterlo utilizzare. L'aggiornamento di Plone
descritto in fondo a questo capitolo.
Requisiti
Plone installabile su qualsiasi piattaforma supportata da Zope: Windows, Mac OSX, GNU/Linux, la maggior parte
dei sistemi Unix e su Solaris. In Windows 2000 necessario scrivere nel registro per poter installare il software e
questo pu richiedere pi permessi di quelli che hai. Nella maggior parte dei casi avrai comunque bisogno dei
permessi di amministrazione sul computer su cui intendi installarlo.
Server
Un computer potente chiaramente migliorer le prestazioni di Plone. Si raccomanda di utilizzare un computer a
almeno 600Mhz e con 64Mb di RAM. Per ulteriori informazioni sulle performance e su alcune comparazioni consulta
il Capitolo 9 - Ottimizzare Plone.
Una installazione di base richiede circa 50Mb di spazio sul disco fisso. Se hai gi installato Zope o Python chiaramente
questo valore sar molto pi piccolo. Tieni conto comunque che il database degli oggetti potr espandersi a piacere, a
seconda della mole di dati che vi inserirai.
Client
Plone richiede un qualunque browser che possa accedere al server. Se l'utente desidera registrarsi (login), i cookies
devono essere abilitati. Gli script Java non sono necessari ma forniscono maggiori possibilit all'utente.
Browser compatibili con Plone 1.0:
Internet Explorer 5.5 e superiori
Netscape 7.0 e superiori
Mozilla 1.0 e superiori
Opera 7.0 e superiori
Konqueror 3.0 e superiori (le tab non sono rese correttamente dalla versione 3.2-cvs, ma essendo codice
condiviso con Apple e Safari, per la soluzione del problema probabile sia solo una questione di tempo)
Safari 1.0 e superiori (per il momento c' solo una beta build 62 e pi recente, la 1.0 non ancora rilasciata in
questo momento)
Plone pienamente funzionante anche con i seguenti Browser ma presenta un aspetto differente rispetto al look
originale Plone:
Netscape 4.7
Internet Explorer 5.0
Internet Explorer 4.0 (non testato intensivamente ma sembra lavorare bene)
Konqueror 2.x
Lynx (testuale)
w3m (testuale)
-
AWeb
links (testuale, con grafica opzionale)
Qualsiasi browser che supporti un set base di HTML e di form imput + cookies (inclusi la maggior parte dei
browser mobile/PDA)
Come ottenere Plone
L'ultima versione di Plone sempre disponibile su http://www.plone.org/download. In futuro potrebbe essere
disponibile anche su CD.
Installazione usando l'installatore per Windows
Note sull'installazione Windows, a cura di Steve Rauch.
Il programma di installazione
L'installatore per Windows automatizza l'installazione di Plone su quel sistema operativo. stato testato con le
versione 9x, ME, NT 3.51+, 2000 e XP, ma potrebbe funzionare anche sulle altre. Si raccomanda di avere un accesso
coi permessi di amministrazione sul computer in cui intendi installarlo. Se hai gi installato Zope o Python, potresti
volerne installare separatamente i soli sorgenti, per risparmiare spazio su disco. L'installatore comprende ulteriori
pacchetti e opzioni, un database precaricato e altre cose utili.
L'installatore pu essere scaricato dal sito Plone.org, nella sezione downloads. Una volta scaricato, cliccaci sopra due
volte per cominciare l'installazione. Ti si dovrebbe presentare una schermata simile a questa:
Il programma di installazione segue i classici passaggi, basta che tu segua le indicazioni in basso per proseguire
("Next") o annullare ("Cancel") l'operazione. Non si ritiene necessario spiegare nel dettaglio i singoli passi, dal
momento che sono autoesplicativi. Quando arrivi alla richiesta di una password (vedi sotto), devi inserirne una, quella
per l'utente "admin". Avrai bisogno di questa password pi tardi, quindi segnatela da qualche parte. Se la perdi ne
potrai inserire una nuova usando il Plone Controller.
http://www.plone.org/downloadhttp://www.plone.org/http://www.plone.org/download
-
L'installazione impiegher circa 3 minuti a seconda della velocit del tuo computer. Al termine vengono eseguiti
ulteriori passi come la compilazione dei sorgenti Python. Una volta completata, Plone non viene avviato
automaticamente. Se lasci attivata l'opzione "Launch Plone Controller" verr lanciato quello strumento che ti
permetter di avviare Plone.
Il Plone Controller
Il Plone Controller facilita l'amministrazione di un sito Plone: utilizzando un'interfaccia grafica ti permette di
impostare cose tipo i file di log, la porta da utilizzare e come far partire Plone. Per attivare il Controller, selezione
"Plone" nel menu di Avvio.
-
Il programma si avvia dalla schermata "Control" che ti consente di attivare e disattivare agevolmente il sito Plone. Se
sei impaziente, clicca su "Start" per far partire il tuo Plone.
Questa schermata mostra se il tuo Plone attivo o meno, con il pulsante in evidenza e col messaggio di "Current
Status". Dal momento che Plone non parte automaticamente devi cliccare su "Start" per farlo avviare. Su alcuni
computer molto lenti questo potrebbe richiedere un po' di tempo, specialmente la prima volta, e mandare in timeout
il Controller facendogli credere che Plone non sia partito. Cliccando su "Start" una seconda volta corregger la cosa. Si
tratta di un errore che verr corretto in una versione futura.
-
Una volta avviato Plone, puoi accedere al sito cliccando sul pulsante "View Plone". Questo far partire un browser per
accedervi. Il pulsante "Manage Plone" ti porta nell'interfaccia di manutenzione di Zope, semprech tu abbia impostato
correttamente la porta di management in "HTTP Manage", che per default viene usata la 8080.
Servizi
La scheda "Services" ti permette di specificare su quali porte Plone debba rimanere in ascolto per accettare
connessioni esterne come HTTP, FTP e WebDAV. Se lasci in bianco una certa porta, non verr attivata. in
realt, l'originale dice "If you leave a port blank then that port will not be disabled."... . Assicurati che non vi
siano altri server in ascolto sulle stesse porte, cose tipo IIS, Apache, PWS potrebbero utilizzare porte simile a quelle
usate da Plone.
HTTP: specifica la porta per visitare il sito Plone, di solito si usa la 80. Sebbene non sia obbligatoria, senza
questa porta non sara in grado di accedere al sito con un browser web. Se questa porta abilitata e Plone sta
girando, il pulsante "View Plone" attivo nella tab di controllo.
-
HTTP Manage: specifica quale porta utilizzare per l'accesso amministrativo di Plone, per default la 8080.
Questa porta ti fa accedere all'interfaccia di management di Zope. Se questa porta abilitata e Plone sta girando, il
pulsante "Manage Plone" attivo nella tab di controllo.
FTP: specifica la porta utilizzata per l'accesso via FTP, per default la 21.
WebDAV: specifica la porta utilizzata per l'accesso via WebDAV, per default la 8081.
Propriet avanzate
La maschera "Advanced" permette di impostare le opzioni pi complesse. Se non sei sicuro di cosa si tratta, lasciale
perdere. Una delle pi interessanti la "Service Daemon", che ti permette di precisare come sar eseguito Plone e
riguarda l'uso dei servizi di Windows.
Se stai usando Windows NT, 2000 o XP puoi far girare Plone come un servizio (con l'opzione "Windows NT/2000").
Questo eseguir Plone in background, senza alcuna icona visibile e lo render accessibile come un servizio: un
pulsante "Restart" apparir nella ZMI cosicch un utente autorizzato possa far ripartire Plone direttamente dal web.
Un altro vantaggio di utilizzare i servizi che pu essere fatto partire e fermare dalla Management Console nel
Pannello di Controllo di Windows, o dalla riga di comando usando rispettivamente i comandi 'net start Plone' e 'net
stop Plone'.
Se invece usi Windows 95, 98 o ME devi attivare l'opzione "Windows 95/98". Questo far partire Plone come un
qualsiasi altro processo e un'icona apparir nell'apposita sezione della barra di comando. Puoi intervenire su Plone sia
dal suo Controller sia cliccando sull'icona. Anche Window NT, 2000 e XP possono usare questa modalit.
Queste opzioni saranno selezionate automaticamente durante l'installazione.
Avviare Zope a mano
Se ci sono problemi a far partire Plone dal Controller, puoi attivarlo direttamente dalla linea di comando. Ulteriori
informazioni sono disponibili nella documentazione di Zope. Il Controller esegue questa istruzione:
-
c:\Programmi\Plone\Python\python.exe c:\Programmi\Plone\Zope\z2.py -X -w80 -w8080 -f21 INSTANCE_HOME=c:\Programmi\Plone\Data HTTP_MANAGE=8080
la riga spezzata per facilitarne la lettura, va data tutta in una riga
si assume che tu abbia installato Plone in c:ProgrammiPlone
Contenuti dell'installazione su Windows
Oltre a Plone, l'installazione per Windows carica i seguenti componenti:
CMF 1.3.1 Il CMF indispensabile a Plone. La versione pi recente pu essere trovata su cmf.zope.org
Zope 2.6.1 Questa la versione pi recente, che pu essere trovata su zope.org.
Python 2.1.3 Python 2.1.3 richiesto da Zope 2.6.0. Python pu essere trovato su python.org.
Estensioni Win32 per Python Le estensioni Win32 di Mark Hammond offrono accesso alla API di Windows, e
possono essere trovate su Starship.
PIL 1.1.3 La Python Imaging Library consente di manipolare e modificare immagini direttamente da Python.
Viene utilizzato da CMFPhoto per scalare le immagini. PIL pu essere scaricata da pythonware.com.
ReportLab 1.15 ReportLab consente di creare dei documenti in PDF direttamente da Python. Pu essere
scaricato da reportlab.com.
Zope Controller 1.0 uno strumento che permette di avviare, fermare e configurare Zope con una interfaccia
GUI. La versione Plone derivata dal Controller Zope.
CMF Collector 0.9b Un sistema di gestione dei problemi in Plone. sviluppato dalla Zope Corp. e pu essere
scaricato da cvs.zope.org.
CMF Wiki 0.1 Una implementazione di un sito wiki in Plone. sviluppato dalla Zope Corp. e pu essere
scaricato da cvs.zope.org.
CMF Quick Installer Consente di installare velocemente nuovi prodotti Zope selezionandoli nella Zope
Management Interface. scaricabile dal progetto Collective su SourceForge.
CMF Photo un prodotto che consente di vedere immagini e fotografie ridimensionandole dinamicamente.
scaricabile dal progetto Collective su SourceForge.
CMF Forum Implementa una specie di bulletin board, una discussione che coinvolge pi persone.
scaricabile dal progetto Collective su SourceForge.
External Editor 0.6 (client e server) Rende facile modificare gli oggetti con un editor esterno. Si trova su
zope.org.
Zope Book 2.5 Il libro su Zope. L'originale del libro su zope.org mentre la versione HTML visibile qui.
Localizer Il Localizer permette di tradurre i messaggi del sito in varie lingue.
Translation Service e Traduzioni
Translation Service gestisce la traduzione in lingua delle Zope Page Templates e consente l'integrazione
tra Plone e Localizer Il Translation Service pu essere scaricato da qui.
Sono incluse poi numerose traduzioni raccolte dal progetto Plone i18n su SourceForge. Verranno
installate tutte le traduzioni disponibili, anche se qualcuna potrebbe essere ancora incompleta.
http://cmf.zope.org./http://www.zope.org/http://www.python.org/http://www.zope.it/Members/lallo/plone/pbithtml/:http://starship.python.net/crew/mhammond/http://www.zope.it/Members/lallo/plone/pbithtml/:http://www.pythonware.com/products/pil/http://www.reportlab.com/http://www.zope.org/Members/richard/zope_controller/winhttp://cvs.zope.org/http://cvs.zope.org/http://www.sourceforge.net/projects/collectivehttp://www.sourceforge.net/projects/collectivehttp://www.sourceforge.net/projects/collectivehttp://www.zope.org/Members/Caseman/ExternalEditor.http://www.zope.org/Documentation/Books/ZopeBook/currenthttp://www.orgmf.com.ar/condor/zopestuff.htmlhttp://www.j-david.net/software/localizer/http://www.zope.org/Members/efge/TranslationServicehttp://www.sourceforge.net/projects/plone-i18n
-
Inoltre viene installato un database a meno che non ne esista gi uno in quella directory (nel qual caso viene lasciato
inalterato) che contiene il sito Plone (con gi installati il CMF Collector e il CMF Wiki), le regole di accesso, il sito di
base e l'External Editor.
Installazione su Mac OSX
Note sull'installazione MacOSX, a cura di Jim Roepcke.
Il programma di installazione
L'installatore per Mac OS X automatizza l'installazione di Plone su quel sistema oparativo. E' stato testato ed
supportato dalla versione Mac OS X 10.2.3 e superiori. Si raccomanda di avere un accesso coi permessi di
amministrazione sul computer in cui intendi installarlo. Se hai gi installato Zope o Python, potresti volerne installare
separatamente i soli sorgenti, per risparmiare spazio su disco. L'installatore comprende ulteriori pacchetti e opzioni,
un database precaricato e altre cose utili.
L'installatore per Mac OS X pu essere scaricato dal sito Plone.org, nella sezione downloads.Una volta scaricato,
cliccaci sopra due volte per cominciare l'installazione. Infine ti si dovrebbe presentare una schermata simile a questa:
Inserisci la password per il tuo account in Mac OS X per consentire l'installazione. Nota che devi avere i permessi di
amministratore per poterlo fare. Se il tuo account non possiede i privilegi da amministratore, esci e rientra con un
account che li possieda e poi rilancia l'installatore.
(Puoi spostare il pacchetto dell'installatore in /Users/Shared prima di uscire in modo da potervi accedere come altro
utente) Quando l'installazione consentita dovresti vedere la seguente schermata:
http://www.plone.org/http://www.plone.org/download
-
L'installatore compie i soliti pessi per installare il software, scegli tra le le opzioni che ti vengono presentate in fondo
per continuare o per tornare indietro. Non serve discutere su ogni passo in quanto sono quasi tutti auto esplicativi.
Comunque alla richiesta del volume dove installare Plone devi scegliere la partizione dove Mac OS X installato.
L'installazione dura all'incirca tre minuti in base alla velocit del tuo computer. Quando terminata Plone non viene
avviato per default. Nel file ReadMe.rtf in /Applications/Plone trovi una grande quantit di informazioni utili per far
girare e mantenere la tua istanza Plone, incluso come avviare Plone. Per tua comodit il comando scritto qua sotto:
sudo /Library/StartupItems/Plone/Plone start
Contenuti dell'installazione su Mac OS X
Oltre a Plone, l'installazione per Mac OS X carica i seguenti componenti:
CMF 1.3.1 Il CMF indispensabile a Plone. La versione pi recente pu essere trovata su cmf.zope.org
Zope 2.6.1 Questa la versione pi recente, che pu essere trovata su zope.org.
http://cmf.zope.org./http://www.zope.org/
-
Python 2.1.3 Python 2.1.3 richiesto da Zope 2.6.0. Python pu essere trovato su python.org.
PIL 1.1.3 La Python Imaging Library consente di manipolare e modificare immagini direttamente da Python.
Viene utilizzato da CMFPhoto per scalare le immagini. PIL pu essere scaricata da pythonware.com.
ReportLab 1.15 ReportLab consente di creare dei documenti in PDF direttamente da Python. Pu essere
scaricato da reportlab.com.
CMF Collector 0.9b Un sistema di gestione dei problemi in Plone. sviluppato dalla Zope Corp. e pu essere
scaricato da cvs.zope.org.
CMF Wiki 0.1 Una implementazione di un sito wiki in Plone. sviluppato dalla Zope Corp. e pu essere
scaricato da cvs.zope.org.
CMF Quick Installer Consente di installare velocemente nuovi prodotti Zope selezionandoli nella Zope
Management Interface. scaricabile dal progetto Collective su SourceForge.
CMF Photo un prodotto che consente di vedere immagini e fotografie ridimensionandole dinamicamente.
scaricabile dal progetto Collective su SourceForge.
CMF Forum Implementa una specie di bulletin board, una discussione che coinvolge pi persone.
scaricabile dal progetto Collective su SourceForge.
External Editor 0.6 (client e server) Rende facile modificare gli oggetti con un editor esterno. Si trova su
zope.org.
Zope Book 2.5 Il libro su Zope. L'originale del libro su zope.org mentre la versione HTML visibile qui.
Localizer Il Localizer permette di tradurre i messaggi del sito in varie lingue.
Translation Service e Traduzioni
Translation Service gestisce la traduzione in lingua delle Zope Page Templates e consente l'integrazione
tra Plone e Localizer Il Translation Service pu essere scaricato da qui.
Sono incluse poi numerose traduzioni raccolte dal progetto Plone i18n su SourceForge. Verranno
installate tutte le traduzioni disponibili, anche se qualcuna potrebbe essere ancora incompleta.
Inoltre viene installato un database a meno che non ne esista gi uno in quella directory (nel qual caso viene lasciato
inalterato) che contiene il sito Plone (con gi installati il CMF Collector e il CMF Wiki), le regole di accesso, il sito di
base e l'External Editor.
Installazione su GNU/LinuxDebian
Sono disponibili i pacchetti per la versione in sviluppo di Debian. Aggiungi al tuo '/etc/apt/sources.list' la riga
seguente:
deb http://plone.sourceforge.net/debian/ ./
Questo pacchetto dipende da 'zope-cmf' che disponibile nella versione unstable di Debian.
Al momento questo pacchetto non di buona qualit. Verr migliorato una volta che verr installato nella
distribuzione testing di Debian.
RedHat/Mandrake/Suse
http://www.python.org/http://www.zope.it/Members/lallo/plone/pbithtml/:http://www.pythonware.com/products/pil/http://www.reportlab.com/http://cvs.zope.org/http://cvs.zope.org/http://www.sourceforge.net/projects/collectivehttp://www.sourceforge.net/projects/collectivehttp://www.sourceforge.net/projects/collectivehttp://www.zope.org/Members/Caseman/ExternalEditor.http://www.zope.org/Documentation/Books/ZopeBook/currenthttp://www.orgmf.com.ar/condor/zopestuff.htmlhttp://www.j-david.net/software/localizer/http://www.zope.org/Members/efge/TranslationServicehttp://www.sourceforge.net/projects/plone-i18n
-
Sono disponibili i pacchetti in formato RPM di Plone per le distribuzioni Red Hat, Mandrake e Suse. I pacchetti pi
recenti sono scaricabili da SourceForge.
Installazione dai sorgenti
Se hai familiarit con l'installazione dei prodotti a partire dalla distribuzione sorgente, pu essere la maniera migliore
di installare Plone. Queste istruzioni assumono tu conosca i vari strumenti come il tar: se non li conosci potrebbe
essere pi facile partire con una delle altre opzioni di installazione.
Requisiti Zope 2.5.1 o superiore scaricabile da http://www.zope.org/Products
CMF 1.3 o superiore scaricabile da http://cmf.zope.org/download
Come ottenere l'ultima versione di Plone
disponibile in formato tar su http://www.plone.org/download. Per estrarne il contenuto, lancia i seguenti comandi 1:
$ gunzip CMFPlone1.0.tar.gz $ tar -xvf CMFPlone1.0.tar
L'archivio tar di Plone contiene svariati altri prodotti oltre a Plone stesso: ActivePak, DCWorkflow e Formulator. Puoi
estrarne la versione pi recente direttamente dal repository CVS coi seguenti comandi 2:
cvs -d:pserver:[email protected]:/cvsroot/plone login cvs -d:pserver:[email protected]:/cvsroot/plone co -r Plone-1_0 CMFPlone cvs -d:pserver:[email protected]:/cvsroot/formulator co Formulator cvs -d:pserver:[email protected]:/cvs-repository login cvs -d:pserver:[email protected]:/cvs-repository checkout Products/DCWorkflow
Se stai usando Zope 2.5.1 (ti raccomandiamo di usare una versione pi recente) avrai bisogno anche della patch
ActivePak:
cvs -z3 -d:pserver:[email protected]:/cvsroot/plone co ActivePak
Installazione Installa Zope, seguendo le istruzioni contenute nel file 'INSTALL.txt'.
http://sourceforge.net/project/showfiles.php?group_id=47214http://www.zope.org/Productshttp://cmf.zope.org/downloadhttp://www.plone.org/download
-
Installa il CMF, seguendo le indicazioni contenute nel file 'INSTALL.txt'.
Copia le directory CMFPlone, ActivePak, DCWorkflow e Formulator dentro la directory Products della tua
installazione di Plone. Puoi trovare ulteriori informazioni nel file 'INSTALL.txt' dentro la directory CMFPlone.
Fai ripartire Zope. Come farlo dipende da come hai installato Zope e dal sistema operativo che usi.
Vai nell'interfaccia di management: lo fai aggiungendo /manage all'indirizzo URL del tuo Zope. A questo
punto dovresti trovare "Plone Site" nell'elenco dei prodotti da aggiungere. Significa che l'installazione andata a
buon fine. Vedi "Aggiungere un sito Plone" per ulteriori informazioni.
Aggiungere un sito Plone
Qui si assume che Plone sia stato correttamente installato usando una delle procedure descritte sopra. Se hai usato
l'installatore di Windows o di Mac OS X hai gi un sito Plone chiamato "Plone" e quindi non hai bisogno di leggere
questa sezione a meno che tu non voglia installare un'altro sito Plone dentro Zope
Accedi alla interfaccia di sviluppo di Zope aggiungendo "/manage" all'URL del tuo Zope
Seleziona "Plone Site" dall'elenco degli oggetti disponibili:
I seguenti campi stabiliscono le informazioni sul tuo sito Plone:
Id required: l'id del sito Plone ed un nome breve che pu contenere solo un ristretto set di
caratteri (sono raccomandati solo caratteri alfanumerici), sar l'URL del tuo sito Plone.
Title: il nome del sito che comparir in tutte le pagine
Membership source: se non sai cosa significa lascialo com' impostato di default "Create a
new...". Puoi anche scegliere di aggiungere una cartella utente nel tuo sito Plone o di usare una
cartella pi in alto.
Description: una descrizione del sito
Site type: qu puoi definire un tipo differente di sito, per esempio un sito con un proprio aspetto
(skin). Questo manuale assume che tu abbia scelto il valore di default.
Dopo che hai cliccato su "Add Plone Site" verr creato un nuovo sito. L'operazione pu durare alcuni secondi
per leggere tutte le informazione.
Congratulazioni, ora hai installato Plone.
Migrazione di una installazione Plone esistente
Nota: queste istruzioni di installazione possono essere applicate a tutte le versioni attuali e future di Plone. Comunque
potrebbero essere necessari ulteriori passi. Si prega di consultare le istruzioni di scaricamento della propria versione.
Se hai una installazione di Plone gi esistente e desideri aggiornarla stato aggiunto uno strumento per la migrazione.
Questo strumento per migrare richiede la conoscenza e la possibilit di accesso all'interfaccia di sviluppo ZMI. Prima
di iniziare la migrazione esegui una copia completa del tuo sito Plone proprio in caso di necessit.
Installazione del software
-
Recupero della tua installazione, inclusione del database. - Scarica ed installala nuova versione di Plone.
L'installazione nel tuo filesystem risulter cambiata alla nuova versione. Abitualmente si effettua l'installazione
sopra la vecchia versione.
Riavvia Zope
Segui le seguenti istruzioni di migrazione.
Migrazione da un sito pre 1.0 Alpha
Questo non contenuto nella procedura di migrazione. Suggeriamo di aggiungere una nuova istanza Plone usando il
nuovo codice e muovendo successivamente gli oggetti contenuti nel nuovo sito. Semplicemente usando il copia incolla
nella interfaccia di sviluppo ZMI.
Migrazione da un sito pre 1.0 Beta3 (ma successivo ad Alpha)
Nella ZMI devi aggiungere lo strumento di migrazione (migration tool). Seleziona "Plone Tool" dalla lista degli oggetti
disponibili, nella pagina successiva seleziona "Plone Migration Tool" e poi clicca sul pulsante "Add". Un nuovo oggetto
chiamato migration_tool sar aggiunto all'istanza Plone. Seleziona l'oggetto che mostrer alcune informazioni sulla
tua istanza Plone e sul codice nel fileSystem.
Comunque siccome questo strumento stato appena aggiunto non in grado di sapere quali istanze Plone hai e
mostrer beta 1.3 sia per l'istanza corrente che per l'istanza nel filesystem. Seleziona quella che pensi sia la versione
corretta e seleziona "force migration".
Migrazione da un sito post 1.0 Beta3
Nella ZMI trova lo strumento chiamato migration_tool. Ti dice la versione corrente del tuo Plone e la versione sul tuo
filesystem. Per migrare al Plone esistente semplicemente clicca su "migrate". Plone attuer tutti gli aggiornamenti
necessari.
Problemi di migrazione conosciuti CMFTypes
Durante la migrazione i tipi personalizzati vengono persi e la migrazione si ferma su ogni contenuto di questi tipi.
Dopoaver rimosso quei contenuti la migrazione funziona bene.
[1]adattando il numero di versione a quello che hai effettivamente scaricato
[2]dopo aver richiesto il login CVS ti richieder una password: premi direttamente invio (cio, lasciala in bianco)
-
Capitolo 3 - Utilizzo di Plone
Qui si assume che tu abbia accesso ad una versione di Plone. Altrimenti il capitolo 2 tratta dell'installazione di Plone.
Si raccomanda di usare un browser recente in quanto Plone fa uso degli standard e delle tecniche correnti nella
costruzione delle pagine. Essendo Plone un sistema per costruire siti, alcune istruzioni possono cambiare da sito a
sito; queste che state leggendo riguardano una installazione base.
Iscriversi al Sito
L'iscrizione ad un sito ti da il diritto, come Collaboratore, di aggiungere contenuti al sito stesso, quali immagini,
documenti e cos via. Le possibilit dipendono dalla configurazione che l'amministratore ha impostato.
Per iscriversi al sito scegli l'opzione 'Iscriviti' nell'angolo in alto a destra accanto a 'Accedi'.
Questa scelta mostra il modulo di iscrizione da completare con i tuoi dati. Se la prima volta che la vedi nota alcune
caratteristiche: un quadratino rosso vicino all'etichetta di un campo di immissione significa che quel campo
obbligatorio; quando entri in un campo un aiuto appare a sinistra per facilitarti l'inserimento dei dati.
Nome reale
Il tuo nome esteso.
Nome Utente
Il nome che desideri usare, molti usano un valore alfanumerico senza spazi del tipo "pippo" o
"clarabella97".
E-mail
richiesto un indirizzo valido. Se perdi la tua password ti pu essere inviata una password sostitutiva
a questo indirizzo.
Password e Conferma Password
La password che desideri usare, dev'essere pi lunga di cinque caratteri. "case sensitive" ovvero
distingue le maiuscole dalle minuscole.
Invio Password?
Spunta questo box se desideri che ti sia spedita via mail la password all'indirizzo che hai fornito.
Una volta completato questo modulo potrai entrare subito nel sito.
Entrare nel Sito (logging in)
Per entrare scegli il collegamento 'Accedi' (log-in) (come mostrato in precedenza) e completa la maschera che ti viene
proposta. Per poter accedere ad un sito Plone il tuo browser dev'essere abilitato per ricevere i Cookie. Un cookie viene
scritto nel tuo computer per permetterti di entrare e scadr dopo un certo periodo in conformit con la politica del
sito.
-
Password dimenticata
Se hai dimenticato la tua password questa pu esserti rispedita via e-mail. Se alla registrazione non hai specificato un
indirizzo valido non sar possibile inviartela. In questo caso devi contattare l'amministratore del sito. Puoi farti
spedire la password cliccando sul collegamento 'Hai dimenticato la password?', normalmente posizionato in un box
nella parte sinistra del sito.
Uscita
Una volta entrato nel sito puoi vedere, nell'angolo destro in alto, il collegamento 'esci' (n.d.t.:log out). una buona
pratica quella di uscire da Plone quando si finito di usarlo.
Cartelle dei Collaboratori
Ogni Collaboratore ha una cartella dove pu creare ed inserire contenuti. Queste cartelle si trovano nella cartella
Collaboratori che contiene anche una pagina home predisposta con nome index_html. Se vuoi vedere la tua cartella
personale clicca sul collegamento "cartella personale" a destra in alto, nella barra principale.
Impostazione delle Preferenze Utente
Nell'angolo a destra in alto del sito vi il collegamento alla maschera delle 'Preferenze personali'. Questo modulo ti
consente di personalizzare numerose caratteristiche che influiscono sulla tua interazione con Plone.
E-Mail
l'indirizzo email associato al tuo account. usato in diverse componenti del sistema Plone ed
molto importante: se dimentichi la password questo l'indirizzo a cui il sistema la invier per email.
Editor dei contenuti
Quando le modifiche sono complesse pu essere preferibile usare un editor pi adatto. Se
l'amministratore del sito ne ha installati, potrai selezionarlo qui. Verr usato quando selezioni la tab
di modifica di un certo oggetto. Default: Nessuno.
Presenza nell'elenco dei collaboratori
Scegliendo questa opzione il tuo profilo apparir nella scheda 'Collaboratori'. Il fatto di essere
'Presente' decisiva per consentire o meno di trovare il tuo nominativo nella ricerca per nome della
scheda Collaboratori, quando questa funzionalit attivata. Default: None
Messaggi di aiuto
Ogni campo di immissione dotato di un aiuto che appare passando o entrando nel campo stesso.
utilissimo per i nuovi arrivati che sono avvisati sull'uso di una particolare scheda mentre la stanno
riempiendo. Gli utenti che non desiderano essere aiutati possono modificare questa opzione
selezionando No. Default: Si
Mostra i nomi
Ogni oggetto ha una propriet 'Nome' che abitualmente utilizzato come sua rappresentazione interna. Il
nome quanto viene mostrato nell'indirizzo URL quando l'oggetto viene referenziato. Per default i nomi che
sono automaticamente generati assumono una forma del tipo: Nuovo_Elemento.2002-11-16.4102 ma puoi
-
semplificarlo di molto riducendolo ad esempio a notizie_novembre cambiando il valore del campo nome.
Default: Si
ATTENZIONE: Modificando il nome se qualcosa d'altro referenzia il vecchio nome questo non sar pi valido e il
risultato sar che la pagina non sar trovata. meglio non modificare la propriet nome di un oggetto dopo
averlo sottoposto e revisione o averlo collegato da altra risorsa.
Aspetto
alcuni desiderano cambiare l'aspetto del sito: Plone dispone di svariati aspetti o temi per consentirlo.
Scegli qu l'aspetto che desideri per il tuo sito Plone. Default: Plone Default
Ritratto
nelle grandi organizzazioni importante poter vedere l'immagine di un'altra persona. Permette di
vedere la gente con cui si lavora e di individuarla personalmente quando necessario.
particolarmente utile per comunit o in ambienti intranet. Per avere un ritratto scegli una tua
immagine da 75 pixel di larghezza per 100 pixel in altezza: se l'immagine caricata non di queste
dimensioni verr ridimensionata automaticamente.
Una volta apportate le modifiche del caso alle preferenze, clicca su salva per confermarle.
Aggiunta e modifica di un documento
Prima di inserire qualsiasi tipo di contenuto devi trovare un posto dove inserirlo. I contenuti possono essere aggiunti
in molti posti di un sito Plone ma puoi creare cartelle particolari secondo le tue necessit per inserire qualsiasi
contenuto in modo da ritrovarlo facilmente. Spesso l'amministratore predispone degli spazi per te.
Invece di descrivere nel dettaglio come aggiungere e modificare tutti i tipi di contenuti utilizzabili in Plone qui
parleremo solo dell'aggiunta e della modifica di un 'Documento'. Lo stesso processo vale per quasi tutti i tipi di
contenuto e quindi si tratta di ripetere per questi gli stessi passi descritti qui.
Cosa un Documento?
Un documento una pagina di contenuti, usualmente un contenitore di testo. Pu essere scritto in vari formati: testo
puro (plain text), HTML o Testo Strutturato (StructuredText). Un esempio di documento la pagina principale di un
sito Plone.
Aggiunta di un documento
Per aggiungere un documento devi essere nella 'Vista contenuti' (Contents View mode), il collegamento disponibile
nella parte sinistra della pagina. Questa modalit ti mostra i file presenti sul server e ti consente di modificarli. Se non
vedi il collegamento alla 'Vista contenuti' significa che non hai i permessi per inserire o cambiare i contenuti a questo
livello.
-
La modalit sviluppo ti mostra una lista dei contenuti della cartella corrente. Le azioni che puoi fare qui sono descritte
pi avanti. In alto a destra del pannello centrale accanto al pulsante "aggiungi un elemento" disponibile la lista dei
tipi di contenuti che puoi aggiungere in questa cartella. Seleziona 'Documento' e un nuovo documento sar aggiunto
alla cartella.
Quando aggiungi un nuovo documento ti viene proposta immediatamente una pagina dove modificarlo.
Modifica di un documento
Il documento pu essere editato direttamente tramite il proprio browser usando il modulo che viene proposto. Da
notare la scheda "modifica" che evidenziata in cima alla pagina. Il messaggio appare in cima a questa pagina come
mostrato qui sotto.
Ogni documento ha quattro campi principali che potrai alterare:
Nome
Questo identificatore diventa parte dell'indirizzo web del documento. Dovrebbe essere breve,
descrittivo e non contenere caratteri speciali. Per esempio "consuntivo-2003". Se non inserisci un
nome Plone lo inserir per te.
Titolo
Viene mostrato in cima alla pagina, nelle ricerche, nel titolo del browser eccetera. Questo campo
obbligatorio;
Descrizione
Un sottotitolo introduttivo per chiarire i contenuti del documento, normalmente non pi lungo di 20
parole;
-
Corpo del testo
la parte dove sono i contenuti del documento. Qui viene scritto il resto del documento. Il formato con cui
viene compilato il documento deve essere scelto con i pulsanti sotto al corpo del testo, che sono:
Testo strutturato: la scelta di default. Il Testo Strutturato un formato per ottenere da testo puro
pagine HTML senza che l'utente debba conoscere e scrivere il linguaggio HTML. Per maggiori
informazioni sul Testo Strutturato vedi:
Introduzione al testo strutturato (in inglese)
Structured Text Help
HTML: qualsiasi contenuto scritto in HTML
Testo puro: testo ordinario senza alcuna strutturazione o marcatura (tag). I ritorni a capo vengono resi
con i tag '
' in modo da mantenere l'aspetto originale del testo.Se hai gi dei documenti memorizzati su file nel tuo computer puoi caricarli direttamente piuttosto che riscriverne il
corpo del testo. Per cercarli usa il pulsante Sfoglia in fondo alla pagina.
Quando hai finito di modificare il tuo documento premi il pulsante conferma. Se lo hai cambiato in modo appropriato
ti sar visualizzato: potrai vedere immediatamente come viene reso (formattato) e eventualmente potrai continuare
ad apportare cambiamenti passando nuovamente alla scheda modifica. Altrimenti ti viene mostrata una pagina con
evidenziati gli errori che hai commesso; in questo caso le tue modifiche non verranno applicate. Dovrai correggere gli
errori e salvare nuovamente.
Assegnare propriet ad un documento
Ogni oggetto pu avere delle propriet e quindi anche i documenti seguono questa regola. Le propriet sono spesso
chiamate metadati in quanto sono informazioni supplementari che un oggetto ha di se stesso. Questo modulo ha
parecchi campi che sono in comune con tutti gli oggetti Plone.
Consenti discussione
Consenti che questo documento possa essere commentato e discusso dagli utenti che ne hanno il
permesso. Se impostato a default, verr applicata la politica dell'intero sito. Puoi comunque cambiare
questa scelta secondo le tue necessit.
Parole chiave
un campo leggermente pi complicato che consente di impostare le parole chiave di un documento.
Impostare le parole chiave una strada per assegnare i metadati ad un oggetto.
Data di accessibilit e data di scadenza
La data di accessibilit la data del primo giorno in cui l'oggetto disponobile e la data di scadenza
la data dell'ultimo giorno. Le ricerche e la navigazione mostrano gli oggetti solo in questo periodo.
Lasciando questo campo vuoto gli oggetti sono disponibili indefinitamente.
Formato
Il tipo MIME dell'oggetto. Se no sai di cosa si tratta lascialo stare.
Lingua
La lingua con cui scritto il documento
http://www.zope.org/Documentation/Articles/STXhttp://plone.org/Members/kpm/stx-help/view
-
Copyright
Informazioni sulla licenza dell'oggetto
Contributi
I nomi delle persone che hanno contribuito all'oggetto. Ogni nome dev'essere in una linea diversa.
Pubblicazione del documento
Di norma i documenti sono 'visibili' il che significa che chiunque pu accedervi ma che non sono mostrati nell'albero
di navigazione. I documenti nello stato visibile sono disponibili tramite la funzione ricerca o puntando direttamente
alla loro URL.
Una volta soddisfatto del tuo documento potresti volerlo pubblicare. Per far questo devi scegliere la scheda 'stato'.
Questo modulo ti consente di accedere al processo di pubblicazione.
Data di accessibilit
Consente di stabilire la data da cui il documento sar effettivamente disponibile. Prima di questa data
il documento non sar 'pubblicato'. Se questa data non specificata questo non ha alcun effetto e
quindi il documento sar 'pubblicato' immediatamente.
Data di scadenza
Ti consente di determinare una data di scadenza. Dopo questa data il documento non sar pi
'pubblicato'. Se questa data non specificata questo non ha alcun effetto e quindi il documento
rimarr sempre 'pubblicato'.
Commenti
Fornisce una interfaccia per aggiungere commenti a questo processo di pubblicazione. Questi
commenti possono essere letti da chi revisiona i tuoi contenuti nel loro processo di pubblicazione.
Ugualmente se il revisore respinge (o pubblica) i tuoi contenuti, in grado di aggiungere un
commento, cos potrai sapere perch sono stati respinti.
Cambia stato
Questi sono gli stati in cui pu essere salvato il documento. Tutto ci spiegato dettagliatamente nel
capitolo 4, ma per il momento potresti voler pubblicare i tuoi contenuti, per farlo seleziona "Richiedi
approvazione" e poi 'Salva'.
Il tuo contenuto ora nello stato 'da approvare' e quindi il revisore potr controllare il materiale e decidere se
pubblicare definitivamente il documento.
Aggiunta e modifica di altri tipi di contenuti
Vi sono svariati tipi di contenuti che sono disponibili di default in un sito Plone la cui modifica non viene presentata
nel dettaglio ma per ognuno viene esposta una breve descrizione.
Immagine
Le immagini sono elementi con un contenuto visivo. Questo oggetti hanno usualmente una estensioni del tipo: gif,
jpg, png, tiff o pict. Le immagini possono essere visualizzate direttamente all'interno del sito Plone, senza doverle
-
scaricare sul computer locale semprech il tipo di immagine (dato dall'estensione del nome) sia visualizzabile dal
browser dell'utente.
Quando aggiungi una immagine l'id dell'oggetto cambia con il nome del file dell'immagine. In questo modo se tu
carichi un'immagine dal nome foto.gif, questa sar accessibile in Plone come foto.gif. Quando aggiungi o carichi una
nuova immagine puoi selezionarla direttamente tuo filesystem usando il pulsante 'Sfoglia' e individuando il file che ti
interessa.
Vale la pena di ricordare che spesso i file .pict di Macintosh non sono visualizzabili per default dai browser Microsoft.
File
Un file un qualsiasi file caricabile dal tuo filesystem. Pu contenere del semplice testo oppure qualsiasi tipo di
documento come quelli generati da Microsoft Word, fogli di calcolo Excel, presentazioni PowerPoint, PDF di Acrobat
e cos via. Quando si carica un file utilizzando WEBDAV o FTP per default il contenuto viene rappresentato come file
quando completato lo scaricamento.
Quando aggiungi un file l'id dell'oggetto cambia con il nome del file stesso. In questo modo se tu carichi un file dal
nome libro.pdf, questo sar accessibile in Plone proprio come libro.pdf.
Collegamento
Gli oggetti collegamento sono il modo pi efficace per condividere indirizzi URL. Queste URL possono essere risorse
internet o risorse locali. Il collegamento pu avere propriet (metadata) come qualsiasi altro contenuto. Notare che
per collegare una risorsa internet necessario far precedere il collegamento con il protocollo adeguato (p.es.: http://)
altrimenti il collegamento pu risultare sbagliato.
Puoi aggiungere dei collegamenti alle pagine che ritieni pi interessanti nel tuo sito Plone, i tuoi Favoriti. Per farlo,
basta che clicchi sull'iconcina Plone in alto all'estrema sinistra della barra di navigazione: automaticamente verr
aggiunto un link nella tua cartella che punta alla pagina corrente.
Tema
I temi consentono di creare una raccolta di risorse interrogando la base dati informativa. La richiesta viene definita
mediante una scheda di 'Criteri'.
Il criterio specificato verr applicato ai contenuti catalogati nel sistema. Puoi filtrare oggetti selezionandoli secondo
diversi aspetti: per posizione fisica, tempo di creazione, stato di revisione e molti altri particolari. I temi mantengono
solamente dei collegamenti alle varie risorse, non contengono di per s alcuna informazione come farebbe una
normale directory: essi forniscono una interfaccia di accesso a risorse interconnesse in base a determinati criteri.
Per default solo chi ha il ruolo di 'Manager' pu aggiungere questo tipo di contenuti.
Cartella
I contenitori sono il pi semplice e pi potente meccanismo per organizzare i contenuti del sito. Una cartella un
contenitore che pu contenere a sua volta qualsiasi tipo di oggetto come file, documenti o qualsiasi altro tipo di
contenuto. Per default tutti i tipi di contenuto possono essere associati ad una cartella.
http:///
-
Notizia
Le notizie vengono usate in quasi tutti i siti web. Le notizie pubblicate appaiono in ordine di creazione discendente
nella scheda 'Notizie'. Per essere visualizzata in quella scheda una notizia dev'essere nello stato 'pubblicato'.
Discussione di contenuti
Ogni parte di contenuto pu essere oggetto di 'discussione' in Plone. Il possessore di un certo elemento (generalmente
chi lo ha creato) ha la possibilit di abilitarne i commenti tramite la scheda 'propriet'. Attivando l'opzione 'Consenti
discussione' puoi abilitare i commenti. L'opzione mostrata di 'default' indica la politica di gestione dei contenuti
decisa dall'amministratore del sito.
Se per un contenuto abilitata la discussione quando visualizzato verranno mostrati gli elementi della discussione
(commenti) e all'utente permesso di partecipare. L'amministratore determina come gli utenti possono aggiungere i
commenti.
Ricerca nei contenuti
Ci sono due modi per cercare nei contenuti di un sito Plone. In cima alle pagine del sito c' una casella di ricerca.
Questo campo ti consente solo di cercare per parole chiave nei contenuti del tuo sito. Puoi accorciare la lista dei
risultati usando la funzionalit di 'Ricerca avanzata', disponibile nella scheda 'cerca' in alto nella pagina.
Con il modulo 'ricerca avanzata' puoi trovare contenuti in base a numerosi attributi: titolo, stato di revisione, data di
creazione, tipo di contenuto ed anche per autore.
In questo capitolo abbiamo spiegato alcuni degli elementi di base come aggiungere e pubblicare contenuti, cercare e
modificare le preferenze personali. Ogni sito Plone differente ma nonostante questo ciascuno conserva gli stessi elemen
-
Capitolo 4 - Il controllo del flusso di lavoro
Il workflow il processo usato per gestire gli oggetti in un sito web. Un esempio chiarificatore un annuncio stampa
di una certa ditta: un dipendente scrive l'annuncio e lo sottopone all'editore per una revisione prima di pubblicarlo sul
sito. Questo processo viene chiamato workflow e viene usato dai manager del sito per assicurarsi che il contenuto sia
corretto. Plone ha di serie un sistema di controllo del flusso informativo molto potente e flessibile costruito a partire
dai Stati di un oggetto e dai Ruoli degli utenti.
Stati di un oggetto
Lo stato di un oggetto determina se sia accessibile o meno dai vari tipi di utente definiti da Plone, oltre che in quali
altri stati possa essere traslato. Il workflow di default di Plone include quattro stati: visibile, in revisione, pubblicato e
privato.
I manager del sito e gli sviluppatori possono creare altri stati personalizzati, cosa spiegata nel dettaglio nel Capitolo 5
- Configurazione di Plone.
Di default, gli oggetti sono creati con lo stato di visibile. Tutti gli utenti possono accedere agli oggetti visibili
attraverso le funzioni di ricerca o visitando direttamente l'URL dell'oggetto, anche se non sono visualizzati nel
menu di navigazione e sono contenuti da cartelle private. Questi oggetti sono modificabili da chi li possiede e dagli
amministratori del sito.
Gli oggetti in revisione sono stati sottoposti alla pubblicazione da qualche collaboratore del sito. Dal punto di
vista dell'utente finale, si presentano come gli oggetti visibili. La differenza tra i due stati che quelli in revisione
sono etichettati in modo tale che i revisori del sito possano intervenire pubblicando o rigettando l'oggetto in
questione. Gli oggetti in questo stato sono modificabili solo dai manager.
Una volta pubblicato un oggetto risulta visibile a tutti i visitatori, viene considerato nelle ricerche ed
presente nel menu di navigazione. Quando una Notizia viene pubblicata, diventa visibile sia nel tab che nel
riquadro delle Notizie (vedi Capitolo 5 - Configurazione di Plone). Gli elementi pubblicati sono modificabili solo
dai manager, ma possono essere ritirati da chi li possiede per apportarvi cambiamenti (il ritiro riporta l'oggetto
nello stato visibile).
Gli oggetti privati sono visibili e modificabili sono da chi li possiede e da chi abbia i permessi di manager nella
cartella che li contiene. Non sono considerati nelle ricerche e non appaiono nel menu di navigazione.
Nota: sebbene la maggior parte degli oggetti abbia un proprio stato, alcuni lo derivano dai loro oggetti genitori. I
Forum sono un esempio di questo comportamento. I Forum contenuti in una cartella visibile o pubblicata sono
disponibili a tutti gli utenti attraverso le funzioni di ricerca, mentre quelli dentro una cartella privata sono accessibili
solo agli utenti autorizzati ad accedere a quella cartella.
Ruoli degli utenti
Plone usa i ruoli per definire cosa possono fare e vedere i diversi utenti. In questo modo, Plone tiene sotto controllo gli
aspetti di sicurezza in ogni momento. I ruoli definiti in una installazione di default di Plone includono l'anonimo, il
collaboratore, il possessore, il revisore e il manager.
-
A chiunque acceda al sito senza farsi riconoscere viene dato il ruolo di anonimo. Nei siti pubblici, l'utente
anonimo pu accedere ai documenti pubblicati, in revisione o semplicemente visibili visitando direttamente la
loro URL o cercandoli, anche se nel menu di navigazione compaiono solo gli elementi pubblicati. Se il tuo sito
privato, gli utenti anonimi non possono vedere nulla.
I collaboratori sono quelli che si sono fatti riconoscere inserendo il loro nome e la password. Questi utenti
hanno l'ulteriore possibilit di creare nuovi contenuti nella loro cartella personale, che verranno sottoposti a
revisione per essere pubblicati. Nei siti pubblici, i collaboratori hanno la stessa visibilit degli utenti anonimi,
mentre in quelli privati possono accedere ai contenuti pubblicati, in revisione o visibili. I collaboratori possono
inoltre impostare le proprie preferenze.
Come revisore, hai l'autorit di pubblicare o rigettare i contenuti sottoposti a revisione dai collaboratori.
Quando un revisore accede al sito, se ci sono contenuti da controllare appare un messaggio nella barra personale.
Una lista dei contenuti in revisione appare nella colonna a destra sulla pagina. I revisori hanno gli stessi diritti di
accesso degli altri collaboratori.
I collaboratori sono possessori degli elementi che creano. Questo consente loro di modificarli, sottoporli o
ritirarli dalla revisione oppure di renderli privati. Assegnare il ruolo di possessore a altri utenti non
raccomandato.
I manager del sito possono vedere i contenuti in qualsiasi stato (visible, in revisione, pubblicato o privato).
Oltre alle possibilit degli altri utenti, i manager possono aggiungere, modificare, cancellare o spostare gli oggetti,
oltre che aggiungere, modificare e cancellare gli utenti e assegnare loro i ruoli.
Plone sfrutta il meccanismo di ruoli messo a disposizione da Zope stesso. Consulta il Zope Book per ulteriori
informazioni.
Transizioni - Modificare lo stato degli oggetti
I possessori e i manager possono cambiare lo stato degli oggetti sotto il loro controllo. Gli stati possibili sono
determinati da transizioni predefinite. Ad esempio, i collaboratori possono sottoporre a revisione o rendere privato un
oggetto visibile, e i revisori possono pubblicare o rigettare gli elementi in revisione. I manager possono inoltre
personalizzare questa porzione del workflow (vedi Capitolo 5 - Configurazione di Plone).
Per cambiare lo stato di un'oggetto, nella vista dei contenuti attiva il checkbox di fianco al nome dell'oggetto da
modificare e poi clicca sul pulsante per cambiarne lo stato, in fondo alla pagina. Nella pagina relativa al processo di
pubblicazione, seleziona lo stato che desideri e conferma l'operazione cliccando su submit.
anche possibile cambiare lo stato degli oggetti nella vista normale. Clicca sul tab di stato, scegli quello desiderato e
conferma.
Ruoli locali
Gli amministratori possono dare a utenti specifici dei permessi aggiuntivi in alcune sezioni del sito. Questo pu essere
fatto assegnando loro un ruolo locale in una certa cartella. Sia i manager che i possessori della cartella hanno il
permesso di assegnare dei ruoli locali.
http://www.zope.org/Documentation/Books/ZopeBook
-
Per assegnare un ruolo locale, portati nella vista contenuti della cartella in questione e seleziona il tab Ruoli Locali.
Cerca il nome dell'utente a cui intendi assegnare il ruolo e attiva il checkbox relativo. Poi seleziona il ruolo da
attribuire dalla lista drop-down e clicca sul pulsante assegna il ruolo locale agli utenti selezionati.
La stessa interfaccia pu essere usata per cancellare un ruolo locale.
Pubblicazione di un documento
I possessori di un certo oggetto possono modificarlo quando si trova nello stato visibile. Una volta completata la
modifica, pu essere pubblicato selezionando la tab Stato, che apre il seguente modulo:
Questa maschera ti propone le opzioni:
Stato
Ti dice lo stato corrente del documento
Data di pubblicazione e di ritiro
La data effettiva di pubblicazione indica il primo giorno in cui l'oggetto dovr essere reso disponibile,
mentre quella di ritiro l'ultimo giorno di disponibilit. Le ricerche e il menu di navigazione mostrano
-
gli oggetti in questo arco di tempo. Lasciando vuoti questi campi indica che l'oggetto disponibile
indefinitivamente.
Commenti
Qui si pu inserire qualsiasi commento o motivo alla richiesta di modifica dello stato di
pubblicazione. Questi commenti sono conservati nelle registrazioni dei cambiamenti dell'oggetto.
Cambia stato
Gli stati nei quali pu essere posto l'oggetto. La disponibilit degli stati dipende dal tuo ruolo. I
collaboratori possono mettere in revisione o rendere gli oggetti privati. Una volta messi in revisione,
gli oggetti saranno disponibili ai collaboratori con funzione di revisore, che potranno pubblicarli o
rigettarli.
Revisione dei documenti
Se hai i diritti di revisionare dei documenti al tuo ingresso nel sito Plone ti verr proposta una indicazione se qualche
elemento da revisionare. Questo viene mostrato nella barra principale in questo modo:
Segui questo collegamento per avere l'elenco dei documenti sottoposti per la revisione. Come Revisore ora puoi
selezionare ogni documento e revisionarlo. Entra nella scheda 'stato' e vedrai un modulo come quello sopra. A questo
punto hai praticamente due possibilit: o approvare e quindi pubblicare il documento (opzione 'pubblica') o
respingerlo (opzione 'Respingi'). Se respingi il documento vorrai probabilmente associargli un commento per
spiegarne il perch.
Modifica di un documento dopo la sua pubblicazione
Gli amministratori hanno facolt di modificare gli oggetti in qualsiasi stato si trovino. Ai collaboratori invece non
consentito cambiare un elemento dopo che stato pubblicato: deve prima essere riportato allo stato visibile per
poterlo fare. Per ritirarlo dalla pubblicazione, entra nella scheda di stato e clicca su ritira. A questo punto l'oggetto sar
nuovamente alterabile a piacere e potr essere risottoposto a revisione. Tutto ci assicura che il processo di revisione
sia mantenuto per i documenti che sono stati modificati.
-
Capitolo 5 - Configurazione di Plone
Questo capitolo mostra come sia possibile personalizzare l'aspetto di un sito Plone senza scrivere una sola riga di
codice.
La Zope Management Interface, l'interfaccia di gestione di Zope
Plone si basa su Zope e sul suo Content Management Framework (CMF). Zope dispone di una interfaccia di gestione
(ZMI) accessibile via web. Per la maggior parte delle operazioni quotidiane in Plone, come aggiungere o modificare i
contenuti non ne avrai bisogno. Per manipolare alcune delle funzionalit pi avanzate di Plone per dovrai accedere a
questa interfaccia di gestione.
Per accedervi baster aggiungere /manage in fondo all'URL, come ad esempio in http://localhost/manage. Se hai
usato l'installatore per Mac o per Windows in genere puoi accedere al sito attraverso la porta 80 e alla ZMI usando la
8080. Ad esempio il sito Plone accessibile come http://localhost mentre la ZMI si raggiunge da
http://localhost:8080/manage.
Sulla sinistra appare il menu di navigazione mentre gli oggetti vengono mostrati sulla destra. Per maggiori
informazioni sulla ZMI consulta il Capitolo X dello Zope Book.
Nota: se accedi alla ZMI direttamente alla sua radice, il meccanismo utilizzer l'HTTP Basic Authentication, che non
offre nessuna maniera per potersi scollegare. Questo significa che non sarai in grado di disconnetterti dal sito, non
senza chiudere il browser. Non si tratta di un bug di Plone, quanto piuttosto una manchevolezza nella API del HTTP
Basic Authentication. Per fare i test generalmente preferibile avere due browser aperti, uno puntato alla ZMI, l'altro
al sito Plone.
Struttura di un sito Plone nell'interfaccia di gestione
Un sito Plone composto da una serie di oggetti che sono o dei contenuti o degli strumenti. Accedendo al sito tramite
web non avrai visibilit degli strumenti, la vera forza dietro a Plone e di cui parleremo in questo capitolo. Non tutti
questi strumenti sono unici di Plone, molti di essi provengono direttamente dal CMF. Per ulteriori informazioni su
alcuni riferirsi alla relativa documentazione CMF.
...
Azioni
In Plone alcune funzionalit devono essere azionate in momenti diversi da differenti persone su svariate parti del sito.
Cose come le ricerche, consultare un folder, registrarsi e cos via, sono chiamate Azioni. Plone le realizza nel sito sotto
forma di tab, link e altri elementi. Esse rappresentano un modo molto duttile per inserire gli elementi di navigazione
di un sito. Tali azioni sono modificabili tramite la Zope Management Interface (ZMI) e sono contenute in particolari
posti, come in 'portal_actions'. Gli strumenti che implementano delle azioni sono chiamati action providers.
Azioni in genere
Ogni azione dispone delle seguenti propriet che possono essere impostate nella ZMI:
http://localhost/http://localhost:8080/managehttp://www.zope.org/Documentation/Books/ZopeBook
-
Name
Il riferimento mnemonico all'azione: questo nome usato spesso nella UI, ad esempio quando
l'azione usata come un tab, il testo del tab proviene da questa propriet.
Id
Il riferimento univoco (riferito allo strumento che implementa l'azione) all'azione.
Actions
L'azione da compiere. Per esempio quando l'azione viene usata come un tab, il link associato
proverr da questa propriet. Il valore di questa propriet una espressione TAL, consulta la
documentazione su ZPT per maggiori informazioni.
Condition
Una condizione che deve essere soddisfatta perch l'azione risulti disponibile. Ad esempio, se l'azione
associata a un tab, questo apparir solo se la condizione soddisfatta. Il valore di questa propriet
una espressione TAL, consulta la documentazione su ZPT per maggiori informazioni.
Permission
L'autorizzazione necessaria all'utente per poter disporre di questa azione. E' la condizione che deve
verificarsi poterla utilizzare.
Category
utilizzato per distinguere le azioni per categoria. In Plone viene utilizzato per stabilire quali azioni mostrare
nelle varie parti del sito. Sono disponibili le seguenti categorie:
folder: le azioni in questa categoria sono visibili sui folder
object: sono le azioni visibili sugli oggetti.
portal_tabs: queste azioni sono mostrate in alto sul sito Plone, e sono generalmente "Benvenuto",
"Collaboratori", "Notizie", "Ricerca" e cos via. Le azioni in questa categoria di solito si riferiscono all'intero
portale, piuttosto che a un particolare contenuto.
object_tabs: queste azioni sono visibili al centro della pagina sopra il contenuto. Sono generalmente
specifiche al contenuto, e in molti casi non sono visualizzate se l'utente non ha l'autorizzazione ad
apportarvi modifiche.
folder_buttons: sono i pulsanti che appaiono sulla pagina dei contenuti di un folder, per copiarli o
spostarli, come il copia e incolla.
user: sono le azioni relative all'utente, come "Registrati" e "Iscriviti". Visible
Se la categoria 'visibile' o meno. Si utilizzato questo termine dal momento che le azioni sono
generalmente associate a elementi visuali.
In Plone, l'ordine delle azioni in ogni categoria presentato dalla ZMI determina dove appariranno. Ad esempio,
"Benvenuto" la prima azione e appare all'estrema sinistra del portal tab all'inizio di un sito Plone. Seleziona l'azione
e usa i pulsanti 'Move up' e 'Move down' per spostare l'azione su o gi nella lista.
Action Providers
Gli oggetti che implementano e forniscono le varie azioni sono sfortunatamente sparsi in giro e a volte pu essere
difficile trovare dove sia utilizzata una certa azione. Per ottenere una lista di action providers in un sito Plone,
-
posizionati con la ZMI su 'portal_actions' e seleziona 'Action Providers'. Otterrai l'elenco di tutti gli oggetti che
forniscono un'azione.
Azioni del portale ('portal_actions')
Si tratta di un contenitore generico delle azioni non implementate da altri fornitori. Le pi comuni sono quelle relative
alla categoria 'portal_tabs'.
Azioni relative all'Iscrizione ('portal_membership')
Contiene le azioni associate alla registrazione di un nuovo utente. Generalmente appartengono tutte alla categoria
'user' e appaiono sotto il tab principale del portale, nella configurazione Plone standard. La maggior parte di queste
azioni hanno dei permessi legati a se l'utente loggato oppure no.
Azioni relative all'Identificazione ('portal_registration')
Contiene le azioni relative all'identificazione dell'utente. Di default Plone offre un sola azione, 'join'.
Azioni relative alle Discussioni ('portal_discussion')
Contiene le azioni associabili a una discussione. Di default ne fornita una sola, 'reply'.
Azioni di Undo ('portal_undo')
Contiene le azioni per ripristinare i contenuti, come la undo e la quick undo. Queste azioni forniscono l'interfaccia con
cui l'utente pu ripristinare versioni precedenti dei contenuti.
Distribuzione delle informazioni ('portal_syndication')
Contiene le azioni per distribuire le informazioni sul contenuto. Se desideri attivare questa opzione la devi rendere
visibile. A quel punto, avrai una nuova scheda Syndication che ti dar l'opportunit di condividere le informazioni
con altri siti.
Controllo flusso informativo ('portal_workflow')
Le azioni relative alla gestione del workflow, che discusso nel capitolo XXX.
Configurazione del portale ('portal_properties')
Contiene le azioni per modificare il portale, come la Plone setup che consente di modificare alcuni dei parametri
chiave del sito Plone.
Slot
Uno slot una piccola sezione di una pagina web che racchiude un pezzo di informazione a s. In Plone questi slot
sono localizzati nelle due colonne alla sinistra e alla destra della pagina e contengono informazioni quali il calendario,
gli strumenti per la navigazione, il riquadro di login e cos via. Questi slot possono presentare all'utente sia
informazioni statiche che dinamiche e possono essere facilmente personalizzati attraverso la ZMI.
-
Per configurare uno slot occorre accedervi attraverso la ZMI e selezionare il tab "Properties". Nel caso di Plone, questo
significa selezionare la radice del sito Plone e quindi le sue "Properties". Viene mostrata una lista di propriet, incluse
la 'left_slots' e la 'right_slots' come mostrato qui sotto:
'left_slots' si riferisce agli slot presentati sulla sinistra della pagina mentre 'right_slots' a quelli sulla destra,
nell'ordine indicato. Queste due propriet possono essere modificate qui in modo da coinvolgere l'intero sito,
piuttosto che specificamente in un certo folder attivandosi solo sulle pagine che contiene; ad esempio
nell'installazione standard di Plone puoi notare che il folder Members ha una differente impostazione della propriet
'right_slots'.
Non tutti gli slot disponibili sono configurati in Plone. Di seguito i dettagli di ciascuno, la loro posizione nel filesystem
e il percorso (path) da specificare per rendere visibile lo slot.
Info elemento Nome originale: About Slot
Filename: plone_templates/ui_slots/about_slot.pt
Percorso: here/about_slot/macros/aboutBox
Calendario Nome originale: Calendar Slot
Filename: plone_templates/ui_slots/calendar_slot.pt
Percorso: here/calendar_slot/macros/calendarBox
-
Eventi Nome originale: Events Slot
Filename: plone_templates/ui_slots/events_slot.pt
Percorso: here/events_slot/macros/eventsBox
I miei favoriti Nome originale: Favorites Slot
Filename: plone_templates/ui_slots/favorites_slot.pt
Percorso: here/favorites_slot/macros/favoritesBox
Fatti riconoscere Nome originale: Login Slot
Filename: plone_templates/ui_slots/login_slot.pt
Percorso: here/login_slot/macros/loginBox
-
Esplorazione Nome originale: Navigation Slot
Filename: plone_templates/ui_slots/navigation_slot.pt
Percorso: here/navigation_slot/macros/navigationBox
Lo slot di navigazione mostra una gerarchia dei folder, e offre un semplice ma efficace strumento per navigare nel sito.
Questo slot estremamente personalizzabile, e pu essere modificato accedendo a
'portal_properties/navtree_properties' dalla ZMI.
Ultime notizie Nome originale: News Slot
Filename: plone_templates/ui_slots/news_slot.pt
Percorso: here/news_slot/macros/newsBox
Elenco delle notizie recenti, con un link al loro contenuto. Questo slot non viene visualizzato se non ci sono notizie
pubblicate.
-
Inerenti Nome originale: Related Slot
Filename: plone_templates/ui_slots/related_slot.pt
Percorso: here/related_slot/macros/relatedBox
Mostra un elenco di oggetti correlati, identificati con le parole chiave. Nell'immagine qui sopra ad esempio, la pagina
corrente ha una parola chiave "Python" e vengono quindi visualizzate tutte le pagine con quella parola chiave. Gli
elementi sono divisi in risorse interne e esterne. Anche se attivato, questo slot non viene mostrato se non ci sono
elementi correlati.
Revisioni Nome originale: Review Slot
Filename: plone_templates/ui_slots/review_slot.pt
Percorso: here/review_slot/macros/reviewBox
Visualizza gli oggetti che sono nello stato di revisione e attendono di essere verificati. Viene mostrato solo se l'utente
ha l'autorizzazione necessaria e se ci sono elementi in attesa. Il numero di oggetti viene mostrato anche nella barra di
navigazione, come mostrato qui:
Aggiungere un proprio slot
L'uso delle espressioni di percorso per produrre uno slot uno strumento molto potente. Ti consente di inserire
praticamente qualsiasi tipo di contenuto di un oggetto in uno slot: Plone trover il risultato dell'espressione e lo
visualizzer. Ad esempio, volendo visualizzare un certo oggetto Poll in uno slot, baster inserirne il suo percorso, ad
esempio here/polls/risateadentistretti/poll_principale_view (nota: questo solo un esempio, che non funziona in
una installazione standard di Plone). Le espressioni di percorso sono una funzionalit chiave sia di Zope che di Plone:
per maggiori informazioni vedi...
-
Se necessiti di un tuo slot personalizzato, molto probabilmente dovrai aggiungere un Page Template con il corretto
HTML e costrutti TAL: per maggiori informazioni consulta...
Navigazione e Maschere Distribuzione dei contenuti (Syndication)
La syndication la capacit di accedere ai contenuti di una cartella tramite RSS (Really Simple Syndication o Rich Site
Summary). L'RSS produce una lista di tutti gli oggetti in un folder. Questo sommario pu essere letto
automaticamente da diversi programmi che trattano le notizie.
Per abilitare la distribuzione dei contenuti, ispeziona nella ZMI l'oggetto portal_syndication. Contiene una azione
sulle cartelle, chiamata Syndication, che non visibile di default. Impostala a visibile. Per attivare anche quella
generale a livello di sito, nelle propriet del sito clicca su abilita la syndication.
Qualsiasi cartella a questo punto avr una scheda Syndication, ma non viene attivata automaticamente; devi farlo
esplicitamente per ogni folder che ti interessa: nella cartella, entra nella scheda Syndication dove trovi un semplice
pulsante che ti consente di farlo. Se ottieni il messaggio La syndication non abilitata, ritorna nel portal_syndication
e assicurati di averla abilitata nella scheda delle propriet.
Ecco alcuni dei valori sulla pagina di syndication, una volta abilitata:
Update Period
Con che frequenza il client dovrebbe controllare se il flusso RSS aggiornato.
Update Frequency
...
Update Base
...
Maximum Items
Il numero massimo di elementi da visualizzare
Nota: il meccanismo non visita ricorsivamente le sottocartelle, ma consulta esclusivamente la cartella corrente e i suoi
contenuti pubblicati.
-
Capitolo 6 - Personalizzare il look&feel di Plone
Questo capitolo indica come modificare quasi ogni aspetto di un sito Plone spiegando nel dettaglio ciascun elemento
della pagina, le skin e come mettere insieme il tutto
Concetti di baseSkin
Uno skin una specie di guscio che racchiude un certo contenuto. Pu anche contenere piccole porzioni della logica
relativa alla sua rappresentazione visuale. Quando installi Plone puoi vederne il suo skin di default, quello a cui la
maggior parte degli utenti abituata e usato da plone.org e altri siti. Scrivendo un nuovo skin puoi cambiare
radicalmente come si presenta il sito, pur mantenendo una interazione simile a quella originale di Plone. Vedi
zopezen.org o zopera.org per degli esempi.
Plone per non deve necessariamente somigliare, o anche essere lontanamente rinoscibile come un sito Plone,
volendo ottenere un sito completamente personalizzato. Considera, ad esempio, la lista di siti che puoi trovare qui:
ciascuno implementa un ambiente completamente differente, dal punto di vista d