Documentation rapide Plone

Ce document suppose que l'utilisateur a les moyens de devenir root sur la machine qui héberge le site.

Création d'une instance Zope

Une instance Zope peut contenir plusieurs Plone. Il faut donner un nom à l'instance Zope qui portera le Plone, et nous prendrons soin de ne pas utiliser de caractères spéciaux. Nous nous contenterons de caractères alphanumériques. Nous ajoutons une instance avec la commande:

$ sudo dzhandle --zope-version=2.9 make-instance premierplone --user=infogerance:serveur --service-port=24157 --addon-mode=manual

Explications

dzhandle est l'utilitaire de gestion des instances Zope. Il permet de syndiquer tous les appels aux différents scripts de Zope. Dans la commande précédente, nous lui avons demandé de créer une instance nommée "premierplone" (qui en fait ne contient pas encore de Plone), qui se trouve dans le répertoire /var/lib/zope2.9/instances/. Dans cette même commande, nous avons imposé un port de service (sur ma machine, le 80 est déjà utilisé) et le login et mot de passe (en clair) de l'administrateur initial du site. Enfin, nous avons spécifié que nous ajouterons les Produits manuellement (par copie dans le répertoire Products de l'instance).

Installation de produits

Les produits que nous allons choisir d'installer sont Plone (2.5.5) et DIYPloneStyle (2.5).

Nous choisissons de ne pas installer des produits packagés essentiellement à cause du fait que certains produits ne sont pas encore packagés. Il serait bancal d'avoir certains produits installés d'une manière et d'autre installés d'une autre manière.

Dans le chapitre précédent, nous avons vu dans quel répertoire l'instance sera créée. Pour l'exemple précis, l'instance se trouvera dans /var/lib/zope2.9/instances/premierplone et c'est dans ce répertoire qu'on trouvera le répertoire Products dans lequel nous mettrons les produits.

Il faut donc commencer par télécharger le produit DIYPloneStyle (2.5) , le désarchiver et placer le répertoire DIYPloneStyle dans /var/lib/zope2.9/instances/premierplone/Products.

Au tour de Plone, il faut faire gaffe au fait que Plone soit un ensemble de produits. Le désarchivage de Plone créera un premier répertoire Plone-2.5.5 et ce sont ses sous-répertoires qui sont les produits. Il faut donc les copier dans /var/lib/zope2.9/instances/premierplone/Products.

Un fois les produits souhaités installés, il suffit redémarrer Zope (pas le système) et accéder à l'interface d'administration.

Interface d'administration

En supposant que vous ayez installé Plone sur une machine nommée "serveur" (remplacer le nom par l'adresse IP si pas encore de nom disponible) et le port 24157 (comme dans l'exemple de ce document), alors l'interface de gestion est disponible à l'URL http://serveur:24157/manage. Il sera demandé un login et un mot de passe. Si l'exemple a été suivi, alors ce doit être infogerance et serveur.

Ajout d'un site Plone

Ajouter un site plone se fait via l'interface d'administration. Il faut ajouter un "Plone Site" de la liste déroulante sur la droite et en haut.

Notons qu'il est possible ajouter plusieurs sites Plone sur le même Zope.

Organisation des fichiers et répertoires

Zope n'utilise pas le système de fichier de l'ordinateur pour stocker les fichiers et répertoires qu'on lui fourni et qu'il est censé servir (en tant que serveur). Il les stocke dans une base de donnée, la ZODB.

C'est une différence déroutante pour le nouveau venu.

Cette base de donnée est accessible via FTP, pour uploader du contenu en masse. Mais aussi par XML-RPC et autres forme d'écriture. Zope et Plone sont légèrement orientés "gestion de contenu collaboratif" et de ce fait il est sous entendu que l'ajout de document se fasse par le navigateur (et l'éditeur de texte intégré à Plone) plutot que massivement et de manière non gérable (par FTP par exemple). Par "non gérable", nous sous-entendons que le système de gestion de flux (WorkFlow) n'a pas d'effet.

Réinitialisation du mot de passe

L'utilisateur initial que nous avons créé peut avoir oublié son mot de passe. Toujours avec dzhandle, il faut d'abord arrêter l'instance Zope en question (prenons encore "premierplone"), avec:

$ sudo dzhandle zopectl premierplone stop

Puis, si on veut "newpass" comme nouveau mot de passe:

$ sudo dzhandle zopectl adduser infogerance newpass

Il faut maintenant redemmarer Zope et aller à l'adresse de l'interface d'administration.