LSS Wiki | PmWikiDe / Lokale Anpassungen

Autoren (Grundlagen) (deutsche Übersetzung der Seite PmWiki.LocalCustomizations, Stand 2005-09-18)

Von Anfang an wurde PmWiki so entwickelt, dass ein Administrator des Wikis sehr stark beeinflussen kann, wie PmWiki Seiten anzeigt bzw. welche Auszeichnungen verwendet werden. (Besonders erwähnt unter PmWiki Philosophie Punkt 4.) Als ein Ergebnis davon verwendet das pmwiki.php Skript reichlich Variablen um Einfluß darauf zu nehmen, wie Auszeichnungen verarbeitet werden und was die einzelnen Seiten ausgeben werden. Dadurch kann ein Administrator viele Anpassungen vornehmen, indem er einfach Variablen in der Datei config.php setzt.

Der Großteil dieser Seite beschreibt, wie Anpassungen im Allgemeinen funktionieren. Siehe Dokumentationsindex für genauere Informationen über spezielle Anpassungen, die häufiger bei vielen PmWiki Installationen durchgeführt werden, z.B.:

Das Unterverzeichnis scripts/ (unter dem Verzeichnis, das pmwiki.php enthält) und das PmWiki Cookbook (Kochbuch) enthält viele Beispiele zu Anpassungen, die man in die eigene config.php Konfiguration integrieren kann. Die ersten paar Zeilen jedes Skriptes enthalten im Allgemeinen Anweisungen wie man die Funktionen aktiviert (und nutzt). Bei den meisten Skripts reichte es aus

include_once("scripts/skriptdatei.php");

irgendwo in der Datei config.php unterzubringen um dessen Funktionen zu aktivieren. Manche Skripts werden automatisch über die Datei scripts/stdconfig.php aktiviert, solange man nicht $EnableStdConfig=0; in der Datei local/config.php setzt.

Man sollte der Versuchung wiederstehen die Datei pmwiki.php oder die Dateien im Unterverzeichnis scripts/ direkt zu verändern. Jegliche Änderung wird vielleicht mit dem nächsten Upgrade überschrieben. Stattdessen sollte man Ausschau nach Anpassungen halten, die in der Datei config.php durchgeführt werden können. Man kann sogar sein eigenes Skript erzeugen und es mit include_once(...) in der config.php einbinden. Wenn man eigene Skripts mit Anpassungen erstellt, kann man diese problemlos im Unterverzeichnis cookbook/ speichern. Dort werden sie bei Upgrades nicht überschrieben. Eventuell möchte man auch diese Anpassungen anderen über die pmwiki-users Mailingliste oder das Kochbuch zur Verfügung stellen, so dass auch andere Benutzer davon profitieren können, oder es sogar in eine zukünftige Version von PmWiki einfliessen kann.

<< XLPage für Kochbuch Rezepte | Dokumentationsindex | Individuelle Einstellungen pro Gruppe >>