(Opens in a new window - öffnet in einem neuen Fenster)
Kurz-Dokumentation Plugin "PageXplorer"
Version PageXplorer 2.0 - released 2025-12
- Das Plugin PageXplorer ersetzt das CMSimple Inhaltsverzeichnis (sitemap) mit dem PageXplorer, ein Inhaltsverzeichnis im Stil des Windows Explorer.
- Die Seitenstruktur kann einzeln mit +/- Zeichen vor den Links geöffnet und geschlossen werden.
- Mit Hilfe von Buttons kann der PageXplorer komplett geöffnet und geschlossen werden.
1. Systemvoraussetzungen
Voraussetzung ist eine funktionierende Installation von CMSimple 4.2 oder höher.
2. Installation
- zip-Datei herunterladen und mit einem geeigneten Programm entpacken
- Laden Sie den Ordner pagexplorer/ in das Verzeichnis ./plugins/ Ihrer CMSimple Installation hoch.
3. Datei- und Ordnerrechte
Damit das Programm funktioniert und arbeiten kann (bzw. administrierbar ist), müssen einige Dateien und Ordner beschreibbar sein. Auf modernen Webservern muss man sich jedoch in der Regel darum nicht kümmern.
Dateien: chmod 666
- ./plugins/pagexplorer/css/stylesheet.css
- ./plugins/pagexplorer/config/config.php
- ./plugins/pagexplorer/languages/alle Dateien
4. Pluginaufrufe
Hinweis: Bitte fügen Sie die Plugin Aufrufe auf einer CMSimple Seite immer in der Quelltext Ansicht ein.
Oder kopieren Sie die äusseren geschweiften Klammern nicht mit und fügen Sie diese nach dem kopieren von Hand auf der CMSimple Seite wieder ein.
4.1 PageXplorer cssTree
Den PageXplorer cssTree kann man im Template und auf CMSimple Seiten aufrufen.
Aufruf auf einer CMSimple Seite:
{{{plugin:pex_csstree('CSS Klasse');}}}
CSS Klasse (optional): eine zusätzliche CSS Klasse, standardmässig mitgeliefert: 'pex_circles' und 'pex_balls'
Aufruf im Template:
<?php echo pex_csstree('CSS Klasse'); ?>
CSS Klasse (optional): eine zusätzliche CSS Klasse, standardmässig mitgeliefert: 'pex_circles' und 'pex_balls'
4.2 PageXplorer cssTree speziell als toc (table of contents / Menü) in schmalen Sidebars
Den PageXplorer cssTree als toc kann man im Template und auf CMSimple Seiten aufrufen. Er hat keine Toolbar zum ein- und ausklappen des Menüs und eine geringere Einrückung.
Aufruf auf einer CMSimple Seite:
{{{plugin:pex_csstreeToc();}}}
Aufruf im Template
Ein typischer Einsatz dieser Funktion ist der Einsatz als CMSimple Menü (toc: table of content). Dazu kann man einfach in der template.htm des Templates die Funktion toc() mit der Funktion pex_csstreeToc() überschreiben. Mit dem folgenden Code stürzt die Seite nicht ab, wenn das Plugin inaktiv ist.
<?php if(function_exists('pex_csstree')) echo pex_csstreeToc(); else echo toc(); ?>
Meistens sind dann noch ein paar Designanpassungen vorzunehmen, siehe Punkt 4.4 dieser Kurzdoku. Templates von ge-webdesign mit dem Datum 2026 und höher sind standardmässig auf den PageXplorer vorbereitet.
4.3 Hinweise zu versteckten Seiten
Ab Version 2.0 haben die PageXplorer Menüs und das Inhaltsverzeichnis eine Vererbungsfunktion für versteckte Seiten. Das heisst, dass auch alle Unterseiten einer versteckten Seite in den Menüs und im Inhaltsverzeichnis nicht angezeigt werden. Man kann sie aber trotzdem aufrufen, wenn man den URL kennt.
Die Vererbungsfunktion für versteckte Seiten kann in der Plugin Konfiguration deaktiviert werden.
4.4 Design Anpassungen
Design Anpassungen des PageXplorer jsTree sind kompliziert und eher nicht zu empfehlen.
Beim Einsatz des PageXplorer cssTree als toc (CMSimple Menü) kann es vorkommen, dass Anpassungen am Design notwendig sind.
Diese Anpassungen sollten nicht im Plugin Stylesheet vorgenommen werden, sondern im Stylesheet des Templates.
Wenn notwendig unter Einsatz von !important.
Beispiel:
/* CSS for replacing toc() by PageXplorer - use !important if necessary */
.tplge_sidebarNav .pex_csstreeToc {background: #245!important; padding: 0 0 16px 0!important; margin: 0!important;}
.tplge_sidebarNav .pex_csstreeToc a:link {color: #fff!important; text-decoration: none;}
.tplge_sidebarNav .pex_csstreeToc a:visited {color: #fff!important; text-decoration: none;}
.tplge_sidebarNav .pex_csstreeToc a:hover {color: #fc0!important; text-decoration: none;}
.tplge_sidebarNav .pex_csstreeToc a:active {color: #fc0!important; text-decoration: none;}
.tplge_sidebarNav .pex_csstreeToc a:focus {color: #fc0!important; text-decoration: none;}
.tplge_sidebarNav .pex_csstreeToc .pex_activePage a {color: #fc0!important;}
In diesem Beispiel ist .tplge_sidebarNav der Ort im Template, .pex_csstreeToc und .pex_activePage a sind die zu überschreibenden Elemente im Plugin.