# Pagemanager_XH - Handbuch

# Pagemanager_XH - ein CMSimple_XH Plugin

Pagemanager_XH vereinfacht die Verwaltung von Seiten in einer CMSimple_XH-Installation. Dieses Plugin ist vom Funktionsumfang vergleichbar mit dem Menumanager-Plugin, ist aber durch die Baumdarstellung auch bei umfangreichen Homepages übersichtlicher. Darüber hinaus können beim Pagemanager_XH ganze Menüstrukturen auf einmal verschoben werden.

Bitte lesen Sie diese Dokumentation! Andernfalls wird möglicherweise kein Support gewährt. Es ist grundsätzlich eine gute Idee, die Dokumentation zu lesen, bevor Sie auf Probleme stoßen!

## Voraussetzungen

Pagemanager_XH ist ein Plugin für CMSimple_XH. Es kann nur unter einer UTF-8 kodierten Version genutzt werden, also ab CMSimple_XH 1.2. Zusätzlich benötigen sie noch das jQuery4CMSimple-Plugin. Dieses wird in allen CMSimple_XH-Versionen ab 1.4.1 bereits vorinstalliert sein. Haben Sie eine ältere Version, ist es am besten jQuery4CMSimple herunter zu laden und zu installieren, bevor Sie fortfahren.

zum Seitenanfang

## Installation

Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH Wiki finden sie ausführliche Hinweise.

1. Sichern Sie die Daten auf Ihrem Server.
2. Entpacken Sie die ZIP-Datei auf Ihrem Computer.
3. Laden Sie das gesamte Verzeichnis auf Ihren Server in das CMSimple_XH plugins Verzeichnis hoch.
4. Vergeben Sie falls nötig Schreibrechte für die Unterverzeichnisse css, config und languages.

zum Seitenanfang

## Einstellungen

Die Konfiguration des Plugins erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch im Administrationsbereich der Homepage. Wählen Sie unter Plugins Pagemanager_XH aus.

Sie können die Original-Einstellungen von Pagemanager_XH in der Plugin-Konfiguration ändern. Beim Überfahren der Hilfe-Icons mit der Maus werden Hinweise zu den Einstellungen angezeigt.

Die Lokalisierung wird unter Plugin-Sprache vorgenommen. Sie können die Zeichenketten in Ihre eigene Sprache übersetzen, oder sie entsprechend Ihren Anforderungen anpassen.

Das Aussehen von Pagemanager_XH kann unter Plugin-Stylesheet angepasst werden. Besonders sollten Sie auf die auskommentierten Einstellung achten. Vielleicht versuchen sie einmal, diese zu aktivieren. Das aktuell ausgelieferte Stylesheet wurde für die Standard-Einstellung von drei Menü-Ebenen optimiert.

zum Seitenanfang

## Verwendung

Dieses Plugin ist ausschließlich für den Administrationsbereich von CMSimple_XH gedacht. Es wird dort über "Plugins wählen" > "Pagemanager" > "Seiten verwalten" aufgerufen. Nun sehen Sie die Struktur Ihrer Homepage in einer Darstellung, die prinzipiell Ihrem Inhaltsverzeichnis entspricht. Allerdings können Sie hier einzelne Seitenzweige öffnen und schließen, um auch bei umfangreichen Homepages nicht die Übersicht zu verlieren. Das Öffnen und Schließen erfolgt über die kleinen Markierungen links von der Seite, oder durch Doppel-Klicken auf den Titel.

Oberhalb der Baumansich der Seiten Ihrer Homepage befindet sich Pagemanager_XHs Werkzeugleiste. Wenn sie mit der Maus über die Schalter fahren, werden Popups eingeblendet, die die Funktion des Werkzeugs beschreiben. Die ersten beiden Schalter ganz links ermöglichen es, die Baumansicht Ihrer Homepage auf- bzw. einzuklappen. Die Werkzeugleiste ist besonders nützlich, wenn Ihr Browser verhindert, dass sich das Kontext-Menü öffnet.

Das Umorganisieren der Seitenstruktur erfolgt per Drag & Drop; beim Ziehen einer Seite werden entsprechende Markierungen eingeblendet, damit Sie sehen können, wo die Seite beim Ablegen eingeordnet wird. Sollte es nicht möglich sein auf eine bestimmte Seite zu ziehen, weil das z.B. in einer rekursiven Seitenstruktur resultieren würde, oder die Verschachtelungstiefe größer wäre als Ihre konfigurierten "menu levels", wird das durch ein rotes Kreuz angezeigt, oder es wird einfach nicht möglich sein, die Seite hier abzulegen, Also beachten sie genau die Markierungen, bis Sie ein Gefühl dafür bekommen, wie das Drag&Drop funktioniert. Wenn Sie beim Ziehen einer Seite STRG gedrückt halten, wird die Seite kopiert statt verschoben.

Beispiele von Drag & Drop Verschiebe-Operationen
während dessen | danach
--- | ---

Weitere Funktionen sind über die Werkzeugleiste und das Kontextmenü verfügbar (klicken Sie mit der rechten Maustaste auf eine Seite). Sie können neue Seiten erstellen, bestehende umbenennen und löschen, und es stehen Ihnen die üblichen Zwischenablagefunktionen zur Verfügung, die sie alternativ zu Drag & Drop verwenden können. Sollte eine Einfüge-Operation in einer rekursiven Seitenstruktur resultieren, z.B. wenn Sie eine Seite in sich selbst einfügen, wird sie stillschweigend ignoriert, um Sie nicht mit einer Warnung zu belästigen. Wenn sie die gewählte Seite löschen, werden alle ihre Unterseiten ebenfalls gelöscht.

Die Checkboxen links von den Seiten erlauben es Ihnen, deren Veröffentlichungsstatus anzusehen und zu ändern. Sie können einstellen, ob sie sich auf 'Veröffentlicht?' oder 'In der Navigation anzeigen' beziehen. Doppelte Überschriften werden wie im Navigations-Menü angezeigt. Wenn Sie mit der Maus darüber fahren, werden die tatsächlichen Seitentitel in einem Popup eingeblendet. Neu erstellte Seiten werden mit einem anderen Icon angezeigt, damit Sie sie besser von bereits bestehenden unterscheiden können.

Die Möglichkeit ganze Unterstrukturen zu kopieren mag auf den ersten Blick nicht einleuchtend sein, aber sie könnte nützlich werden, wenn Sie z.B. eine Galerie auf diesen Seiten anzeigen, denn der gesamte Inhalt und die Metadaten werden ebenso mit kopiert. Dann ist es möglich, einzelne Details nachträglich anzupassen.

Beachten Sie, dass es keine Rückgängig- oder Abbrechen-Funktion gibt. Sollten sie Ihre Seitenstruktur total durcheinander gebracht haben, aktualisieren sie einfach die Ansicht Ihres Browsers ohne vorher zu speichern. Ihre alte Seitenstruktur wird dann neu angezeigt.

zum Seitenanfang

## Beschränkungen

### Unregelmäßige Seitenstruktur

Es is möglich, dass Ihre bestehende Homepage eine unregelmäßige Seitenstruktur aufweist. Zum Beispiel können nach einem <h1> Titel direkt ein <h3> Titel folgen, ohne einen <h2> Titel dazwischen.

Sie können Ihre Seitenstruktur auf Unregelmäßigkeiten mit Pagemanager_XH prüfen. Im Falle von Unregelmäßigkeiten werden sie informiert, und Sie können nur fortfahren, wenn sie ausdrücklich zustimmen. Wenn Sie nicht fortfahren, wird kein Schaden entstehen.

Wenn Sie nicht verstehen, worum es hier geht: Befragen Sie Ihren Webmaster, oder holen Sie anderen Rat ein, bevor sie mit Pagemanager_XH fortfahren.

Unregelmäßigkeiten in der Seitenstruktur könnten sich versehentlich eingeschlichen haben, während Sie die Seitenstruktur manuell im Editor verändert haben (z.B. durch Änderung von Titel-Formatierungen, oder Löschen von Seiten).

Aber es ist denkbar, dass diese Möglichkeit von Ihrem System zu einem speziellen Zweck verwendet wird. Möglicherweise werden alle Seiten mit einem <h3> Titel automatisch versteckt! In diesem Fall können Sie Pagemanager_XH nicht verwenden, da es Ihre Seitenstruktur reorganisiert, um Unregelmäßigkeiten zu beheben. Sollten Sie dennoch Pagemanager_XH verwenden wollen, müssen Sie diese Seiten auf eine andere Weise verstecken (schauen sie in den Seite-Tab über dem Editor). Aber falls sie nicht genau wissen, ob Ihre unregelmäßige Seitenstruktur absichtlich so ist, befragen Sie Ihren Webmaster. Hilfestellung um Schaden zu beheben, der durch Umordnung der Seitenstruktur entstanden ist, wird im CMSimple Forum nicht gewährt werden!

Hat Ihre Homepage eine unregelmäßige Seitenstruktur, und Sie wollen es dabei belassen, können Sie Pagemanager_XH nicht verwenden. Sollten Sie es bereits installiert haben, deinstallieren Sie es am besten gleich wieder, und bearbeiten Sie die Struktur Ihrer Homepage wie bisher. Oder Sie sehen einmal nach Menumanager.

### jQuery

Pagemanager_XH könnte in Installationen mit jQuery abhängigen Plugins/Addons/Vorlagen, die jQuery4CMSimple nicht verwenden, sondern ihre eigene jQuery Bibliothek importieren, nicht funktionieren. Dieses Problem wird nicht behoben werden (es ist ohnehin nicht möglich, es für alle Fälle zu beheben), weil allen Entwicklern geraten wird, ausschließlich jQuery4CMSimple in Verbindung mit ihrem jQuery basierten Code für CMSimple_XH zu verwenden. Daher sollten diejenigen Erweiterungen aktualisiert werden, die sich nicht daran halten!

zum Seitenanfang

## Lizenz

Pagemanager_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2011-2012Christoph M. Becker

Slowakische Übersetzung © 2011 Dr. Martin Sereday
Tschechische Übersetzng © 2011 Josef Nemec
Dänische Übersetzung © 2011 Jens Maegaard
Französische Übersetzung © 2011 Patrick Varlet
Russische Übersetzung © 2012 Viktor Klim
Polnische Übersetzung © 2012 Kamil Krzes

zum Seitenanfang

## Danksagungen

Dieses Plugin beinhaltet jsTree. Vielen Dank an Ivan Bozhanov, den Entwickler dieser Bibliothek.

jsTree verwendet jQuery. Vielen Dank allen Entwicklern dieses großartigen Javascript Frameworks.

jQuery wird CMSimple_XH durch jQuery4CMSimple zur Verfügung gestellt. Vielen Dank an Holger Irmler, den Entwickler dieses Plugins.

Das Plugin-Icon wurde von Milan Jovanović entworfen. Vielen Dank für die frei Verwendbarkeit dieses Icons.

Dieses Plugin verwendet "free application icons" von Aha-Soft. Vielen Dank für die freie Verwendbarkeit dieser Icons.

Vielen Dank an die Gemeinschaft im CMSimple-Forum für Tipps, Anregungen und das Testen. Besonders möchte ich "snafu" danken, dessen frühe Rückmeldungen mich ermutigt haben, Pagemanager_XH weiter zu entwickeln. Vielen Dank an Ulrich der einen schweren Fehler (und mehrere kleinere Probleme) fand, und der bei der Behebung desselben half, indem er eine detailierte Beschreibung gab, was geschehen war. Und vielen Dank an Gert, der das nette Stylesheet, einige Fehlerkorrekturen und Übersetzungen und viele wertvolle Tipps zur Verfügung gestellt hat. Und ich möchte ebenfalls Martin danken, dessen Bericht über Probleme mit dem Kontextmenü das Hinzufügen der Werkzeugleiste inspiriert hat, sowie Tata, der die "scrollende" Toolbar inspiriert hat.

Und natürlich vielen Dank allen Entwicklern von CMSimple_XH, ohne die dieses fantastische CMS nicht existieren würde.

zum Seitenanfang