Creazione di portlet statiche in Plone 3.0

Introduzione

Plone.portlet.static è un altro grande contributo di Martin Aspeli. E 'molto utile se si desidera un tipo di portlet che possa facilmente modificare contenuti statici in html e avere un'immagine spash , flash video o l'iscrizione con email visualizzata sul proprio sito. Proseguirò su come impostare questo in un unico installer o installare un buildout di Plone, mostrerò un esempio su come personalizzare i portlet per non visualizzare il titolo e descriverò alcuni esempi del suo uso.

Basic Setup

Install in Unified Installer build of Plone 3

Il primo passo è quello di installare easy_install:

$ wget http://peak.telecommunity.com/dist/ez_setup.py

$ sudo /opt/Plone-3.0.2/bin/python ez_setup.py -U setuptools

Questo installerà easy_install in /opt/Plone-3.0.2/Python-2.4.4/bin

Successivamente si può installare plone.portlet.static coi seguenti passaggi:

1. Installare il package in /opt/Plone-3.0.2/Python-2.4.4/lib/python2.4/site-packages directory:

$ sudo ./Python-2.4.4/bin/easy_install plone.portlet.static

2. Aggiungere il zcml slug in /opt/Plone-3.0.2/zeocluster/client2/etc/packages-includes folder, il file si chiama "plone.portlet.static-configure.zcml" e contiene:

<include package="plone.portlet.static" file="configure.zcml" />

Bisognerà copiare questo file dalla cartella client1 packages-includes al fine di traformare questo pacchetto di lavoro nel primo zeocluster client.

3. Riavviare l'istanza zope:

$  sudo /opt/Plone-3.0.2/zeocluster/bin/restartcluster.sh

4. Installare il prodotto via "Add Remove Products"

Installing in a buildout build of Plone 3

Se si dispone di una installazione di plone usando buildout  la procedura per l'installazione è abbastanza facile.

1. Aggiungere "plone.portlet.static" alla lista degli eggs e alla sezione "zcml" in buildout.cfg

2. Eseguire ./bin/buildout

3. Avviare l'istanza zope "./bin/instance fg"

4. Installare la nuova vista del prodotto "Add Remove Products" o il plone_quickinstaller. Ho usato "Add Remove Products" all'interno del sito plone.

Il passo successivo

Aggiunta di un portlet statico al sito

La procedura per aggiungere un portlet statico è:

1. Fare clic sul link  "Manage portlet" in fondo alle portlets.

2. Da "Add portlet" selezionare "Static text portlet"

3. Immettere un titolo per il portlet, questo è richiesto. Si potrebbe anche voler personalizzare il pacchetto del portlet statico ma questo non è richiesto, o fornire un opzione se visualizzarelo o meno.

4. Inserire  l'html nell'area "Text", questo sarà reso nel portlet.

5. Inserire un piè di pagina se si desidera (opzionale)

6. Inserire un link a cui vui si riferiscano  l'intestazione e il piè di pagina (opzionale)

Rendere opzionale il portlet dell'intestazione

Così come il nostro web manager vuole essere in grado di utilizzare questo Portlet per visualizzare il link ad una immagine o ad un flash video, noi abbiamo bisogno di rendere la visualizzazione del portlet facoltativa. E 'abbastanza facile modificare static.py e il file static.pt in modo che l'intestazione non sia necessaria. L'unico problema di non aver compilato il titolo è che esso viene utilizzato nella gestione dei portlet per vedere quali sono i nomi dei singoli portlet . Per aggirare ciò, ho creato un altro campo "portlet_title" e l'ho utilizzato nella vista "static.pt"

Qui il collegamento alle nuove versioni di static.pt e static.py

ll web manager può ora creare un portlet di testo statico e lasciare vuoto il Portlet Title e avere solo il codice html che è stato inserito nella parte di testo visualizzato.

Credits