Les Fermes Wiki sont un mécanisme destiné à faire tourner plusieurs Wikis indépendants sur une seule installation PmWiki. Si une ferme Wiki est une collection de Wikis indépendants, alors chaque Wiki dans la ferme est usuellement appellé un champ Wiki. Une personne qui supervise l'installation du moteur PmWiki est appellé un administrateur de ferme, alors que les administrateurs de chaque champ sont les administrateurs de champ. Chaque champ peut avoir sa propre URL, son ensemble de pages et de groupes Wiki, le téléchargement, les modèles de page, les mots de passe, et autres configuration locale.
Plus important, la mise à jour du moteur vers une (unique) ferme met à jour automatiquement tous les champs de la ferme. De plus, les personnalisations peuvent être faites au niveau de la ferme, et s'appliquer à tous ses champs.
Le reste de ce document décrit comment mettre en oeuvre des fermes Wiki et les champs associés, et suppose que vous êtes déjà familiarisés avec les détails de l'installation de PmWiki.
Installer une ferme Wiki (administrateur de ferme)
Installer PmWiki pour le faire fonctionner comme une ferme Wiki est relativement simple. L'administrateur de la ferme crée simplement un fichier local/farmconfig.php avec les configurations locales nécessaires pour tous les champs. Habituellement, cela signifie définir $FarmPubDirUrl et $PageTemplateFmt pour le nouveau champ. Un fichier farmconfig.php minimum pourrait être:
<?php
$FarmPubDirUrl = 'http://www.exemple.com/pmwiki/pub';
$PageTemplateFmt = "$FarmD/pub/skins/pmwiki/pmwiki-farm.tmpl";
?>
Attention, la variable $PageTemplateFmt est dépréciée depuis la version 2 cf NotesDeVersions Egide? 16 août 2005 à 14h24
$FarmPubDirUrl est utilisé pour fournir aux champs l'URL de la ferme sur le répertoire pub/, et $PageTemplateFmt est modifié pour être une version "ferme" partagée de la mise en page par défaut. (La seule vraie différence entre le modèle normal et le modèle pour ferme est que chaque modèle pour ferme utilise $FarmPubDirUrl au lieu de $PubDirUrl dans les fichiers .css.)
Tout est fait -- votre installation PmWiki est maintenant prête à être configurée pour être une ferme!
Mise en oeuvre d'un champ dans une fermeWiki (administrateur de champ)
Après installation de PmWiki pour en faire une ferme Wiki, un nouveau champ est créé en opérant comme suit:
1. Créer un répertoire pour le champ. Normalement le répertoire du champ est dans une zone accessible par Internet (c.a.d., dans public_html), mais il peut être mis partout ou une installation PmWiki pourrait l'être.
2. Créer un script PHP (c.a.d., field.php) dans le répertoire de champ avec la ligne suivante
<?php include('chemin/vers/pmwiki.php'); ?>
ou chemin/vers/pmwiki.php est le chemin de l'installation de la ferme.
3. Changer les attributs du répertoire de champ en 2777.
4. Ouvrez un navigateur web et exécuter le script field.php que vous avez créé lors de l'étape #2. Ceci créera les répertoires nécessaires au champ et doit afficher l'installation PmWiki par défaut (avec tous les paramètres par défaut que l'administrateur de la ferme à défini).
Personnalisation des champs et des fermes
Chaque administrateur de champ peut créer un répertoire local/ dans le répertoire du champ pour une configuration locale qui s'appliquera au champ. Ceci fonctionne comme sur une installation PmWiki classique -- le fichier local/config.php contient les paramètres de la totalité du champ, et les fichiers de la forme local/Group.php et local/Group.PageName.php sont utilisés pour une personnalisation des groupes et des pages (voir personnalisation par groupe).
Dans un champ, la variable PmWiki $FarmD est mise à "répertoire principal" pour l'installation de la ferme PmWiki, aussi un administrateurpeut utiliser $FarmD/scripts/ et $FarmD/pub/ pour renvoyer vers les répertoires de ferme scripts/ et pub/.
Un administrateur de ferme peut utiliser le fichier local/farmconfig.php pour la personnalisation appliquée à tous les champs de la ferme. Par défaut, les personnalisations de ferme sont appliquées avant celle des champs; cependant, l'administrateur de ferme peut forcer certaines personnalisation de champ en appellant explicitement le fichier config.php du champ, comme ceci:
<?php
# Paramètres interprétés avant les personnalisations de champ
$FarmPubDirUrl = 'http://www.exemple.com/pmwiki/pub';
$PageTemplateFmt = "$FarmD/pub/skins/pmwiki/pmwiki-farm.tmpl";
# charger les personnalisations du champ (globale et par groupe)
include_once('local/config.php');
include_once('local/pgcust.php');
# forcer les personnalisations de champ ici
$EnableUpload = 0; # désactive le téléchargement
?>
Notes
- Les répertoires de champ peuvent aussi contenir des répertoires locaux pub/ et uploads/. un répertoire uploads/ pour chaque champ sera normalement créé dans le répertoire du champ si les téléchargements sont activés (voir administration des téléchargements).
- Les pages distribuées avec PmWiki (c.a.d. la documentation) sont automatiquement partagées entre tous les champs de la ferme. Ceci est contrôlé via la variable $WikiLibDirs, qui vérifie par défaut dans la copie de la ferme de wikilib.d/.
- Le fichier farmmap.txt dans le répertoire local/ de la ferme peut être utilisé pour fournir des liens InterMap sur le territoire de la ferme. Ceci peut être pratique pour créer des liens vers les autres pages de la ferme.
- En general, les champs peuvent être créés et administrés depuis des comptes utilisateurs autres que celui de la ferme si les persmissions du système d'exploitation et la configuration de PHP le permettent. La configuration par défaut de PHP le permet normalement, mais certains administrateurs systèmes et hébergeurs changent la configuration de PHP d'une manière que ceci ne soit plus possible.
Voir aussi le cookbook: (en Anglais)
http://www.pmwiki.org/Cookbook.WikiFarm et http://www.pmwiki.org/Cookbook.WhichFarmToUse.
<< Approbation des URLs | Index doc admin | Taille limite >>
Traduction de la page PmWiki:WikiFarms - Page originale sur PmWiki:PmWikiFr.FermesWiki