MediaSPIP

Afin d'assurer une gestion correcte de la ferme, il est nécessaire de notifier plusieurs choses lors d'actions spécifiques à la fois à l'utilisateur mais également à l'ensemble des administrateurs de la ferme.

Les notifications de changement de statut

Lors d'un changement de statut d'une instance, l'ensemble des administrateurs de la ferme doivent être notifiés de cette modification ainsi que l'utilisateur administrateur de l'instance.

À la demande d'un canal

Passage au statut "publie"

Passage au statut "refuse"

Passage au statut "poubelle"

Le passage au statut "poubelle" peut signifier deux choses différentes :

une annulation de la demande d'instance de mutualisation;
une demande de suppression de l'instance de la part de l'utilisateur lui même;
une suppression de l'instance par un administrateur;

Les messages envoyés aux administrateur de la ferme et à l'utilisateur administrateur de l'instance doivent donc prendre ces trois cas en considération.

La notification régulière des administrateurs

Cette notification est envoyée régulièrement (chaque jour) par la tâche de maintenance de la mutualisation.

Elle est envoyée à tous les administrateurs webmestres du site et indique trois choses distinctes :

les instances définitivement supprimées;
les instances en attente de validation;
les instances en attente de suppression;

Cette notification est principalement un rappel journa lier de l'activité des instances.

Récupération d'informations sur le site maître à l'installation d'une instance

kent1 — 2010-11-26T22:37:29Z

Le super Cron (gestion_mutu_super_cron)

Utilité

Sur le site principal, une instance de mutualisation est définie par plusieurs choses :

Les données dans la table spip_mutus;
Son logo;
Son auteur principal (id_admin dans la table spip_mutus correspondant à un id_auteur de la table spip_auteurs)qui sera le seul à pouvoir créer définitivement l'instance de mutualisation;

Il peut donc être tout à fait judicieux de vouloir récupérer certaines de ces informations afin de compléter l'installation d'une instance pour, par exemple :

récupérer le titre de l'instance et le placer comme titre du site dès l'installation;
récupérer le descriptif d'une instance et le placer comme descriptif du site dès l'installation;
...

Pour ce faire, le plugin de gestion de la mutualisation fournit une page spécifique en xml, accessible uniquement lorsquelle est appelée par la même adresse IP que le serveur (afin de sécuriser les données qu'elle contient).

Cette page est spip.php?page=mutu_infos_instances et doit être appelé avec un paramètre d'URL url correspondant à l'URL de base (sans http://) du site dont on souhaite récupérer les informations (par exemple : test.mediaspip.net).

Il est donc alors tout à fait imaginable de créer un petit plugin complémentaire que l'on déposera dans le dossier extensions/ à la racine de la mutualisation, ce plugin sera automatiquement installé et activé à la création d'une instance, et de mettre une fonction dans son installation permettant de récupérer ces données.

Exemple de contenu fournit par cette page

L'exemple ci dessous est ce que retourne cette page en l'appelant de la sorte : http://site.maitre.tld/spip.php?page=mutu_infos_instances&url=test.mediaspip.net.

```
 
```
```
version="1.0" encoding="utf-8"?> 
```
```
 
```
```
> 
```
```
>Test> 
```
```
>Description de test> 
```

>http://site.maitre.tld/IMG/mutuon32.jpg?1290814584>

```
>contact@mediaspip.net> 
```
```
> 
```
```
	>Admin de mediaspip.net> 
```
```
	>Biographie de l'admin>
```
```
	>contact@mediaspip.net> 
```
```
	>mediaspip.net> 
```
```
	>http://www.mediaspip.net> 
```
```
	>admin_mediaspip.net> 
```

	>eea83c778953b750302a923bffbb923c4a7b0c581ec0f01a832c1a5d7cf641b2>

```
	>FZ5KX7vG> 
```
```
	>Clé PGP de l'admin s'il y a lieu> 
```
```
	>$1$9djYgabX$5.AeLQbdRQdCToSEJalDB0> 
```
```
	>19054803554ceed96024b415.45307843> 
```
```
	>5975604334ceeda5829e783.10831622> 
```

	>a:3:{s:7:"couleur";s:1:"6";s:7:"display";i:0;s:3:"cnx";s:0:"";}>

```
	>fr> 
```

	>http://site.maitre.tld/local/cache-gravatar/fe69a5d0c8df13115116d9dac44364c8.jpg>

```
> 
```
```
>
```

Ce contenu comme expliqué plus haut ne sera pas accessible via votre navigateur mais uniquement via un appel de la même machine sur laquelle est hébergée la mutualisation (par un script PHP par exemple).

Cas d'utilisation

Voici le code documenté de MediaSPIP Init qui utilise cette possibilité. Pour rappel, ce plugin sert à initialiser divers éléments de configuration de SPIP dès son installation. Il est placé dans le dossier extensions de la mutualisation et est donc appelée installé à chaque installation.

Cette partie de code fait partie de la fonction d'installation du plugin, elle est assez documentée dans le code pour se suffire à elle même.

```
	/**
```

 * On vérifie tout d'abord que l'on est bien dans une mutualisation et que l'on n'a qu'un seul site maitre

```
 */
```

	if(defined('_SITES_ADMIN_MUTUALISATION') && (count(explode(',',_SITES_ADMIN_MUTUALISATION)) == 1)){

```
 include_spip('inc/xml');
```
```
 include_spip('inc/distant');
```
```
 include_spip('action/iconifier');
```
```
 
```
```
 /**
```

 * On utilisera notre adresse sans http pour fournir de quoi à la mutu pour nous reconnaitre

```
 */
```

 $url_site = str_replace('http://','',$GLOBALS['meta']['adresse_site']);

```
 /**
```

 * On génère l'URL à appeler sur la mutu

```
 */
```

 $url_distant = 'http://'._SITES_ADMIN_MUTUALISATION.'/spip.php?page=mutu_infos_instances&url='.$url_site;

```
 /**
```

 * On crée l'arbre xml de ce que l'on récupère sur le site principale de la mutualisation

```
 */
```

 $infos_mutus = spip_xml_load($url_distant, true, true, $taille_max = 1048576, $datas='', $profondeur = -1);

```
 if(is_array($infos_mutus)){
```
```
 include_spip('inc/meta');
```
```
 /**
```
```
 * Le nom du site
```
```
 */
```

 if(isset($infos_mutus['infos'][0]['titre'])){

 ecrire_meta("nom_site", $infos_mutus['infos'][0]['titre'][0]);

```
 }
```
```
 /**
```
```
 * Le descriptif du site
```
```
 */
```

 if(isset($infos_mutus['infos'][0]['descriptif'][0])){

 ecrire_meta("descriptif_site", $infos_mutus['infos'][0]['descriptif'][0]);

```
 }
```
```
 /**
```
```
 * L'email du webmaster
```
```
 */
```

 if(isset($infos_mutus['infos'][0]['email_webmaster'][0])){

 ecrire_meta("email_webmaster", $infos_mutus['infos'][0]['email_webmaster'][0]);

```
 }
```
```
 /**
```
```
 * Le logo du site
```
```
 */
```

 if(isset($infos_mutus['infos'][0]['logo'])){

 $ajouter_image = charger_fonction('spip_image_ajouter','action');

 $source = copie_locale($infos_mutus['infos'][0]['logo'][0]);

```
 if (file_exists($source)) {
```

 $new_source = determine_upload().basename($source);

```
 @rename($source,$new_source);
```

 $chercher_logo = charger_fonction('chercher_logo','inc');

 $logo = $chercher_logo('', 'site', 'on');

```
 $type = type_du_logo('site');
```
```
 if ($logo)
```
```
 spip_unlink($logo[0]);
```

 $ajouter_image($type.'on0',true,basename($new_source));

```
 }
```
```
 }
```
```
 /**
```

 * Les informations de l'id_admin qui doit être le premier auteur créé

```
 */
```

 if(is_array($admin = $infos_mutus['infos'][0]['admin'][0])){

```
 foreach($admin as $info => $value){
```
```
 $admin_final[$info] = $value[0];
```
```
 }
```
```
 $admin_final['statut'] = '0minirezo';
```
```
 $admin_final['webmestre'] = 'oui';
```
```
 /**
```

 * On enlève le logo_auteur si présent et on le stock dans une variable

```
 */
```

 if(isset($admin_final['logo_auteur'])){

 $logo_auteur = $admin_final['logo_auteur'];

```
 unset($admin_final['logo_auteur']);
```
```
 }
```
```
 /**
```

 * Si le même auteur avec la même adresse email a été créé à l'installation

 * On met seulement à jour avec les informations récupérées

```
 */
```

 if($id_auteur = sql_getfetsel('id_auteur','spip_auteurs','email='.sql_quote($admin_final['email']))){

 $infos_actuelles = sql_fetsel('*','spip_auteurs','id_auteur='.intval($id_auteur));

 $infos_admin = array_merge($admin_final,$infos_actuelles);

 sql_updateq('spip_auteurs',$infos_admin,'id_auteur='.intval($id_auteur));

```
 }
```
```
 /**
```

 * S'il n'y a pas eu de création d'auteur à l'installation,

 * on en crée un depuis les informations récupérées

 * Attention : cet auteur ne sera pas automatiquement fonctionnel, il devra demander un rappel de

 * mot de passe avant de pouvoir se loguer sur le site

```
 */
```
```
 else{
```

 $id_auteur = sql_insertq('spip_auteurs',$admin_final);

```
 }
```
```
 /**
```

 * Si on a un logo, on l'ajoute à l'auteur

```
 */
```
```
 if($logo_auteur){
```

 $ajouter_image = charger_fonction('spip_image_ajouter','action');

```
 $source = copie_locale($logo_auteur);
```
```
 if (file_exists($source)) {
```

 $new_source = determine_upload().basename($source);

```
 @rename($source,$new_source);
```

 $chercher_logo = charger_fonction('chercher_logo','inc');

 $logo = $chercher_logo($id_auteur, 'auteur', 'on');

```
 $type = 'aut';
```
```
 if ($logo)
```
```
 spip_unlink($logo[0]);
```

 $ajouter_image($type.'on'.$id_auteur,true,basename($new_source));

```
 }
```
```
 }
```
```
 }
```
```
 }
```
```
	}
```

Les statuts des instances de mutualisation

kent1 — 2010-03-13T14:55:51Z

Le super Cron (gestion_mutu_super_cron)

La demande d'une instance

La validation d'une instance

La suspension d'une instance de mutualisation

La suppression d'une instance de mutualisation

Pour des raisons de compatibilité générale du plugin de gestion de mutualisations avec les fonctions originales de SPIP, les statuts des instances sont les mêmes que pour tout autre objets (articles...), seuls leurs noms dans l'interface change quelque peu.

Les différents statuts possibles sont :

prepa (demandé) qui correspond à une instance demandée par un utilisateur. Si le site a déjà été créé par le passé, il est passé en mode désactivé.
publie (validé) qui correspond à une instance validée par un administrateur.
refuse (suspendue) qui correspond à une instance qui a été suspendue par un administrateur;
poubelle (à la poubelle) qui correspond à une instance qui va être supprimée (suppression de la base de donnée du site maître mais aussi du disque dur par un cron).

La demande d'une instance

À la validation du formulaire de demande d'instance, elle est automatiquement considérée comme "demandée", les administrateurs du site sont prévenus (ils reçoivent une notification) et peuvent valider ou invalider la demande.

Tant que le statut de l'instance n'a pas changé, l'utilisateur a la possibilité de changer le nom de domaine souhaité. Lorsque la demande est validée, seuls les administrateurs peuvent réaliser cette opération.

La validation d'une instance

Lorsque l'instance de mutualisation est validée par un administrateur, l'utilisateur est notifié du fait qu'il peut dorénavant procéder à la création de son site.

Il lui suffit d'aller à l'adresse qu'il a préalablement choisi et de suivre le processus d'installation.

La suspension d'une instance de mutualisation

Il peut arriver pour diverses raisons qu'un administrateur souhaite suspendre une instance de mutualisation (contenu non conforme à une charte, non paiement dans le cas d'un service commercial...).

Il suffit alors pour l'administrateur de modifier le statut de l'instance dans l'espace privé de «publie» à «refuse». Dans les faits, cela renommera le répertoire du site en lui donnant une extension _disabled, rendant son accès impossible. L'utilisateur verra à la place de son site, un message lui indiquant que son site est suspendu, l'invitant à contacter son hébergeur.

La suppression d'une instance de mutualisation

Un utilisateur de la mutualisation peut vouloir supprimer son site du serveur. Pour cela, il accès à un menu dans le formulaire de modification pour réaliser cette opération.

Lors de la validation de la part de l'utilisateur de la demande de suppression, le contenu n'est pas automatiquement détruit.

L'utilisateur et les administrateurs du site maitre reçoivent une notification comme quoi il y a eu demande de suppression.

Le répertoire du site est suffixé par "deleted" permettant de ne plus afficher le site mais laissant la possibilité aux administrateurs de sauvegarder le contenu au cas où, et de permettre à l'utilisateur et aux administrateurs de pouvoir faire machine arrière en cas d'erreur de l'utilisateur (le repassage en "validée" renommera à nouveau ce répertoire et le site sera à nouveau visible).

Création définitive du canal

kent1 — 2010-03-12T22:49:23Z

Le super Cron (gestion_mutu_super_cron)

La demande d'une instance

La validation d'une instance

La suspension d'une instance de mutualisation

La suppression d'une instance de mutualisation

Lorsque votre demande est validée, vous pouvez alors procéder à la création proprement dite du canal. Chaque canal est un site à part entière placé sous votre responsabilité. Les administrateurs de la plateforme n'y ont aucun accès.

A la validation, vous recevez un email vous invitant donc à créer votre canal.

Pour ce faire il vous suffit de vous rendre à son adresse, dans notre exemple "http://votre_sous_domaine.mediaspip.net".

A ce moment là un mot de passe vous est demandé, il vous suffit d'y placer le mot de passe que vous utilisé pour vous identifier à ce site.

Il vous est alors demandé de valider plusieurs étapes en cliquant sur un lien :

la création des répertoires du site;
la création de la base de donnée;
puis la poursuite de l'installation de SPIP;

La suite est une installation classique de SPIP, où il vous faut :

choisir votre langue d'installation qui servira de langue du site par défaut;
créer la base de donné ce qui a déjà été réalisé auparavant;
rentrer vos informations personnelles;

Attention, le compte que vous créez en rentrant vos informations personnelles n'a absolument rien à voir avec celui que vous avez sur le "site maître" de la ferme. Il sera le compte principal administrateur de votre canal. Faites donc attention au choix de votre login et de votre mot de passe à ce moment là.

A la validation de cela, vous allez être dirigé vers la page d'accueil du site. Le principal des fonctionnalités seront déjà présentes.

Demande de création d'un canal

kent1 — 2010-03-12T22:45:21Z

Le super Cron (gestion_mutu_super_cron)

La demande d'une instance

La validation d'une instance

La suspension d'une instance de mutualisation

La suppression d'une instance de mutualisation

En fonction de la configuration de la plateforme, l'utilisateur peu avoir à sa disposition deux méthodes différentes de demande de création de canal. La première est au moment de son inscription, la seconde, après son inscription en remplissant un formulaire de demande.

Les deux manières demandent les mêmes choses fonctionnent à peu près de la même manière, le futur utilisateur doit remplir une série de champ de formulaire permettant tout d'abord aux administrateurs d'avoir des informations quant à l'utilisation future du canal (son titre, son descriptif), mais aussi pour déterminer son adresse future (le sous domaine choisi, le domaine dans le cas où le fournisseur permet de choisir entre plusieurs domaines différents, voir le renseignement d'un «domaine libre», si le fournisseur fournit cette possibilité, dont le nom de domaine appartient à l'utilisateur qu'il aura fait pointer sur le serveur du fournisseur).

A la validation du formulaire (que ce soit d'inscription ou de demande simple), le futur utilisateur est notifié par email que les informations qu'il a fourni sont valides et prise en compte par le système et que son canal est en attente de validation. Les administrateurs de la plateforme sont également notifiés leur demandant de valider (ou non) le nouveau canal.

Lorsque le statut du canal est modifié en «validé» ou «refusé» par un des administrateurs, l'ensemble des administrateurs sont notifiés de la mise à jour. L'utilisateur reçoit également un email l'invitant à se rendre à l'adresse de son canal afin de procéder à l'étape de création définitive du canal.

Le plugin : Gestion de la mutualisation

kent1 — 2010-03-02T14:22:00Z


The pooling website management plugin

Le plugin de Gestion de mutualisation permet de gérer les différents canaux de mediaspip depuis un site maître. Il a pour but de fournir une solution pure SPIP afin de remplacer cette ancienne solution.

Installation basique

On installe les fichiers de SPIP sur le serveur.

On ajoute ensuite le plugin "mutualisation" à la racine du site comme décrit ici.

On customise le fichier mes_options.php central comme on le souhaite. Voilà pour l'exemple celui de la plateforme mediaspip.net :

	if (!defined("_ECRIRE_INC_VERSION")) return;

	require _DIR_RACINE.'mutualisation/mutualiser.php';

```
 
```
```
	$site = $_SERVER['HTTP_HOST'];
```
```
	if ($site != $_SERVER['HTTP_HOST']) {
```
```
 include_spip('inc/headers');
```

 redirige_par_entete('http://'.$site.'/');

```
	}
```
```
 
```
```
	// Autoriser un cache de 50Mo
```
```
	$quota_cache = 50;
```
```
	// Ne pas autoriser les plugins auto
```
```
	define ('_DIR_PLUGINS_AUTO', false);
```

	define('_AUTORISER_TELECHARGER_PLUGINS',false);

```
 
```

	define ('_INSTALL_SERVER_DB', 'mysql');

	define ('_INSTALL_HOST_DB', 'localhost');

	define ('_INSTALL_USER_DB', 'useralternc');

	define ('_INSTALL_PASS_DB', 'password_alternc');

	define ('_INSTALL_NAME_DB', 'useralternc_'.prefixe_mutualisation($site));

	define ('_INSTALL_TABLE_PREFIX', 'spip');

```
 
```
```
	include_spip('inc/acces');
```
```
	if(!defined('_ACCESS_FILE_NAME')){
```

 define('_ACCESS_FILE_NAME', '.htaccess');

```
 }
```
```
	verifier_htaccess('config/');
```
```
 
```

	define ('_SITES_ADMIN_MUTUALISATION', 'www.mediaspip.net');

```
 
```
```
	demarrer_site($site,
```
```
 array(
```
```
 'creer_site' => true,
```
```
 'creer_base' => true,
```
```
 'creer_user_base' => false,
```

 'mail' => 'contact@mediaspip.net', // Adresse mail pour recevoir un mail lors d'une creation de site

 'code' => 'password_mutu',// Code d'activation principal

```
 'table_prefix' => false,
```
```
 'cookie_prefix' => true,
```
```
 'repertoire' => 'sites',
```
```
 'url_img_courtes' => true,
```

 'utiliser_panel' => true, // Utiliser une table externe pour recuperer des identifiants ... (code, user, pass) permettant a un utilisateur d'installer le site (false)

```
 'annonce' => '',
```

 'url_creer_base' => 'http://domaine.alernc.tld/admin/sql_doadd.php?username=useralternc&password=password_alternc&dbn='.prefixe_mutualisation($site), // Creer la base de donnees via une URL (methode Alternc)

 'url_hebergeur' => 'http://www.mediaspip.net',

 'url_contact_hebergeur' => 'http://www.mediaspip.net/spip.php?page=contact'

```
 )
```
```
	);
```
```
 
```
```
?>
```

Quelques explications concernant l'exemple ci-dessus :

nous utilisons Alternc pour gérer nos bases de données, donc nous utilisons également le ping sur une Url pour créer ces bases.
- On a créé au préalable un utilisateur spécifique Alternc (ici useralternc) en lui donnant un mot de passe (password_alternc), en ne limitant pas la création de bases pour cet utilisateur;
- On a également installé le site maître dans le compte de cet utilisateur;
- Les defines _INSTALL_USER_DB et _INSTALL_PASS_DB doivent être identiques au nom d'utilisateur et mot de passe passés en paramètre de l'Url de PING. Il n'y aura pas de problème de divulgation de mot de passe sur le réseau car le serveur Alternc doit être installé sur le même serveur pour que cela fonctionne et que ces infos ne sortiront donc pas de la machine;
Certaines options de la fonction demarrer_site sont également importantes :
- url_creer_base : correspond à l'adresse de ping sur le serveur Alternc;
- utiliser_panel : doit être à true pour bénéficier du plugin que nous documentons actuellement;
Le define _SITES_ADMIN_MUTUALISATION doit comporter l'adresse du site définie comme "maître";

On peut ensuite procéder à l'installation du site maitre (nous n'allons pas expliquer comment faire pointer vos DNS au bon endroit, cela est abordé dans le premier lien de cet article) et vous rendant avec votre navigateur sur son adresse, vous devrez utiliser pour ce premier site le code que vous avez utilisé dans la fonction demarrer_site().

Une fois la procédure d'installation terminée, SPIP aura créé un sous répertoire dans le dossier sites/ de votre installation comportant les 4 répertoires séparés pour cette instance. Dans le sous-répertoire config/, on va rajouter un fichier mes_options.php qui sera spécifique à cette instance et dans lequel on mettra les lignes suivantes :

define('_DIR_PLUGINS_SUPPL','../sites/www.mediaspip.net/plugins/');

```
?>
```