Legostar Galactica

für die Liste aller Seiten

Wenn PmWiki auf Ihrer Webseite erst einmal läuft (siehe Installation), können Sie es an Ihre eigenen Bedürfnissen anpassen. Die meisten Anpassungen erfolgen in einer Datei namens local/config.php sowie pub/css/local.css. Einige Einstellungen werden auf speziellen Seiten in den Gruppen Site (siehe auch Site-Konfiguration) und SiteAdmin (Site-Administration) vorgenommen. Ein Beispiel ist das Menü in der Seitenleiste (Site.SideBar).

Die zentrale Konfigurationsdatei (local/config.php)

Wenn Sie PmWiki das erste Mal installieren, gibt es noch keine Datei local/config.php. Kopieren Sie in diesem Fall die Datei sample-config.php (im docs/-Verzeichnis) nach local/config.php und verwenden diese als Startpunkt. Sie können natürlich die Datei local/config.php von Null auf erzeugen, allerdings enthält die Datei sample-config.php bereits die meisten Optionen, die man wahrscheinlich verwenden möchte.

Hier eine einfache config.php-Datei:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "Mein neues Wiki";
$PageLogoUrl = "http://www.beispiel.de/MeinLogo.gif";

# Kommentieren Sie dies ggf. aus und korrigieren Sie es, 
# wenn PmWiki daran scheitert, die vom Browser erreichbaren URLs zu ermitteln.
#$ScriptUrl = 'http://beispiel.de/pmwiki/pmwiki.php';
#$PubDirUrl = 'http://beispiel.de/pmwiki/pub';

$DefaultPasswords['admin'] = pmcrypt('geheimeins');

$EnableUpload = 1;
$DefaultPasswords['upload'] = pmcrypt('geheimzwei');

# Kommentieren Sie ggf. das passende aus, 
# wenn Ihr Server nicht in Ihrer Zeitzone liegt.
# Zentraleuropäische Zeit/Sommerzeit = UTC+1/2
# putenv("TZ=CET-1CEST"); # wenn Sie PHP 5.0 oder älter nutzen 
date_default_timezone_set('Europe/Berlin'); # für PHP 5.1 oder neuer

# deutsches Zeitformat mit vollständigem Monatsnamen,    
# wählen Sie %b statt %B für einen abgekürzten Monatsnamen
$TimeFmt = '%d. %B %Y, um %H:%M Uhr'; 

Beachten Sie, dass die config.php-Datei mit <?php beginnt. Die PHP-Endkennzeichnung ?> ist optional und sollte weggelassen werden, um die Kompatibilität mit manchen Betriebssystemen zu verbessern. Vor <?php oder nach ?> dürfen keine Leerzeichen oder Leerzeilen erscheinen, andernfalls kann es passieren, dass Sie seltsame Fehlermeldungen am Anfang Ihrer Wikiseiten sehen.

Die obige Datei config.php setzt die Werte von PHP-Variablen, die von PmWiki verwendet werden:

• Die Variable $WikiTitle enthält den Namen der Webseite, so wie er in der Titelzeile des Webbrowsers erscheint.
• Die Variablen $ScriptUrl und $PubDirUrl geben Ihrem Wiki an, wo es zu finden ist. Im Allgemeinen kann PmWiki das erraten, aber wenn Sie Probleme mit nicht funktionierenden Links oder mit nicht gefundenen Skins haben, kommentieren Sie die Zeilen aus.
• Die Variable $PageLogoUrl enthält die Internetadresse der Grafik, die in der oberen linken Ecke auf jeder Seite des Wikis erscheint.
• $DefaultPasswords['admin'] setzt ein Administratorpasswort.
• Das Setzen von $EnableUpload auf "1" ermöglicht das Hochladen von Dateien (Anhänge). $DefaultPasswords['upload'] setzt ein Passwort für das Hochladen.
• Die Funktion date_default_timezone_set() zeigt PHP an, welche die Standardzeitzone ist (für die Zeitstempel in 'Aktuelle Änderungen', 'Versionen' und Signaturen der Benutzer). Eine Liste mit möglichen Zeitzonen finden Sie in der Liste unterstützter Zeitzonen, weitere Informationen zu der Funktion auch in der PHP-Online-Dokumentation, siehe auch das Kochbuch-Rezept Cookbook:ChangeTimeFormat (nur auf Englisch verfügbar).
  • Wenn Ihre Seite PHP 5.0 oder älter nutzt, wird empfohlen, die TZ-Umgebungsvariable zu verwenden, siehe Cookbook:ChangeTimeFormat (nur auf Englisch verfügbar).
• Die Variable $TimeFmt bestimmt das Erscheinungsbild von Datums-/Zeitanzeigen, siehe Liste möglicher Parameter und das Kochbuch-Rezept Cookbook:ChangeTimeFormat (nur auf Englisch verfügbar).

Durch das Setzen dieser (und anderer) Variablen in local/config.php, können Sie das Aussehen und Verhalten von PmWiki von dessen Standardeinstellungen abweichend einstellen. Manchmal sogar beträchtlich anders. Siehe Variablen wegen einer Liste der von PmWiki verwendeten Variablen. Siehe auch PmWiki:PmWikiUsers (englisch) wegen Beispielen von Webseiten, die PmWiki mit eigenen Anpassungen einsetzen.

Weitere gebräuchliche Anpassungen

Die folgenden Variablen werden oft benötigt, wenn ein neues Wiki aufgesetzt wird:

• Ein Autorenname muss angegeben werden: $EnablePostAuthorRequired = 1;
• Setzen Sie die Standardgruppe $DefaultGroup und die Standardseite $DefaultPage.

Dieses verbreitete Kochbuch-Rezept wird ebenfalls häufig sofort installiert:

• Clean Urls - Entfernen der Seitenangabe mittels ?n=Group.Page am Ende der URLs (nur auf Englisch verfügbar)

Wenn Sie ein internationales Wiki vorbereiten, womöglich mit Sonderzeichen in anderen Alphabeten (Kyrillisch, Griechisch, Chinesisch), oder viele diakritische Symbole (Tschechisch, Französisch), konsultieren Sie bitte PmWikiDe.UTF-8 und Cookbook:UTF-8.

Sicherheit

Sehen Sie sich die Sicherheits-Hinweise an und nehmen Sie ggf. die dort vorgeschlagenen Anpassungen vor.

Setzen des Administratorpassworts

Die Seiten in der Site-Gruppe (außer Site.SideBar) sind standardmäßig vor der Bearbeitung geschützt. Um die Seiten in dieser Gruppe bearbeiten zu können, müssen Sie ein globales Administratorpasswort in local/config.php setzen. Um das globale Administratorpasswort auf "geheimnis" zu setzen, ändern Sie die entsprechende Zeile folgendermaßen:

Sie müssen die pmcrypt()-Funktion verwenden, um ein Passwort mit einem für Sie verständlichen Wert zu setzen. Siehe Administration der Passwörter um Näheres darüber herauszufinden, wie man Passwörter sicherer macht.

Verändern Sie pmwiki.php nicht (auch nicht umbenennen)

PmWiki wurde so entwickelt, dass alle Anpassungen ohne Änderung der Originaldateien erfolgen können -- eines der Entwicklungsziele war die Möglichkeit einfacher Upgrades. PmWiki schreibt niemals in Dateien in den Verzeichnissen local/ oder cookbook/. Wenn Sie Ihre Anpassungen dort vornehmen, wird es einfacher, Änderungen und Upgrades nachzufolgen, ohne dass Anpassungen verloren gehen.

Wenn Sie die Konfiguration der eigenen Webseite verändern, sollten Sie die Änderungen nur in der Datei local/config.php durchführen bzw. Dateien zu den Verzeichnissen cookbook/- oder pub/ hinzufügen. Verändern Sie weder pmwiki.php noch die Dateien im scripts/-Verzeichnis, da diese Dateien bei einem Upgrade überschrieben werden!

Sie sollten pmwiki.php auch nicht umbenennen. Wenn Sie dies tun, wird die Datei bei einem Upgrade der Software nicht mit der neuen Version überschrieben und man erhält eine Mischung zweier Versionen. Viele Administratoren erzeugen eine Datei index.php (als "wrapper script") im PmWiki-Verzeichnis, die nur die nachfolgende einzelne Zeile enthält:

Legen Sie einfach eine Textdatei an und fügen Sie <?php include('pmwiki.php'); ein. Speichern Sie die Datei als index.php und laden Sie die Datei mit FTP ins selbe Verzeichnis, in dem die originale Datei ''pmwiki.php'' liegt.

Verschiedenes zur Organisation von PmWiki-Dateien

Verzeichnisse, in denen hochgeladene Dateien gespeichert werden

Standardmäßig nutzt PmWiki für die hochgeladenen Dateien jeder WikiGruppe ein eigenes Verzeichnis (siehe Administration hochgeladener Dateien). Die Entscheidung, diese Standardeinstellung zu übernehmen oder eine Alternative (ein Verzeichnis für das gesamte Wiki oder ein Verzeichnis je WikiSeite) zu wählen, sollte am besten beim ersten Einrichten des Wikis getroffen werden.

Verzeichnisse, in denen die Wikiseiten gespeichert werden

Standardmäßig nutzt Pmwiki ein einzelnes Verzeichnis zum Speichern aller Wikiseiten (wiki.d). Die Entscheidung, diese Standardeinstellung zu übernehmen (was empfehlenswert ist) oder die Alternative, nämlich ein Verzeichnis je WikiGruppe, zu wählen, sollte am besten beim ersten Einrichten des Wikis getroffen werden ^[1].

Category GroupFooter

Für ein ganz neu aufgesetztes Wiki kann die Seite Category.GroupFooter aktualisiert werden auf

sodass nur kategorisierte oder getaggte Seiten erscheinen, d. h. solche mit einem [[!tag]]-Markup. Seiten, die auf Kategorien verweisen, d. h. jene mit einem [[Category.tag]]-Markup, bleiben außen vor.
Siehe Kategorien.

Sonstige Anpassungen

Nach dem Anpassen der Datei local/config.php möchte, Sie vielleicht weitere Lokale Anpassungen vornehmen. Siehe auch PmWiki-Kochbuch (Cookbook; nur auf Englisch verfügbar) wegen einer Vielzahl von Anpassungen, die zur Verfügung gestellt wurden. Und keine Angst vor Kochbuch-Rezepten - sie sind gut vorbereitet, so dass die meisten nur das Herunterladen einer Datei und das Einfügen einer include-Zeile in der config.php erfordern - und voilà, schon läuft 's!

Wenn Sie mehr als ein Wiki auf dem Server laufen lassen wollen, sollten Sie sich die Seite Wikifarmen ansehen.

Und jetzt?

Vergessen Sie nicht, sich bei einer der Mailinglisten anzumelden, bei der Sie andere Wiki-Administratoren um Hilfe bei der Konfiguration bitten und sich bei Diskussionen über Verbesserungen von PmWiki beteiligen können. Wenn Ihre Seite läuft, vergessen Sie auch nicht, diese unter PmWiki:PmWikiUsers einzutragen, damit auch andere davon wissen! für die Liste aller Seiten