Template Hooks (statische Inhalte an verschiedenen Stellen einbinden)

Bei DokuWiki können an bestimmten Stellen im Template (dem Design) feste Inhalte eingebunden werden. Damit können beispielsweise wichtige Hinweise verbreitet werden, die auf jeder Seite im Wiki angezeigt werden.

Beachten Sie, dass Sie in diesen Dateien HTML- oder PHP-Quelltext schreiben müssen, Wiki-Code kann hier nicht verwendet werden.

Die Dateien sind Update-sicher, werden also bei einem Update nicht überschrieben. Legen Sie eine oder mehrere er folgenden Dateien entweder im Template-Verzeichnis (lib/tpl/dokuwiki/) oder im conf/-Verzeichnis ab. Beachten Sie dabei, dass evtl. nicht alle der folgenden Dateien verwendet werden können, falls Sie ein anderes Template als den mitgelieferten Standard verwenden.

Dateiname	Position des HTML-Codes
meta.html	Innerhalb des HTML <head>, zum Beispiel zum Einbinden weiterer CSS-Dateien. Hier eingefügter Text ist für den Betrachter unsichtbar und wird nur vom Server oder Browser ausgewertet.
sidebarheader.html	Oberhalb der Sidebar (Navigation)
sidebarfooter.html	Unterhalb der Sidebar (Navigation)
pageheader.html	Oberhalb des Seiteninhalts
pagefooter.html	Unterhalb des Seiteninhalts
header.html	Ganz am Anfang der Seite
footer.html	Ganz am Ende der Seite

Im folgenden Bild ist ersichtlich, wo die Inhalte der einzelnen Dateien eingebunden werden.

Template Hooks innerhalb der Seite

Anwendungsbeispiel

Auf der öffentlichen Einsatzleiterwiki-Seite im Internet wird der pageheader.html dafür verwendet, um dem Benutzer darüber zu informieren ob er sich in der offenen (bearbeitbaren) oder geschlossenen (schreibgeschützten) Version des Einsatzleiterwikis befindet. In der offenen Version hat der pageheader.html folgenden Inhalt:

<div class="wrap_round wrap_tip wrap_center plugin_wrap" style="width: 100%;"> <p>Sie befinden sich in der bearbeitbaren Version des Einsatzleiterwiki-Projekts. Klicken Sie <a href="http://www.einsatzleiterwiki.de/" target="_blank">hier</a> für allgemeine Informationen zum Projekt.</p> </div>

Template Hook-Beispiel aus der öffentlichen Einsatzleiterwiki-Version

Quellenangabe

Template Hooks allgemein in der englischsprachigen DokuWiki-Hilfe

Template Hooks für speziell für das DokuWiki-Template in der englischsprachigen DokuWiki-Hilfe

Tracedump:

newBaseSize: 16pt
newBaseSizeInPt: 16