L'intestazione

Normalmente l'intestazione consiste di un logo, di un campo di ricerca, di vari collegamenti utili e della traccia di navigazione.

Figura 2 - L'area di intestazione di un sito standard

Le colonne laterali

Contengono a loro volta dei box che possono essere utili alla interazione del visitatore con le azioni del portale, alla navigazione nel sito o possono dare informazioni. Plone, nella versione standard, può mostrare vari elementi predefiniti che l'amministratore può attivare o disattivare con estrema flessibilità in base allo scopo a alle esigenze del sito.

Per esempio sarà possibile trovare:

Box accedi

Figura 6 - Il box accedi

Se si è detto al proprio browser di ricordare il nome utente e la password di un precedente login nel sito Plone, un cookie lo ricorderà consentendo una registrazione rapida premendo solo il pulsante accedi.

Il box accedi consente il login nel sito. Offre anche un collegamento ad un modulo utile in caso di smarrimento della password e al modulo di iscrizione.

Box calendario

Segnala gli avvenimenti del mese corrente ed evidenzia la data del giorno con un riquadro rosso.

Per spostarsi di un mese in avanti o indietro si possono utilizzare le freccette poste negli angoli in alto.

Figura 7 - Il box calendario

Se il sito gestisce gli avvenimenti, le date associate agli avvenimenti vengono messe in risalto. Cliccando su una di quelle date si accederà alle informazioni associate e/o relative agli avvenimenti di quel giorno.

È predisposto per poter interagire con strumenti esterni come iCalendar e vCalendar.

Box navigazione

Il box della navigazione presenta un albero dei contenuti analogo a quello di molti strumenti di esplorazione dei vari Sistemi Operativi (le differenti cartelle e i loro contenuti). Come per la traccia di navigazione vista in precedenza, consente di sapere dove ci si trova nel sito e di spostarsi cliccando direttamente sulla sezione desiderata.

Figura 8 - Il box navigazione

Box favoriti

Figura 9 - Il box favoriti

I favoriti sono i collegamenti personali ad oggetti del sito. Vengono aggiunti tramite l'icona cuoricino che si trova tra le azioni rapide in alto a destra del contenuto e possono essere riorganizzati con il collegamento in basso a destra "Altro".

Box ultime notizie

Figura 10 - Il box ultime notizie

Box da esaminare

Questo box viene mostrato solo ai revisori. Contiene l'elenco dei documenti in attesa di approvazione.

Figura 11 - Il box da esaminare

Box modifiche recenti

I documenti che sono stati modificati di recente

Figura 12 - Il box modifiche recenti

La parte centrale

Contiene il contenuto dell'oggetto visualizzato.

Se il visitatore è autenticato viene mostrata anche la barra del contenuto in alto della parte centrale. In base al tipo di oggetto e ai permessi del visitatore essa contiene i menù con le azioni disponibili per l'elemento.

La barra del contenuto

Figura 13 - La barra del contenuto di una cartella

Nella figura precedente si può notare la presenza della scheda contenuti che è presente solo per gli oggetti contenitori.

Notare, all'estrema destra, lo stato dell'oggetto: bozza pubblica.

Le schede della barra del contenuto

La barra del contenuto contiene solitamente dei menù e sul bordo superiore possono sporgere alcune schede:

visualizza

mostra il contenuto dell'oggetto attivo

Per gli oggetti contenitori (cartelle, album fotografici), la visualizzazione degli oggetti contenuti, viene effettuata con la modalità evidenziata nel menù vista della barra del contenuto.

Per cambiare modalità di visualizzazione degli elementi contenuti o per scegliere uno degli elementi da usare come vista predefinita, scegliere la voce di menù desiderata.

modifica

mostra il modulo standard per la gestione del tipo di contenuto dell'oggetto attivo. Consente la modifica dei principali metadati e del contenuto dell'elemento selezionato.

Nella scheda modifica è possibile attivare i commenti al contenuto o inserire i contenuti correlati.

I collegamenti ai contenuti correlati appariranno poi in un riquadro in fondo alla pagina, dopo il contenuto con, di seguito, il pulsante aggiungi commento e i commenti già inseriti.

proprietà

contiene altri metadati generici e specifici del tipo di oggetto attivo. È possibile associare all'elemento parole chiave, date di accesso e di scadenza, autori e contributi, licenza e altro.

trasforma

solo per gli oggetti immagine: consente la rotazione e il ribaltamento dell'immagine.

condivisione

è la scheda dove è possibile regolare l'accesso all'elemento su base locale. Vengono mostrati gli utenti e i gruppi che possono accedere all'elemento e i loro permessi (ereditati o assegnati localmente).

I menù della barra del contenuto

I menù della barra del contenuto possono variare in base al tipo di oggetto, ai permessi del visitatore e allo stato dell'oggetto.

I menù principali sono azioni, aggiungi alla cartella e stato. Vedi Aggiunta e modifica di un contenuto

Le azioni rapide

In base al tipo di oggetto visualizzato e alle autorizzazioni che si hanno su di esso, in alto a destra del "Titolo" compaiono le icone delle azioni che si possono applicare direttamente al documento visualizzato.

Figura 14 - Icone delle azioni rapide disponibili per l'oggetto visualizzato

Da sinistra a destra le azioni della figura precedente permettono di:

• inviare il collegamento all'elemento corrente a qualcuno
• stampare il contenuto dell'elemento corrente
• aggiungere ai favoriti il collegamento all'elemento corrente
• espandere il contenuto dell'elemento corrente a tutta pagina (la parte centrale del sito)
• modificare il documento con un editor esterno

Il contenuto

La visualizzazione dell'oggetto correntemente selezionato avviene nella parte centrale del sito, con modi diversi, in base al tipo di contenuto e al ruolo del visitatore. Per ogni oggetto vi sono almeno due viste possibili: la modalità modifica e la modalità visualizza. (vedi Le schede della barra del contenuto).

Quando il visitatore anonimo visita un oggetto, Plone gli mostra il contenuto della scheda visualizza (NB: solo il contenuto, senza bordi e senza possibilità di cambiare vista).

La modalità visualizza mostra gli oggetti come se li aspetta l'utente finale e come li usiamo abitualmente. I contenuti testuali sono regolarmente formattati e contengono anche eventuali immagini e collegamenti funzionanti. Gli oggetti immagine sono mostrati in dimensioni opportune (una immagine troppo grande viene ridotta in modo che sia completamente visibile) con i titoli e i metadati principali [1]. Quando si richiede (si clicca) un oggetto file questo viene inviato ed è così possibile utilizzarlo liberamente anche salvandolo localmente se necessario. Un evento viene mostrato come lo farebbe una locandina tradizionale con i suoi testi, le scadenze e i collegamenti. Ecc..

È possibile forzare la visualizzazione dei metadati degli oggetti non testuali (p.es. file) aggiungendo /view all'URL dell'oggetto (p. es. http://scr.artiemestieri.tn.it/Members/lallo/rst-mode.el/view). NB: questo è quello che fa sempre Plone quando si parte da una vista contenuti.

La scheda modifica e le eventuali altre schede di visualizzazione dei metadati dell'oggetto sono generalmente disponibili solo all'utente autenticato e in possesso dei permessi edeguati.

[1]	vedi per esempio come viene mostrata una immagine più grande dell'area centrale: Immagine grande. Da notare come in questi casi Plone aggiunga un collegamento sotto l'immagine ridotta per poter visualizzare l'immagine nelle sue dimensioni originali.

I commenti al contenuto

Se nei metadati di un oggetto (scheda modifica) sono abilitati i commenti [2], quando ne viene visualizzato il contenuto, in fondo alla parte centrale della pagina viene aggiunto un pulsante:

Figura 15 - Pulsante aggiungi commento

Premendo il pulsante aggiungi commento è possibile ottenere un apposito editor ed associare un argomento ed un testo di commento all'oggetto corrente:

Fig. 16 - Editor commento

Che dopo la conferma darà un risultato del tipo:

Fig. 17 - Un primo commento

Ripetute operazioni di commento e di risposta consentono di aggiungere all'oggetto vere è proprie discussioni che saranno organizzate per argomenti:

Fig. 18 - La discussione

[2]	Per ogni oggetto, in fondo alla scheda modifica, è possibile attivare i commenti Questa opzione è normalmente disabilitata

I contenuti correlati

Nella scheda modifica di ciascun oggetto, verso il fondo, c'è la sezione Contenuti correlati con cui è possibile creare dei collegamenti ad altri materiali del sito.

Figura 19 - La sezione Contenuti correlati della scheda modifica

L'aggiunta e l'eliminazione di collegamenti a contenuti correlati è facilitata da un apposito editor:

Figura 20 - Editor dei collegamenti ai contenuti correlati

I contenuti correlati sono mostrati nella parte centrale, tra il contenuto ed i commenti come nella seguente figura:

Figura 21 - Il riquadro Contenuti correlati viene mostrato tra il Contenuto e i Commenti

Piè pagina

Ha una funzione principalmente estetica e quindi è in funzione del tipo di sito. Spesso contiene i collegamenti per tornare all'inizio della pagina e alla mappa del sito.

La cartella personale

Figura 22 - La vista contenuti della cartella personale

La cartella personale è l'area di competenza dell'utente. Egli ne è il "possessore" e qui egli ha i diritti di manager.

In un situazione standard l'utente lavora nella propria cartella creando, modificando ed eliminando liberamente gli oggetti. Se e quando lo ritiene opportuno li sottopone a revisione per la pubblicazione o li ritira.

Tramite la scheda condivisione può regolare atomicamente l'accesso ai suoi lavori e la concessione di permessi ad altri utenti o gruppi.

Il controllo di flusso (workflow)

È il meccanismo che consente di regolare la visualizzazione e di approvare la eventuale pubblicazione di un contenuto da parte di qualcuno e che si mette in atto prima della pubblicazione stessa: è un sistema di revisione molto evoluto.

Il controllo di flusso è un circuito di revisione dei contenuti. È composto da stati che vengono assegnati agli oggetti da pubblicare. Lo stato di un oggetto è modificabile. La modifica dello stato di un oggetto si attua tramite una transizione.

Per esempio, secondo il workflow standard, la transizione sottoponi a revisione cambia lo stato di un documento da bozza pubblica a in revisione. Questa azione viene effettuata ogni volta che un utente vuole la pubblicazione del contenuto. L'utente sottopone l'oggetto da lui creato o modificato all'esame e quindi alla approvazione o disapprovazione da parte di un responsabile del processo di pubblicazione.

La transizione inversa è revoca la pubblicazione. Cambia lo stato di un documento da in revisione a bozza pubblica. Viene effettuata dall'utente quando non vuole più che il documento in questione venga pubblicato. (NB: questa transizione non è mostrata nel diagramma successivo)

Le transizioni di competenza dei revisori sono pubblica o respingi. Con la prima l'oggetto passa dallo stato in revisione allo stato pubblicato e diventa visibile a chiunque ma non più modificabile. La seconda cambia lo stato da in revisione a privato ed è usata quando il revisore non vuole che il documento in questione sia pubblicato.

Nello schema che segue le transizioni sono rappresentate da frecce. La punta della freccia indica lo stato finale, l'inizio lo stato originale.

Figura 23 - Diagramma del controllo di flusso di pubblicazione standard di Plone per i ruoli di Possessore e di Revisore.

L'uso di un controllo di flusso mette a disposizione altri servizi per la gestione della pubblicazione e permette una certa flessibilità nella matrice di pubblicazione. Per esempio l'uso della data di pubblicazione e/o di ritiro dell'informazione oppure la scelta di una certa categoria di lettori.

L'autenticazione

Alcune spiegazioni

Se l'utente non è autenticato significa che per Plone egli è un utente "anonimo" e quindi non gli vengono concesse alcune funzionalità.

Figura 24 - Barra dell'intestazione - collegamenti per l'autenticazione

In questo caso viene proposta la possibilità di autenticarsi. Se si forniscono un nome e una password validi il messaggio "non sei un utente conosciuto" si trasformerà nel proprio login e proporrà tutti gli accessi relativi al proprio compito (cartella personale, preferenze, ecc.). Vedi informazioni personali

Creazione di un nuovo utente

(Attenzione: questa funzionalità può non essere disponibile)

Se non ci si è mai autenticati in precedenza ci si deve iscrivere al sito utilizzando l'accesso "iscriviti" che compare a destra nella barra dell'intestazione.

Verrà visualizzato un modulo [3] che si dovrà compilare secondo le indicazioni mostrate.

Una volta iscritti basterà aprire una sessione per ritrovarsi autenticati.

[3]	NB: nel caso di smarrimento, qui c'è l'indirizzo e-mail a cui verrà spedita la password in caso di richiesta.

Ruoli e permessi

Ruoli standard

I quattro ruoli più utilizzati nei siti di gestione dei contenuti Plone sono l'anonimo, il collaboratore, il revisore (o moderatore) e l'amministratore. Il ruolo di autenticato definisce il gruppo di tutti gli utenti non anonimi.

Anonimo

rappresenta tutti gli utilizzatori del sito non autenticati. Ha diritti molto limitati.

Può visitare i contenuti delle sezioni del sito laddove, eventualmente, gli è stata data l'autorizzazione.

Collaboratore

produce e propone i contenuti del sito. Dopo aver scritto un testo lo sottopone all'approvazione del revisore.

Revisore

può autorizzare la pubblicazione dei contenuti creati e sottoposti dai collaboratori. Se la rifiuta, lo stato del contenuto diventa "privato" (potrà essere visto solo dal "possessore"). Se il revisore pubblica, lo stato del contenuto diventa "pubblicato" (tutti gli utenti lo possono vedere).

Amministratore

è un ruolo tecnico. Può modificare il sito, il controllo di flusso, i ruoli, ecc..

Il principio

Il contenuto di un sito Plone può essere creato e mantenuto dagli utenti.

Plone usa un sistema di pubblicazione per cui, in base al proprio ruolo, ciascuno può sottoporre e/o contribuire ai contenuti per i quali ha i necessari permessi.

Il controllo di flusso (workflow) è la base del sistema di pubblicazione.

Aggiunta e modifica di un contenuto

Prima di aggiungere o di modificare qualsiasi contenuto di un sito Plone, bisogna effettuare L'Autenticazione, ovvero essere autenticati nel sito con un login (nomeutente + password) che abbia il permesso, perlomeno in una certa area, di aggiungere e modificare i contenuti.

Per contenuto si intende uno dei tipi di oggetti che ci sono in Plone. Tra gli oggetti usati frequentemente dall'utente finale ci sono, per esempio, documenti di testo, immagini, file, eventi, notizie, collegamenti ma anche contenitori come cartelle e album fotografici. Alcuni contenuti possono avere anche contenuti correlati, ecc..

Il tipo di contenuto può essere scelto e aggiunto con il menù "aggiungi alla cartella" in alto a destra, nella barra del contenuto.

Figura 25 - Il menù "aggiungi alla cartella" con gli oggetti disponibili

Dopo aver scelto il tipo di oggetto che si vuole aggiungere, appare un modulo [4] che consente l'introduzione e la modifica dei metadati dell'oggetto e l'inserimento/caricamento del contenuto. I campi obbligatori sono segnalati da un quadratino rosso.

È possibile caricare il contenuto dell'oggetto direttamente da un file tramite una apposita sezione del modulo come ad esempio:

Figura 26 - La sezione "carica da file" del modulo documento

Quando si crea un nuovo oggetto Plone fornisce il modulo giusto per l'inserimento di quel tipo di contenuto. Il modulo ha la struttura dei metadati adatta al tipo di oggetto prescelto.

Nel caso di una nuova pagina il modulo è quello mostrato nella figura della sezione Aggiunta di una nuova pagina.

L'inserimento degli altri oggetti standard avviene con i rispettivi moduli. Di seguito sono elencati i collegamenti alle immagini dei moduli di inserimento dei principali oggetti Plone, delle proprietà aggiuntive e di come l'inserimento del nuovo oggetto viene riflesso nell'ambiente

• Nuovo evento, Altri dati del nuovo evento, L'evento di prova
• Nuova notizia, Altri dati della nuova notizia

Salvataggio delle modifiche

Ogni volta che si salvano delle modifiche affettuate su un oggetto dentro Plone (tramite gli strumenti di Plone), viene restituita la visualizzazione corrente dell'oggetto con un messaggio di conferma:

Figura 27 - Il messaggio di conferma dopo una modifica

Aggiunta di una nuova pagina

Quando si aggiunge una nuova pagina (documento di testo) al sito viene fornito un modulo come questo:

Figura 28 - Il modulo del nuovo documento di testo (pagina)

che deve essere utilizzato come abbiamo descritto in precedenza.

Pubblicazione e ritiro di un contenuto

La pubblicazione di un contenuto segue il meccanismo trattato nella sezione Il controllo di flusso (workflow).

L'impostazione predefinita (bozza pubblica) è che un contenuto non sia automaticamente pubblicato e disponibile al mondo; altri lo possono vedere ma non appare nelle ricerche o nell'albero di navigazione. È uno stato molto utile perché si può far puntare altri a quel contenuto ma, siccome non appare nella navigazione e nelle ricerche , non è visibile a meno che gli utenti non lo conoscano.

In ogni istante, ciascun elemento dei contenuti del nostro sito Plone è in un determinato stato. Avendo elementi in stati differenti è possibile applicare differenti gradi di sicurezza a ciascun elemento di contenuto. Per esempio, a volte, per preparare un elemento si può impiegare una o due settimane e magari più revisioni. Poi, probabilmente, vorremo pubblicare il contenuto in modo che sia visibile da tutti gli utenti e sia mostrato nell'albero di navigazione e nelle ricerche.

Si può richiedere la pubblicazione del contenuto utilizzando il menù stato posto nell'angolo in alto a destra del contenuto stesso, scegliendo la voce sottoponi a revisione.

Non è possibile pubblicare direttamente il nostro contenuto, per default lo si deve sottoporre a revisione. Quando un elemento viene sottoposto a revisione passa allo stato in revisione. Questo è uno stato intermedio tra bozza pubblica e pubblicato. Permette la revisione del contenuto da parte di utenti del sito con il ruolo di revisore prima che diventi disponibile alla vista a tutto il mondo. Dopo aver proposto il contenuto si può notare che è nello stato in revisione guardando nell'angolo in alto a destra. Notiamo inoltre che non c'è più la scheda modifica.

Uso di Kupu

Una barra a tutta larghezza appare sopra l'area che contiene il testo.

Figura 29 - La barra principale di Kupu

Molte delle funzioni che vengono attivate dai pulsanti della barra sono autoesplicative, altre meno. Alcune si usano frequentemente, altre raramente. Se ci si sofferma su un pulsante con il mouse viene mostrato una breve descrizione dello strumento. Di seguito ecco una breve spiegazione dell'uso dei pulsanti.

	Questi pulsanti scambiano il modo come è evidenziato il testo: normale, grassetto, italico, sovrascritto, sottoscritto. Svolgono un ruolo praticamente identico ai comandi di formattazione di un normale word processor.
	Allinemento del testo (giustificazione a sinistra, al centro o a destra. Si applicano ad un intero paragrafo. Anche qui similmente ad un normale word processor.
	Liste puntate,liste numerate e liste di definizioni. È consigliabile utilizzare questi pulsanti anziché provare ad inserire manualmente numeri e puntatori. Per terminare una lista puntata o numerata cancellare l'ultimo elemento o premere Enter due volte. Le liste di definizioni sono liste che presentano righe in grassetto alternate a righe formattate normalmente. Esempio: Prima definizione prima descrizione Seconda definizione seconda descrizione Le liste di definizioni non sono molto utilizzate.
	Aumento o diminuzione dell'indentazione di un paragrafo. Questi pulsanti vengono spesso usati nella formattazione di testi con quotature e citazioni.
	Inserimento di una immagine. Questo pulsante apre uno strumento che consente di sfogliare il sito per trovare l'immagine che si desidera, piuttosto che caricarne una nuova. L'immagine viene posizionata direttamente dentro il testo del documento Altre opzioni sono disponibili per determinare il modo in cui l'immagine deve essere mostrata: testo alternativo - viene mostrato se l'immagine non può essere mostrata spaziatura - determina lo spazio verticale e orizzontale attorno all'immagine.
	Inserimento di collegamenti interni ed esterni. Consentono l'inserimento di collegamenti ad altre pagine del sito oppure a risorse in internet.
	Inserimento di una tabella. L'interfaccia di questo strumento non è proprio intuitiva, ma spesso è utile. Se serve una tabella più complessa la si deve scrivere in html o cambiare il formato del testo (utilizzando un editor testuale anziché kupu). Una finestra di dialogo consente di scegliere il tipo di tabella, inserire il numero di righe, di colonne, ed altri attributi della tabella e delle celle (p.es se le colonne debbano avere un titolo, ecc.). Usato quando ci si trova in una tabella esistente, consente la modifica delle proprietà della tabella. Creata la tabella si può procedere al riempimento delle celle. Se non si vede la tabella controllare che l'opzione "bordo visibile" sia attiva. La larghezza e l'altezza della tabella sono modificabili. Quando si clicca su un elemento della tabella appaiono delle maniglie e dei pulsanti che consentono le modifiche volute, compresa l'aggiunta o la rimozione di righe e colonne. sopra
	Annulla o ripeti le azioni precedenti (fino al precedente salvataggio). Le azioni avviate con questi pulsanti possono avere vari livelli di successo.
	Controllo ortografico del testo
	Mostra e modifica direttamente il codice HTML
	Massimizza o demassimizza la finestra contenente il testo.

Linguaggi di formattazione del testo

L'editor non grafico (come pure qualsiasi Editor esterno a Plone) consente l'utilizzo diretto dei vari linguaggi di formattazione per documenti, alcuni dei quali sono riconosciuti e utilizzati abitualmente in Plone. La scelta può essere fatta al momento della creazione del documento, tramite l'apposito elenco a cascata:

Figura 31 - Linguaggi di formattazione del testo disponibili

Come si vede è possibile scrivere le proprie pagine tramite i linguaggi di formattazione per ipertesti più diffusi:

L'HTML è assai duro da scrivere direttamente (ed esistono appositi strumenti, tra cui L'editor grafico Kupu, che lo scrivono per noi, lasciandoci concentrare sui contenuti). Non è consigliabile che l'utente inesperto si avventuri nello studio di questo linguaggio in quanto ve ne sono di migliori che consentono di ottenere ottimi risultati nella gestione degli ipertesti.

Lo StructuredText e ancor più il reStructuredText hanno tutte le funzionalità per la formattazione e la strutturazione del documento e per collegare risorse esterne ma adottano una marcatura molto più leggera dell'HTML. Scrivere documenti risulta quindi più semplice e il documento è più facilmente leggibile e condivisibile consentendo all'utente di rimanere concentrato sul contenuto senza essere distratto dalle continue pesanti marcature dentro il testo che ci sono nell'HTML.

È possibile inserire anche del testo grezzo che sarà trattato come tale senza venir interpretato da alcun parser.

L'insegnamento di un linguaggio di formattazione del testo esula dagli scopi e dalle pretese di questo documento. Per ottenere il massimo da un sito Plone, è comunque importante capirne l'utilità e l'importanza. Conoscere un modo per controllare pienamente un ipertesto web scrivendo il suo codice con una certa semplicità, come quando si scrivono delle istruzioni per qualcuno, cioè con la massima precisione ma anche con la massima chiarezza, consente di creare pagine più gradevoli ed omogenee, di utilizzare contenuti dinamici e di riutilizzare gli oggetti esistenti.

Come funziona

Il meccanismo è composto di due parti:

parte server

è un componente di Plone e deve essere attivato dall'amministratore.

Il suo compito consiste sostanzialmente nel

• inscatolare l'effettivo contenuto dell'elemento che si vuole modificare
• spedirlo al browser, marcandolo con un determinato 'content-type'
• assicurare il blocco di eventuali richieste di modifica per lo stesso oggetto da parte di altri fino al distacco del editor

parte client

è una piccola applicazione che deve essere presente sul pc da dove si lavora e che si installa facilmente.

Consente al nostro browser di riconoscere la particolare richiesta dei siti Plone quando si preme sull'icona matitina e di gestirla esternamente facendosi carico di:

• riconoscere il tipo di contenuto
• lanciarlo nell'editor opportuno
• ogni qualvolta il file viene salvato, reinscatolarlo nuovamente spedendolo al server Zope che accetterà la modifica all'oggetto
• chiudere correttamente la connessione con lo sblocco dell'oggetto sul lato server alla chiusura dell'editor

Come si installa il client?

Le istruzioni dettagliate per installare il client dell'external editor sono disponibili sia per la versione windows che linux. (in inglese).

In windows è sufficente usare il solito installer (luglio 2006 versione 0.9.1).

In Linux basta installare il pacchetto zopeedit della propria distribuzione.

Come si configura?

Una volta installata l'applicazione client il passaggio successivo è istruire il browser affinché utilizzi lo strumento d'appoggio che abbiamo appena installato (zopeedit) in modo che gestisca appropriatamente questo tipo di richieste (quelle cioè che hanno il mime type "application/x-zope-edit").

Quando il browser incontra per la prima volta un nuovo tipo di richiesta normalmente chiede cosa deve fare. Basterà registrare il nuovo tipo "application/x-zope-edit" associando l'eseguibile dell'applicazione di aiuto (in linux è normalmente /usr/local/bin/zopeedit.py, in windows è solitamente C:ProgrammiZopeExternalEditorzopeedit.py)

L'ultimo passo è quello di dire alla nostra applicazione locale quali strumenti utilizzare a seconda del tipo di contenuto che arriva da Plone.

L'installazione standard predispone un file di configurazione personale che normalmente non necessita di ulteriori interventi in quanto usa le medesime estensioni dei file registrati nel sistema. Se così non fosse sarà necessario modificare il file di configurazione che in windows è normalmente ~ZopeEdit.ini mentre in linux è ~/.zope-external-edit.

Come editor predefinito per i documenti si deve inserire una riga del tipo:

[general] 
editor = \Programmi\SciTE.exe

Per ogni tipo di file (estensione) che si desidera modificare utilizzando uno strumento locale si dovrà invece inserire una sezione di questo tipo:

[content-type:application/vnd.ms-excel]
extension = .xls
editor = excel

oppure, un esempio in ambiente linux:

[general] 
editor = /usr/bin/emacs

[content-type:image/gif]
extension = .gif
editor = gimp

[content-type:application/vnd.ms-excel]
extension=.xls
editor=oocalc

[content-type:application/msword]
extension=.doc
editor=oowriter

[content-type:application/vnd.oasis.opendocument.spreadsheet]
extension=.ods
editor=oocalc

[content-type:application/vnd.oasis.opendocument.text]
extension=.odt
editor=oowriter

[content-type:application/vnd.sun.xml.writer]
extension=.sxw
editor=oowriter