Custom Headers and Footers

Diese Seite beschreibt wie Du die auf einer Wikiseite erscheinenden Kopf- und Fußbereiche (Headers und Footers genannt) verändern kannst. Das Festlegen der Headers und Footers wird normalerweise durch die Definition bestimmter Variablen in der Datei config.php erledigt (beschrieben in Initial Setup Tasks und Local Customizations).

Anmerkung: Diese Seite beschreibt die in Version 0.5 vorhandenen Anpassungsmöglichkeiten. Auch wenn die untenstehenden Anleitungen für Version 0.6 und folgende noch stimmen, gibt es ab Version 0.6 ausgeklügeltere Layoutmechanismen, die auf Stylesheets beruhen. Siehe Layout Basics für Details.

Das Erscheinungsbild einer Wikiseite wird durch die Variablen $PageHeaderFmt und $Page Footer Fmt kontrolliert. $PageHeaderFmt spezifiziert die HTML-Anweisungen, die zwischen dem HTML-Tag @@<body>@@ und dem eigentlichen Inhalt der Wikiseite eingefügt werden. Analog dazu spezifiziert $Page Footer Fmt die HTML-Anweisungen, die hinter dem Inhalt der Wikiseite aber noch vor dem abschließenden </body>-Tag eingefügt werden. Um das Seitenlayout so zu verändern, dass am Seitenanfang nur noch ein einfacher Titel und am Seitenende nur ein Verweis “Bearbeiten” erscheint, könnte man die folgenden Zeilen in die Datei config.php einfügen:

    $PageHeaderFmt = '

$Title

<hr />’; $PageFooterFmt = ‘<hr /><small> Bearbeiten</small>’;

Für beide Variablen (und die meisten anderen PmWiki-Variablen, die mit ‘Fmt’ enden) wird vor der Ausgabe eine globale $-Variablen-Substitution durchgeführt. Damit werden beim Ausgeben der Seite die Ausdrücke @@$Title und $PageUrl@@ in der obigen Anweisung durch den Titel der Seite und die URL der Seite ersetzt,

$PageHeaderFmt und $Page Footer Fmt erlauben es auch, HTML-Anweisungen aus einer Datei auf der Festplatte, einer vom Administrator definierten PHP-Funktion oder einer anderen Wikiseite einzufügen. Beispielsweise kann man eine Datei namens local/myheader.html erzeugen, die die HTML-Anweisungen für den Kopfbereich der Seite enthält, und den Inhalt dieser Datei durch folgende Variablendeklaration als Header einfügen.

    $PageHeaderFmt = 'file:local/myheader.html';

Andere Beispiele wären:

    
    # einfügen einer PHP-Datei
    $PageHeaderFmt = 'file:local/myheader.php';    
    # einfügen einer benutzerdefinierten Funktion
    $PageHeaderFmt = 'function:MyHeaderFunction';  
    # einfügen einer auf Gruppenbasis definierten Wikiseite in den
    # Kopfbereich 
    $PageHeaderFmt = 'wiki:$Group.PageHeader';      

Schließlich können beide beschriebenen Variablen Arrays mit mehreren auszugebenden Werten sein, wobei Kombinationen der oben beschriebenen Datenquellen möglich sind. Das Beispiel

    
    $PageHeaderFmt = array(
      '<h1>$Group.$Title</h1><table><tr><td width="20%">',
      'wiki:$Group.LeftMenu',
      '</td><td>');
    $PageFooterFmt = '</td></table>';

erzeugt eine Seite mit Gruppennamen und -titel am Seitenanfang, gefolgt von einer HTML-Tabelle mit zwei Zellen. Dabei enthält die linke Zelle den Inhalt der Seite LeftMenu und die rechte Zelle den eigentlichen Inhalt der Wikiseite.

Siehe Page Layout für weitere Details zur Organisation und Struktur der von PmWiki erzeugten Seiten.

« PmWiki-Formatierungsanweisungen anpassen | PmWiki.Documentation Index | Ausgabe von RSS »



This page may have a more recent version on pmwiki.org: PmWiki:CustomHeadersAndFooters, and a talk page: PmWiki:CustomHeadersAndFooters-Talk.