Plone Book Italiano

2005

formatted in PDF by Andrea Torre

andrea.torre@gmail.com

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:anonymous@cvs.plone.sourceforge.net:/cvsroot/plone login cvs -d:pserver:anonymous@cvs.plone.sourceforge.net:/cvsroot/plone co -r Plone-1_0 CMFPlone cvs -d:pserver:anonymous@cvs.formulator.sourceforge.net:/cvsroot/formulator co Formulator cvs -d:pserver:anonymous@cvs.zope.org:/cvs-repository login cvs -d:pserver:anonymous@cvs.zope.org:/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:anonymous@cvs.plone.sourceforge.net:/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