für die Liste aller Seiten

Einer der Zwecke von Wikigruppen ist, einem Administrator des Wikis die Möglichkeit zu geben, die Besonderheiten von PmWiki auf einer per-Gruppen-Basis anzupassen. So kommt die Anpassung pro Gruppe ins Spiel:

• Das local/-Unterverzeichnis (typischerweise in $FarmD) wird benutzt, um lokale Konfigurationen zu speichern.
• Das pub/css/-Unterverzeichnis (typischerweise in $FarmD) wird benutzt, um lokale CSS-Dateien zu speichern.

Um eine lokale Anpassung für eine bestimmte Gruppe durchzuführen,

• fügen Sie eine Anpassungsdatei namens "<gruppenname>.php" in das local/-Unterverzeichnis ein, wobei <gruppenname> durch den wirklichen Namen der Gruppe von Seiten zu ersetzten ist, und
• fügen Sie die CSS-Anpassung als Datei namens "<gruppenname>.css" in das pub/css/-Unterverzeichnis ein, wobei <gruppenname> durch den wirklichen Namen der Gruppe von Seiten zu ersetzten ist.

Diese Dateien werden automatisch abgearbeitet, nachdem die lokalen Anpassungen in config.php und local.css abgearbeitet wurden.

Um beispielsweise das Bild zu ersetzen, das in der oberen, linken Ecke der "GruppenName"-Seiten erscheint, kann man eine local/GruppenName.php-Datei erzeugen mit folgendem Inhalt:

<?php
  $PageLogoUrl = "/meinebilder/schach.gif";

Das Beispiel hat den Effekt, dass alle Seite in der GruppenName-Wikigruppe das Bild "/meinebilder/schach.gif" als Logo anstelle des Standardlogos einsetzen.

Für das Hinzufügen von Auszeichnungen oberhalb oder unterhalb des Textes siehe Kopfbereich (und Fußbereich) der Gruppe.

Individuelle Anpassungen pro Seite

PmWiki erlaubt auch die Anpassungen für einzelne Seiten. Benutzen Sie einfach den kompletten Seitennamen der anzupassenden Seite anstelle des Gruppennamen. Beispielsweise kann man eine Datei local/Schach.HomePage.php nutzen, um lokale Anpassungen für die Seite Schach.HomePage zu machen.

Nahezu jede Anpassung, die man in die config.php setzen würde, kann man auch für gruppen- oder seitenweise Anpassungen nutzen.

Eine wichtige Ausnahme dazu ist, gruppen- oder seitenweise Anpassungen für Rezept-Skripten zu setzen, die in der config.php eingefügt wurden. Die meisten Rezepte müssen ihre Anpassungs-Variablen gesetzt bekommen, bevor das Skript eingefügt wird. Statt eine gruppen- oder seitenweise Anpassungs-PHP-Datei zu benutzen, setzt man eine bedingte Anweisung in die config.php, bevor man das Rezeptskript einfügt. Beispiel:

$page = PageVar($pagename, '$FullName');
$group = PageVar($pagename, '$Group');
//per-group customizations:
if($group=='GroupName') {
   $RecipeVariable = 'valueA';
   etc. ...
}
//per-page customizations:
if($page=='GroupName.PageName) {
   $RecipeVariable = 'valueB';
   etc. ...
}
//include recipe after variables are set:
include_once('cookbook/recipescript.php');

Beachten Sie, dass diese Methode nicht dafür benutzt werden kann, die Variable $DefaultPasswords zu setzen, Sie sollten Gruppen- oder Seitenattribute dafür benutzen, siehe Passwörter und Passwörter verwalten für weitere Informationen.

Bearbeitungsreihenfolge

Für alle Anpassungen bearbeitet PmWiki zuerst die local/config.php. Dann sieht es im local/-Unterverzeichnis nach, ob es eine Datei für seitenweise Anpassungen gibt und lädt sie ggf., danach ggf. die für gruppenweise Anpassungen. Wenn es keine der beiden Dateien gibt, lädt PmWiki local/default.php. Wenn es für eine seitenweise Anpassung nötig ist, dass die gruppenweise Anpassung zuerst geladen wird, können Sie das bewirken, indem Sie in der Datei für die seitenweise Anpassung PHPs include_once()-Funktion benutzen. Für weitere Informationen siehe Wiki-Kaskaden.

Individuelle CCS-Anpassungen für Gruppen oder Seiten

Um CSS-Stile auf Seiten einer bestimmten Gruppe namens GruppenName anzuwenden, erzeugt man eine Datei namens GruppenName.css im pub/css/-Verzeichnis und füllt diese Datei mit den zusätzlichen Stilregeln. Um Stile auf eine bestimmte Seite anzuwenden, erzeugt man eine Datei in diesem Verzeichnis namens GruppenName.SeitenName.css mit den gewünschten CSS-Stilen. Alle CSS-Regeln, die auf alle Wikiseiten angewendet werden sollen, fügt man in die Datei pub/css/local.css ein.

/pub/css/GroupName.css:

  body { background: #F4C4B4; }

Verhindern von Konfigurationen auf Gruppenebene

Jede Anpassungsdatei kann $EnablePGCust=0; setzen, um eine spätere automatische Ausführung einer Seiten-/Gruppen-/Standard-Anpassung zu verhindern. Wenn es für eine seitenweise Anpassung nötig ist, dass die gruppenweise Anpassung zuerst geladen wird, können Sie das bewirken, indem Sie in der Datei für die seitenweise Anpassung PHPs include_once()-Funktion benutzen. Für weitere Informationen siehe Wiki-Kaskaden.

Authentifikation

Alle Passwörter für eine Gruppe sollten in den Gruppenattributen der Gruppeseite gesetzt werden (siehe Passwortadministration), nicht in einer Gruppen-Anpassungsdatei.

Wikifarmen berücksichtigen

Wikigruppen sind ein leichter Weg, mehrere Sites in einer einzigen Wikiinstallation zu beherbergen, indem man jeder Site eine eigenen Gruppe gibt. Ein anderer Weg ist, Wikifarmen zu nutzen. Das erlaubt jeder Site, einen eigenen Satz von Wikigruppen und lokalen Anpassungsdateien zu haben. Mehr dazu in Wikifarmen →Begriffserklärung und Installation von Wiki-Farmen

Wenn sie nach verschachtelten Gruppenebenen suchen, sollten Sie dies bedenken: Pm's design considerations on hierarchical groups.

für die Liste aller Seiten