• Anzeigen
• Bearbeiten
• Versionen
• Druckansicht
• Rückverweise

Erste Einstellungen

Wenn PmWiki auf Ihrer Webseite erst einmal läuft (siehe Installation), kann man es den 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 man PmWiki das erste Mal installiert, 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. Man kann 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 Datei config.php:

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

# Kommentieren Sie dies ggf. aus.
#$ScriptUrl = 'http://example.com/pmwiki/pmwiki.php';
#$PubDirUrl = 'http://example.com/pmwiki/pub';

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

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

#Kommentieren Sie ggf. das passende aus.
#Zentraleuropäische Zeit/Sommerzeit
# putenv("TZ=CET-1CEST"); # wenn Sie PHP 5.0 oder älter nutzen
# date_default_timezone_set('Europe/Berlin'); # wenn Sie PHP 5.1 oder neuer benutzen

# $TimeFmt = '%d. %B %Y, um %H:%M Uhr'; # deutsches Zeitformat

Man beachte, dass die Datei config.php 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 man seltsame Fehlermeldungen am Anfang seiner Wikiseiten sieht.

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 TZ Umgebungsvariable definiert eine bestimmte Zeitzone. Siehe das Kochbuch-Rezept Cookbook:ChangeTimeFormat (nur auf Englisch verfügbar). Wenn Ihre Seite PHP 5.1 oder neuer nutzt, wird empfohlen, die Funktion date_default_timezone_set zu benutzen (Siehe unten).
• Die Funktion date_default_timezone_set gibt PHP an, welche die Standardzeitzone ist. Wegen anderer Möglichkeiten, die Zeitzone zu setzen, und wegen einer Liste mit Parametern, siehe http://de2.php.net/manual/de/timezones.europe.php.
• Die Variable $TimeFmt bestimmt das Erscheinungsbild von Datums-/Zeitanzeigen und lokalisiert sie (zusammen mit TZ) für eine bestimmte Zeitzone. Siehe das Kochbuch-Rezept Cookbook:ChangeTimeFormat (nur auf Englisch verfügbar).

Durch das Setzen dieser (und anderer) Variablen in local/config.php, kann man 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 der Standardgruppe: $DefaultGroup

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, muss man ein globales Administratorpasswort in local/config.php setzen. Um das globale Administratorpasswort auf "geheimnis" zu setzen, ändern Sie die entsprechende Zeile folgendermaßen:

Man muss die crypt() 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 man seine Anpassungen dort vornimmt, wird es einfacher, Änderungen und Upgrades nachzufolgen, ohne dass Anpassungen verloren gehen.

Wenn man die Konfiguration der eigenen Webseite verändert, sollte man 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!

Man sollte pmwiki.php auch nicht umbenennen. Wenn man dies tut, 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:

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].

Sonstige Anpassungen

Nach dem Anpassen der Datei local/config.php möchte man 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äufts!

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!

Übersetzung von PmWiki.InitialSetupTasks Originalseite auf PmWikiDe.InitialSetupTasks - Rückverweise
Zuletzt geändert:
PmWikiDe.InitialSetupTasks am 21.04.2014
PmWiki.InitialSetupTasks am 27.11.2022