Ce wiki est un espace de travail et d'organisation, les informations qu'il contient peuvent être fausses ou erronnées et ne constitue pas une communication officielle d'Actux.

Les Fermes Wiki sont un mcanisme destin faire tourner plusieurs Wikis indpendants sur une seule installation PmWiki. Si une ferme Wiki est une collection de Wikis indpendants, 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 tlchargement, les modles de page, les mots de passe, et autres configurations locales.

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 dcrit comment mettre en oeuvre des fermes Wiki et les champs associs, et suppose que vous tes dj familiariss avec les dtails 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 cre simplement un fichier local/farmconfig.php avec les configurations locales ncessaires pour tous les champs. Habituellement, cela signifie dfinir $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 dprcie depuis la version 2 cf Notes de versions Egide? 16 aot 2005 14h24

$FarmPubDirUrl est utilis pour fournir aux champs l'URL de la ferme sur le rpertoire pub/, et $PageTemplateFmt est modifi pour tre une version "ferme" partage de la mise en page par dfaut. (La seule vraie diffrence entre le modle normal et le modle pour ferme est que chaque modle pour ferme utilise $FarmPubDirUrl au lieu de $PubDirUrl dans les fichiers .css.)

Tout est fait -- votre installation PmWiki est maintenant prte tre configure pour tre une ferme!

Mise en oeuvre d'un champ dans une ferme Wiki (administrateur de champ)

Aprs installation de PmWiki pour en faire une ferme Wiki, un nouveau champ est cr en oprant comme suit:

1. Crer un rpertoire pour le champ. Normalement le rpertoire 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. Crer un script PHP (c.a.d., field.php) dans le rpertoire 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.

Noter qu'il n'est pas suffisant d'utiliser des liens symboliques ou des raccourcis pour se connecter l'installation de la ferme pmwiki.php; on doit utiliser un include de manire ce que PmWiki soit capable de situer correctement la situation des scripts/ de la ferme et des autres rpertoires.

3. Changer les attributs du rpertoire de champ en 2777.

4. Ouvrez un navigateur web et excuter le script field.php que vous avez cr lors de l'tape #2. Ceci crera les rpertoires ncessaires au champ et doit afficher l'installation PmWiki par dfaut (avec tous les paramtres par dfaut que l'administrateur de la ferme dfini).

Personnalisation des champs et des fermes

Chaque administrateur de champ peut crer un rpertoire local/ dans le rpertoire 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 paramtres de la totalit du champ, et les fichiers de la forme local/Group.php et local/Group.PageName.php sont utiliss pour une personnalisation des groupes et des pages (voir PerGroupCustomizations).

Dans un champ, la variable PmWiki $FarmD est mise "rpertoire principal" pour l'installation de la ferme PmWiki, aussi un administrateurpeut utiliser $FarmD/scripts/ et $FarmD/pub/ pour renvoyer vers les rpertoires de ferme scripts/ et pub/.

Un administrateur de ferme peut utiliser le fichier local/farmconfig.php pour la personnalisation applique tous les champs de la ferme. Par dfaut, les personnalisations de ferme sont appliques 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
    # Paramtres interprts 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;          # dsactive le tlchargement
  ?>

Notes

  • Les rpertoires de champ peuvent aussi contenir des rpertoires locaux pub/ et uploads/. un rpertoire uploads/ pour chaque champ sera normalement cr dans le rpertoire du champ si les tlchargements sont activs (voir Administration des fichiers joints).
  • Les pages distribues avec PmWiki (c.a.d. la documentation) sont automatiquement partages entre tous les champs de la ferme. Ceci est contrl via la variable $WikiLibDirs, qui vrifie par dfaut dans la copie de la ferme de wikilib.d/.
  • Le fichier farmmap.txt dans le rpertoire local/ de la ferme peut tre utilis pour fournir des Liens InterMap sur le territoire de la ferme. Ceci peut tre pratique pour crer des liens vers les autres pages de la ferme.
  • En general, les champs peuvent tre crs et administrs depuis des comptes utilisateurs autres que celui de la ferme si les persmissions du systme d'exploitation et la configuration de PHP le permettent. La configuration par dfaut de PHP le permet normalement, mais certains administrateurs systmes et hbergeurs changent la configuration de PHP d'une manire que ceci ne soit plus possible.

Voir aussi le cookbook: (en Anglais)
Cookbook:WikiFarm et Cookbook:WhichFarmToUse.


<< Approbation des URLs | Index doc admin | Taille limite >>


Traduction de PmWiki.WikiFarms Page originale sur PmWikiFr.WikiFarms - Référencé par
Dernières modifications:
PmWikiFr.WikiFarms: 08/04/2006 19:04
PmWiki.WikiFarms: 04/10/2009 13:59