Doc administrateur du Multispip

Versions :
Multispip V1 créé par la R&D d’EDF sur une idée de Stéphane Rouilly. On participé au développement de cette version : Sven Dufils (maquettage idée), David Serrault (développement et design), Christelle Gouret (les doc utilisateur), Enguerrand Leclerc (mise en contrib et petites améliorations), Stéphane Rouilly (pilotage).

Cette version est utilisée pour un département d’EDF R&D de 150 personnes.

Fonctionnalités :
Système d'authentification des inscrits par e-mail.
Créer des sites à partir de modèles.
Les paramétrer en fonction des infos saisies par le créateur.
Possibilité de référencer des sites créés autrement qu'avec Multispip.
Fonction synchro -> Mettre à jour automatiquement tous les sites (modèle mais aussi spip lui même.

Installation :
Principe :
Le système Multispip est constitué de deux répertoires principaux et d'une base :

Le répertoire /multispip/ (http://localhost/multispip/)
Il contient le système d'administration et de création de sites, ainsi que les sites modèles.
Ces sites sont placés dans des dossiers à l'intérieur du répertoire /multispip/modeles/. Ce répertoire contient aussi les fichiers dump, résultants de l'export des bases de données des sites modèles.
Au premier niveau du répertoire /multispip/ et dans le répertoire /multispip/creerSite/ sont placés les différentiels fichiers qui constituent le système Multispip.

Le répertoire /sites/ (http://localhost/sites/)
Il contient les sites créés dans leurs dossiers respectifs ainsi que le système de syndication et de recherche multi-sites.

La base Multispip (accès (par exemple): http://localhost/phpmyadmin/ , login:root )
La base MultiSpip contient deux tables, l'une conserve les infos sur les inscrits, l'autre, les infos sur les sites.

** Installer Multispip **

Préparation
- Copier les dossiers /multispip/ et /sites/ au meme niveau sur le serveur.
- Creer une base sous le nom "MultiSpip" et executer le fichier dump "MultiSpip.sql" que vous trouverez dans /multispip/

Configuration
Les variables de configuration de Multispip sont dans /multispip/configuration.php
-> Editer le fichier en se référant aux commentaires et aux exemples qu'il contient.

Ajouter des modèles
Les modèles de sites et les fichiers dump de leur base doivent être placés dans le repertoire /multispip/modèles/
Pour que Multispip prenne en compte l'ajout d'un nouveau modèle, il est nécessaire d'éditer le fichier /multipip/configuration.php
-> Se référer aux commentaires et au exemples qu'il contient.

Référencement d'un site non multispip :
Principe :
Ajouter un site à la base des sites Multispip. Ce site n'a pas été crée par Multispip et peut être situé à une adresse exterieure.

Utilisation :
Cliquer sur : "référencer un site existant". Saisir le nom du site, son URL et une description.

! Remarque : Les sites référencés, Non Multispip, ne bénéficient pas de la fonction de multi-recherche. Par contre, ils s'affichent automatiquement dans la Mire. S'ils possedent un fichier "bakend.php" à leur racine, les actualités seront automatiquement affichées. Dans le cas contraire, la syndication devra être réalisée manuellement dans le module d'administration de la Mire.

Inscription nouvel utilisateur :
4 étapes :

1 - choix de l'utilisateur -> inscription.php

2 - Saisie du mot de passe -> inscription.php

3 - Verification des données et envois d'un e-mail de confirmation si ok -> inscription2.php

4 - Activation du compte utilisateur par accès a une URL fournie dans le mail. -> inscription_valid.php

! Problème possible : cas ou le mail enregistré dans la base n'est pas valide. -> par sécurité, l'administrateur reçois une copie du mail d'inscription

Mire Multispip :
La Mire Multispip est un site SPIP normal dont la page d'accueil sert a afficher la liste des sites syndiqués.
URL : http://localhost/sites/mire_multispip/

Le site possède son propre module d'administration a l'adresse : http://localhost/sites/mire_multispip/ecrire/ accessible, comme les autres sites du Multispip avec le login : admin_multispip et le mot de passe : admin

Ce site est indépendant du système Multispip. Il possède sa propre base de sites syndiqués. Elle doit être mise a jour à chaque création, référencement ou suppression de sites en cliquant sur le bouton "Mettre a jour : la liste des sites" en bas de la page.

La mise a jour de la liste des sites syndiqués est réalisée par un script PHP qui compare la base du site de la Mire avec celle de Multispip. La liste des actions effectués s'affiche en haut de page. Il faut recharger la page pour mettre a jour l'affichage.

! Remarque : La syndication des actualités d'un site nouvellement référencé dans un site spip n'est pas immédiate. Les actualités des sites nouvellement référencés n'apparaissent donc pas tout de suite. Un délai de plusieurs heures peut être nécessaire au système de syndication de spip. Il est néanmoins possible de forcer leur affichage par l'intermédiaire du site d'administration.

Multi-recherche :
Principe : Lancer une requête sur toutes les pages "recherche.php" a l'aide de la fonction "fopen()" de PHP. Le nombre de résultat renvoyé par chaque site est isolé dans la code source de la page de recherche de chaque sites entre les commentaires :... .

Pour qu'une page de recherche d'un site soit compatible avec le système de Multi-recherche, elle doit donc contenir un script affichant le nombre de résultats de la recherche entre les commentaires ci-dessus.

La page de multi-recherche est situé à l'adresse "sites/recherche.php".

Sites modèles :
Les modèles qui sont répliqués lorsque l'on crée un site avec Multispip sont hébergés sur le même serveur.

Veille : http://localhost/multispip/modeles/multispip_veille/ accès reseau : /multispip/creerSite/multispip_veille/
Projet : http://localhost/multispip/modeles/multispip_projet/ accès reseau : /multispip/creerSite/multispip_projet/

En plus des dossiers des sites modèles, le repertoire /modeles/ contient les fichiers dump de chacun d'entre eux. Ces dump sont réalisés en exportant le contenu et la structure des bases des sites modèles avec de PhpMyAdmin avec les options "insertions étendues" et "transmettre". les dumps doivent porter le même nom que les dossiers des sites modèles.

Synchronisation :
Principe :
Recopier les fichiers des modèles (en dehors du répertoire écrire et du cache) dans les répertoires des sites qu'ils ont respectivement engendrés. Ce sont donc les sites modèles qui sont la référence pour la synchronisation.

Utilisation :
Se connecter à multispip (http://localhost/multispip/) et accéder au module de synchronisation (lien en bas de la page de la liste des sites). Séléctionner les sites à synchroniser en se référant au nom du modèle. Saisir le mot de passe (admin) et valider.

Mise à jour version Spip :
Il n'y a pas de système de mise a jour de la version de spip. En ce qui concerne la mise a jour des fichiers, elle peut éventuellement être réalisée à partir du module de synchronisation de Multispip. Il faut d'abord mettre a jour les sites modèles, puis modifier le script de synchronisation pour qu'il prenne en compte le répertoire "Ecrire" :

A la ligne 148 du fichier inc_fonctions.php
if ($nomFichier !="." && $nomFichier !=".." && $nomFichier !="CACHE" && $nomFichier !="ecrire")
-> supprimer && $nomFichier !="ecrire"

La mise a jour des bases de données doit se faire manuellement pour tous les sites Multispip. Mais en fait, il suffit que les administrateurs se connectent à leur admin pour se voir proposer la mise a jour automatique de la base. Si vous souhaitez néanmoins la faire à leur place, vous pouvez accéder à l’admin de tous les sites créés par le Multispip avec les login : admin_multispip et mode passe : admin.

Squelettes projet :
Voir doc utilisateur Site Projet

Squelettes veille :
Voir doc utilisateur Site Veille

Système de création de site :
Principe :
Créer une copie conforme d'un des sites modèles (fichiers et base) dans un nouveau répertoire et une nouvelle base, le personnaliser en fonctions des informations fournies par son créateur et l'ajouter à la liste des sites référencés dans le Multispip.

Cinematique :
Pour éviter des problèmes de temps d'executions. Les étapes de la création d'un nouveau site sont reparties dans plusieurs pages situées dans le répertoire multispip/creerSite/ :
- choisirModele.php
- creerBase.php (saisie du nom court du site + création de la base)
- remplirBase.php
- creerRepertoire.php
- remplirRepertoire.php
- adapterSite.php (mise a jour du fichier de configuration de SPIP)
- enregistrerSite.php (saisie du nom, de la description du site, enregistrement dans la base Multispip, mise a jour de la base du site)

La majeure partie des fonctions PHP de création de site est située dans le fichier : multispip/creerSite/fonctions_creer.php

Utilisation :
Se connecter à multispip (http://localhost/multispip/) Cliquer sur le bouton "créer votre site". Choisir le modèle. Choisir un nom pour le répertoire du site (nom court). Si le nom est valide (Pas de caractères non conforme, aucune base ne porte le même nom) la création est lancée. Une fois que la création du site est terminée, l'utilisateur accède a une page lui permettant de personnaliser le nouveau site (nom complet, description, login et mot de passe d'accès a l'administration). Si les informations fournies sont conformes, le site est référencé dans la base du Multispip.

Suppression d'un site :
Principe :
Supprimer le site de la base Multispip. Le site n'apparaît plus dans la liste, mais les fichiers et la base qui le constituent ne sont pas supprimés. La suppression complète et définitive d'un site doit se faire manuellement.

Fichier : multispip/suppression.php

Utilisation :
Se connecter à Multispip (http://localhost/multispip/) Cliquer sur le bouton "Supprimer un de vos sites". Cliquer sur "Supprimer" .

Schémas de principe des fonctionnalités principales :

Description du fonctionnement de Multi-Spip (pas a jour)

Enregistrer Nom, Prenom

Enregistrer Login

Enregistrer Service, Fonction

Enregistrer e-mail