Blättern im Kapitel: blaettern

Erstellt am 27.03.2022 Lesedauer ≤ 1 Min.

Innerhalb eines Verzeichnisses werden dynamisch Links zum Vorgänger und Nachfolger der aktuellen Datei erzeugt.

Das Modul erfordert das Script zFold.php

Aufruf

[blaettern format pfad]

Parameter

format: eine (optionale) Formatklasse für das die Navigation umschließende DIV.

pfad | optional: Default ist !submenu

Gibt es keinen Vorgänger wird Kapitelanfang, ohne Nachfolger Kapitelende ausgegeben. Ansonsten wird der Datei-Titel der jeweiligen Datei als Link angezeigt. Es können mehrere Navigationenen (oben, Mitte, …) auf einer Seite eingefügt werden.

Die Reihenfolge wird zuerst über die Yaml-Varialbe !rang und dann aufsteigend alphabetisch über den title bestimmt.

Statt !submenu (typischerweise gefüllt mit %%%CURRPATH%%%) kann ein beliebiger Pfad übergeben werden.

Fehlt einer Datei im übergebenen Pfad der Titel, ist keine Titelnavigation möglich.

Das Modul

blaettern css pfad=%%%!submenu%%%
<?php
include_once ($_SERVER["DOCUMENT_ROOT"] . '/res/zFold.php');
echo blaettern('§§§pfad§§§',str_pad(intval('%%%!rang%%%'), 5 , '0' , STR_PAD_LEFT) . '%%%title%%%','§§§css§§§');
?>

Die hier in der Hilfe in den Abschnitten eingeblentete Seitennavigation (oben/unten) wird mit dem für das Modul erstellte Script zFold.php erzeugt.

Es wurde dahingehend angepasst, dass es nur eine Navigation anzeigt, wenn es im Verzeichnis mehrere Dateien gibt, der Aufruf direkt ins Layout integriert.

Zusätzlich steuert es hier die Anzeige des Menüs: Wird „geblättert“, klappt das Menü ein.