Pour Ubuntu

Si vous êtes sur Ubuntu, commencez par vous identifier en tant que super utilisateur:

command sudo -s

Installation

En premier lieu, installez les dépendances de construction et wget:

command apt-get install wget gcc g++ make tar gzip bzip2 libssl-dev \
                         zlib1g-dev libjpeg62-dev libreadline5-dev \
                         readline-common libxml2-dev libxslt1-dev wv xpdf \
                         libssl-dev libfreetype6-dev

Renseignez la version à télécharger:

VERSION=3.2.1r4

Et téléchargez Plone:

VERSION_MAJOR=$(echo ${VERSION} | /bin/sed -e 's/^\([0-9]*\.[0-9]*\)\..*$/\1/')
VERSION_MINOR=$(echo ${VERSION} | /bin/sed -e 's/^\([0-9]*\.[0-9]*\.[0-9]*\)[^0-9].*$/\1/')
command wget "http://launchpad.net/plone/${VERSION_MAJOR}/${VERSION_MINOR}/+download/Plone-$VERSION-UnifiedInstaller.tgz" \
    --output-document="/tmp/Plone-UnifiedInstaller.tgz"

Décompressez le fichier obtenu:

command tar --directory="/tmp" -xzf "/tmp/Plone-UnifiedInstaller.tgz"

Une fois ceci fait, placez vous dans le répertoire ainsi créé:

cd "/tmp/Plone-${VERSION_MINOR}-UnifiedInstaller"

Choisissez le nom de votre instance :

INSTANCE_NAME=zeocluster

Préparez les dossiers destinés à contenir l'installation :

/bin/mkdir --parent /var/lib/plone
/bin/mkdir --parent /var/log/plone/${INSTANCE_NAME}

Et lancez l'installation:

/bin/sh install.sh zeo \
    --target=/usr/local/Plone \
    --instance=/var/lib/plone/${INSTANCE_NAME}

Important: NOTEZ l'identifiant et le mot de passe fournis à la fin de cette ligne de commande. Il s'agit du compte d'administration du serveur.

Remarque: Nous installons un cluster ZEO car cela peut faciliter la mise en place d'une répartition de charge dans le cas ou cela devient nécessaire, mais aussi cela permet de profiter des capacités multi-coeur des serveurs actuels.

Une fois l'installation terminée, vous pouvez trouver les fichiers de Plone 3.x et de son serveur Zope dans le dossier "/opt/Plone". Les fichiers d'instance du cluster ZEO se trouvent dans le dossier /var/lib/plone/zeocluster.

Modifiez l'emplacement des fichiers journaux afin d'obtenir une arborescence un peu plus compatible avec celle de la LSB:

/bin/mkdir --parent /var/log/plone/${INSTANCE_NAME}
/bin/mv /var/lib/plone/${INSTANCE_NAME}/var/zeoserver /var/log/plone/${INSTANCE_NAME}
/bin/ln -s /var/log/plone/${INSTANCE_NAME}/zeoserver /var/lib/plone/${INSTANCE_NAME}/var/zeoserver
/bin/mv /var/lib/plone/${INSTANCE_NAME}/var/client{1,2} /var/log/plone/${INSTANCE_NAME}
/bin/ln -s /var/log/plone/${INSTANCE_NAME}/client{1,2} /var/lib/plone/${INSTANCE_NAME}/var/

Mettez en place le script init.d permettant de démarrer les serveur de votre instance Plone, ainsi que la rotation des fichiers journaux :

/usr/bin/wget http://howto.landure.fr/plone-3/installer-plone-3-1-sur-ubuntu-ou-debian/plone3-logrotate.d \
    --output-document=/etc/logrotate.d/plone3-${INSTANCE_NAME}
/usr/bin/wget http://howto.landure.fr/plone-3/installer-plone-3-1-sur-ubuntu-ou-debian/plone3-default \
    --output-document=/etc/default/plone3-${INSTANCE_NAME}
/usr/bin/wget http://howto.landure.fr/plone-3/installer-plone-3-1-sur-ubuntu-ou-debian/plone3-init.d \
    --output-document=/etc/init.d/plone3-${INSTANCE_NAME}
/bin/chmod +x /etc/init.d/plone3-${INSTANCE_NAME}
/bin/sed -i -e "s/%INSTANCE_NAME%/${INSTANCE_NAME}/g" /etc/logrotate.d/plone3-${INSTANCE_NAME}
/bin/sed -i -e "s/%INSTANCE_NAME%/${INSTANCE_NAME}/g" /etc/default/plone3-${INSTANCE_NAME}
/bin/sed -i -e "s/%INSTANCE_NAME%/${INSTANCE_NAME}/g" /etc/init.d/plone3-${INSTANCE_NAME}

Au besoin, configurez Plone pour qu'il démarre automatiquement au démarrage du système:

/usr/sbin/update-rc.d plone3-${INSTANCE_NAME} defaults

Une fois ceci fait, démarrez votre instance:

/etc/init.d/plone3-${INSTANCE_NAME} start

Sauvegardes

Pour sauvegarder votre installation de Plone, je vous conseille d'utiliser Backup Manager. Pour l'installer, vous pouvez suivre mon guide:

Installer et configurer Backup Manager sur Debian 4.0 Etch

Une fois Backup Manager installé, vous pouvez configurer la sauvegarde des fichiers de Plone avec la commande suivante:

/usr/bin/update-bm-folders add /var/lib/plone
/usr/bin/update-bm-folders add /usr/local/Plone

Important: Sauvegarder les fichiers ne suffit pas ! Il faut aussi sauvegarder la base de données. La procédure pour ce faire est disponible dans mon article MySQL sur Debian 4.0 Etch.

Mise en place de produits

Pour configurer les produits de notre instance, nous allons utiliser le système de buildout. Pour ce faire, j'ai préparé les lignes de code pour une sélection de produits Plone très sympas.

En premiez lieu, renseignez le chemin de votre instance :

INSTANCE_PATH=/var/lib/plone/${INSTANCE_NAME}

Puis, ajoutez le dépôt pypi.python.org:

/bin/sed -i -e '/^find-links/a\
    http://pypi.python.org' ${INSTANCE_PATH}/buildout.cfg

Ma sélection de produits

PloneFormGen

Un produit qui autorise les rédacteurs à créer des formulaires personnalisés.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.PloneFormGen
;}' ${INSTANCE_PATH}/buildout.cfg

Ploneboard

Un produit implémentant des forums simples.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.Ploneboard
;}' ${INSTANCE_PATH}/buildout.cfg

plone.app.redirector

Un produit pour gérer les changements d'URL de votre site. Il minimise les erreurs 404.

Remarque : Ce produit est intégré à Plone 3.2, il est donc inutile de l'ajouter au buildout.

LinguaPlone

Ce produit vous permet de gérer simplement un site Internet multilingue.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.LinguaPlone
;}' ${INSTANCE_PATH}/buildout.cfg

Collage

Ce produit permet de créer des pages regroupant plusieurs contenus du site.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.Collage
;}' ${INSTANCE_PATH}/buildout.cfg

RichDocument

Un produit qui implémente un article dont les images et les fichiers sont auto contenu. Très pratique pour avoir une structure de site propre.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.RichDocument
;}' ${INSTANCE_PATH}/buildout.cfg

collective.contentleadimage

Ce produit vous permet d'ajouter une imagette à n'importe quel contenu Plone. C'est très pratique pour faire remonter des articles avec imagettes en page d'accueil.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.contentleadimage
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.contentleadimage
;}' ${INSTANCE_PATH}/buildout.cfg

Plone Captchas

Ce produit nécessite l'installation de PIL. Pour ce faire, installez les dépendances nécessaires :

/usr/bin/apt-get install libfreetype6-dev libjpeg62-dev

Et lancez l'installation de PIL :

/opt/Plone*/Python-2.4/bin/easy_install --find-links http://www.pythonware.com/products/pil/ Imaging

Source : Merci à Martin Geber pour son article Problems installing (easy_install) PIL.

Ce produit met en place un mécanisme de captchas dans certains des formulaires de Plone.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    quintagroup.plonecaptchas
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    quintagroup.plonecaptchas
;}' ${INSTANCE_PATH}/buildout.cfg

Plone Comments

Ce produit met en place un mécanisme de modération des commentaires dans Plone.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    quintagroup.plonecomments
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    quintagroup.plonecomments
    quintagroup.plonecomments-overrides
;}' ${INSTANCE_PATH}/buildout.cfg

Plone Google Sitemaps

Ce produit améliore la gestion du fichier sitemap XML destiné à améliorer le référencement de votre site par les moteurs de recherche.

/bin/sed -i -e '0,/^urls[ ]*=/{//a\
    http://downloads.sourceforge.net/quintagroup/qPloneGoogleSitemaps-0.8.5.tar.gz
;}' ${INSTANCE_PATH}/buildout.cfg

windowZ

Ce produit met en place un type de contenu "Window" qui permet d'afficher un lien dans une iframe. Cela facilite l'intégration de sites externes dans votre site Plone.

/bin/sed -i -e '0,/^urls[ ]*=/{//a\
    http://plone.org/products/windowz/releases/1.2/windowZ-1.2.tgz
;}' ${INSTANCE_PATH}/buildout.cfg

ATFlashMovie

Ce produit permet d'insérer des animations Flash (et non des vidéos de type YouTube) dans votre site Plone.

/bin/sed -i -e '0,/^urls[ ]*=/{//a\
    http://plone.org/products/atflashmovie/releases/1.0.3/ATFlashMovie-1.0.3.tar.gz
;}' ${INSTANCE_PATH}/buildout.cfg

Plone4ArtistsVideo

Ce produit permet d'insérer des vidéos (de type YouTube) dans votre site Plone.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    p4a.plonevideo
;}' ${INSTANCE_PATH}/buildout.cfg

Singing & Dancing

Ce produit vous permet d'envoyer des lettres d'informations à partir de votre site Plone.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.dancing
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.dancing
;}' \
 -e '0,/^extends[ ]*=/{//a\
    https://svn.plone.org/svn/collective/collective.dancing/buildout-extends/0.8.7.cfg
;}' ${INSTANCE_PATH}/buildout.cfg

Important : L'installation de ce produit dans un buildout Plone 3.2.2 cause l'erreur suivante :

ImportError: No module named decorator

Pour corriger ce problème, utilisez la commande suivante :

/bin/sed -i -e 's/^additional-fake-eggs =/additional-fake-eggs +=/'  ${INSTANCE_PATH}/buildout.cfg

Source : Merci à Daniel Nouri pour sa réponse à problem getting S&D to work on OpenSolaris.

TextIndexNG3 (broken ?)

Ce produit améliore l'indexation des documents et autres fichiers dans Plone.

En premier lieu, installez les dépendances nécessaires à l'installation de ce produit:

/usr/bin/apt-get install libxml2-dev libxslt1-dev

Et lancez l'installation de lxml :

/opt/Plone*/Python-2.4/bin/easy_install lxml

Vous pouvez maintenant ajouter le produit à votre buildout :

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.TextIndexNG3
;}' ${INSTANCE_PATH}/buildout.cfg

OpenXml

Ce produit apporte le support des documents OpenXml à votre site Plone (indexation et icône). Pour rappel, OpenXml est le format utilisé par la suite Microsoft Office 2007.

En premier lieu, installez les dépendances nécessaires à l'installation de ce produit:

/usr/bin/apt-get install libxml2-dev libxslt1-dev

Et configurez ce produit dans votre buildout:

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.OpenXml
;}' ${INSTANCE_PATH}/buildout.cfg

Content Ratings

Ce produit permet de noter vos articles ou vos utilisateurs.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    plone.contentratings
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    plone.contentratings
;}' ${INSTANCE_PATH}/buildout.cfg

SimpleAlias

Ce produit permet la création d'alias vers un article. Ceci  permet l'existence d'un même article dans plusieurs sections du site.

/bin/sed -i -e '0,/^urls[ ]*=/{//a\
    http://plone.org/products/simplealias/releases/2.0.0/simplealias-2-0-0.tgz
;}' ${INSTANCE_PATH}/buildout.cfg

ContentLicensing

Ce produit permet d'assigner des licences tels que Creative Commons ou GFDL à vos documents. Pratique si vous tenez un site de documentation comme le mien.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.contentlicensing
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.contentlicensing
;}' ${INSTANCE_PATH}/buildout.cfg

collective.collection.alphabetic

Ce produit ajoute une vue triée par ordre alphabétiques aux collections.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    zope.testrecorder\
    collective.collection.alphabetic
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.collection.alphabetic
;}' ${INSTANCE_PATH}/buildout.cfg

collective.anonymousview

Ce produit ajoute un onglet permettant d'afficher une page comme elle est visualisée par les internautes non identifiés. C'est très pratique pour détecter les problèmes de publication de contenu.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    zope.testrecorder\
    collective.anonymousview
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.anonymousview
;}' ${INSTANCE_PATH}/buildout.cfg

RedirectionTool

Ce produit permet de gérer les alias de plone.app.redirector, et ainsi de rediriger les erreurs 404 vers des pages existant vraiment.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.RedirectionTool
;}' ${INSTANCE_PATH}/buildout.cfg

sc.social.bookmarks

Ce produit lit votre site Plone aux réseaux sociaux de partage de liens.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    sc.social.bookmarks
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    sc.social.bookmarks
;}' ${INSTANCE_PATH}/buildout.cfg

FlashVideo

Un produit qui permet d'insérer des vidéos au format Flv dans votre site.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.FlashVideo
;}' ${INSTANCE_PATH}/buildout.cfg

Structured Document

Ce produit permet la création d'articles structurés en chapitres et paragraphe, autorisant une grande souplesse de présentation. Je dois admettre que j'ai vraiment été séduit par ce produit.

Important : ce produit ne s'installe pas à l'aide du buildout. Il est nécessaire de l'installer à la main.

/bin/sed -i -e '0,/^zcml[ ]*=/{//a\
    sd.app
;}' \
  -e '0,/^[ ]*unifiedinstaller/{//a\
    sd
;}' ${INSTANCE_PATH}/buildout.cfg
/bin/echo '
[sd]
recipe  = hexagonit.recipe.download
url     = http://plone.org/products/structured-document/releases/2.2.4/sd-2-2-4-tar.gz
md5sum  = c9a2d876f396e77d8e7949aad28946b4
destination = ${zeoserver:zope2-location}/lib/python/sd
download-directory = ${buildout:download-cache}
strip-top-level-dir = true
' >> ${INSTANCE_PATH}/buildout.cfg

Source : Merci à Alberto Lopes pour sa réponse à Configuring buildout to install a python library: Structured Document installation.

Produits pour les développeurs

Les produits qui suivent sont destinés aux développeurs Plone. Ils fournissent une aide bienvenue pour comprendre la mécanique interne de Zope / Plone.

plone.reload

Ce produit permet de recharger certains éléments des produits en cours de développement sans redémarrer Zope.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    plone.reload
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    plone.reload
;}' ${INSTANCE_PATH}/buildout.cfg

Une fois ce produit activé, vous pourrez gérer le rechargement du code Python et des fichiers ZCML des produits Plone de votre instance via l'URL :

• http://localhost:8080/@@reload

DocFinderTab

Ce produit ajoute un onglet de documentation de l'API dans la ZMI. Très pratique pour éviter d'aller chercher la documentation au fond du code de Zope.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.DocFinderTab
;}' ${INSTANCE_PATH}/buildout.cfg

GloWorm

Ce produit vous permet d'inspecter les différents éléments de votre thème Plone via une interface Ajax proche de celle de Firebug.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.Gloworm
;}' ${INSTANCE_PATH}/buildout.cfg

Remarque : Pour que ce produit fonctionne correctement, le mode debug de Zope doit être activé. Cela peut se faire via la ligne de commande suivante :

/bin/sed -i -e '0,/^debug-mode =.*/s//debug-mode = on/' ${INSTANCE_PATH}/buildout.cfg

Clouseau

Ce produit implémente une ligne de commande Python en Ajax. C'est très pratique pour inspecter facilement le contenu de la ZODB.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.Clouseau
;}' ${INSTANCE_PATH}/buildout.cfg

Remarque : Pour que ce produit fonctionne correctement, le mode debug de Zope doit être activé. Cela peut se faire via la ligne de commande suivante :

/bin/sed -i -e '0,/^debug-mode =.*/s//debug-mode = on/' ${INSTANCE_PATH}/buildout.cfg

Produits en cours de test

collective.flowplayer

Ce produit permet de lire directement en ligne les fichiers mp3 et flv chargés sur le site. Un genre de p4avideo en plus simple.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.flowplayer
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.flowplayer
;}' ${INSTANCE_PATH}/buildout.cfg

Plone Help Center

Ce produit est utilisé pour gérer le centre de documentation de Plone. Il est intéressant pour son type "Tutorial" qui permet de diviser les articles en plusieurs sections.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.PloneHelpCenter
;}' ${INSTANCE_PATH}/buildout.cfg

qi.LiveChat

Ce produit implémente un salon de discussion Ajax dans Plone.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    qi.LiveChat
;}' \
  -e '0,/^zcml[ ]*=/{//a\
    qi.LiveChat
;}' ${INSTANCE_PATH}/buildout.cfg
/bin/echo '
[scripts]

recipe =
    zc.recipe.egg

eggs =
    qi.LiveChat
' >> ${INSTANCE_PATH}/buildout.cfg

collective.alertviewlet

Ce produit permet d'afficher un message d'information sur le site pour prévenir les visiteurs d'une maintenance, ou d'un événement important. Pour l'installer, utilisez ces commandes :

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.alertviewlet
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.alertviewlet
;}' ${INSTANCE_PATH}/buildout.cfg

collective.categorizing

Ce produit permet de hiérarchiser les mots clefs. C'est pratique si votre site à une structuration importante des mots clefs. Pour l'installer, utilisez ces commandes :

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.categorizing
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.categorizing
;}' ${INSTANCE_PATH}/buildout.cfg

collective.logbook

Ce produit améliore grandement l'interface web de lecture des erreurs de Plone. Pour l'installer, utilisez ces commandes :

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.logbook
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.logbook
;}' ${INSTANCE_PATH}/buildout.cfg

collective.portlet.keywordmatches

Ce produit affiche les articles avec les même mots clefs que l'article courant.

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    collective.portlet.keywordmatches
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    collective.portlet.keywordmatches
;}' ${INSTANCE_PATH}/buildout.cfg

ContentWellPortlets

Ce produit permet d'ajouter des portlets ailleurs que dans les colonnes droites et gauches. Notamment au dessus du "main".

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    Products.ContentWellPortlets
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    Products.ContentWellPortlets
;}' ${INSTANCE_PATH}/buildout.cfg

quintagroup.portletmanager.footer

Ce produit permet d'ajouter des portlets ailleurs que dans les colonnes droites et gauches. Notamment au dessus du "main".

/bin/sed -i -e '0,/^eggs[ ]*=/{//a\
    quintagroup.portletmanager.footer
;}' \
 -e '0,/^zcml[ ]*=/{//a\
    quintagroup.portletmanager.footer
;}' ${INSTANCE_PATH}/buildout.cfg

jarn.checkinterval

Ce produit est sensé optimiser les performances de Zone.

/bin/sed -i -e '0,/^parts[ ]*=/{//a\
    checkinterval
;}' ${INSTANCE_PATH}/buildout.cfg
/bin/echo '
[checkinterval]
recipe = zc.recipe.egg
eggs = jarn.checkinterval
' >> ${INSTANCE_PATH}/buildout.cfg

Ensuite, une fois le buildout terminé, exécutez la commande suivante :

./bin/checkinterval

Et ajoutez la ligne suivante avant le nombre fourni à votre fichier zope.conf :

python-check-interval 1305

GetPaid

Ce produit permet de gérer un site de commerce en ligne basé sur Plone.

TODO

Autres produits

Je n'ai pas testé ces produits, mais leur description m'a tapé dans l'oeil.

• mailtoplone

Fin de la configuration et premier accès au site Plone

Une fois que vous aurez fait votre choix parmi les produits décrit ci-dessus, exécutez la commande suivante pour les inclure dans votre configuration Zope / Plone:

cd /var/lib/plone/${INSTANCE_NAME}
/var/lib/plone/${INSTANCE_NAME}/bin/buildout

Et redémarrez votre serveur Zope:

/etc/init.d/plone3-${INSTANCE_NAME} stop
/etc/init.d/plone3-${INSTANCE_NAME} start

Vous pouvez maintenant accéder aux deux serveur Zope permettant d'accéder à votre site avec les URL suivantes.

http://localhost:8080/

http://localhost:8081/

De même pour la Zope Management Interface, vous pouvez utiliser l'URL:

http://localhost:8080/manage

Et pour le site Plone créé par défaut:

http://localhost:8080/Plone

Pour aller plus loin

Si vous souhaitez inclure un produit que vous avez développé dans votre installation de Zope / Plone, vous avez deux possibilités.

Votre produit est un egg Python

1. Placez votre egg Python dans le dossier /var/lib/plone/${INSTANCE_NAME}/src.
   
2. Modifiez la section "develop" et la section "eggs" du fichier /var/lib/plone/${INSTANCE_NAME}/buildout.cfg et ajoutez-y le nom de votre produit:
   

   # Add additional eggs here
   # elementtree is required by Plone
   eggs =
       my.portlets.example
   
   # Reference any eggs you are developing here, one per line
   # e.g.: develop = src/my.package
   develop =
       src/my.portlets.example
   

   Remarque: Certains produits vous demandrons de modifier la section zcml de vos instances:

   # If you want to register ZCML slugs for any packages, list them here.
   # e.g. zcml = my.package my.other.package
   zcml = 
       my.portlets.example

3. Comme à chaque modification du fichier buildout.cfg, mettez à jour votre buildout, et redémarrez votre serveur Zope:
   

   cd /var/lib/plone/${INSTANCE_NAME}
   /var/lib/plone/${INSTANCE_NAME}/bin/buildout
   /etc/init.d/plone3-${INSTANCE_NAME} stop
   /etc/init.d/plone3-${INSTANCE_NAME} start
   

Votre produit n'est pas un egg Python

Placez simplement votre produit dans le dossier /var/lib/plone/${INSTANCE_NAME}/products.

Remerciements

• Merci aux développeurs du serveur d'applications Python Zope.
• Merci aux développeurs du CMS Plone.
• Merci à Optilude pour son guide Managing projects with zc.buildout.