Onepage_XH – ein CMSimple_XH Plugin

Yin und Yang

Onepage_XH bietet Werkzeuge um so genannte "Onepage" Websites zu erstellen und zu Administrieren. Im Backend können Sie die Site wie gewohnt administrieren, aber im Frontend wird ein besonderes Template verwendet, das alle sichtbaren Seiten auf einmal zeigt, und das Menü verlinkt zu automatisch eingefügten Ankern auf der selben Seite.

Bitte lesen Sie diese Dokumentation bevor Sie auf Probleme stoßen!

Wichtiger Hinweis

Onepage_XH konnte noch nicht in verschiedenen Umgebungen getestet werden. Es ist eine so genannte Beta-Version. Vorsicht bei der Verwendung!

Requirements

Onepage_XH ist ein Plugin für CMSimple_XH. Es benötigt CMSimple_XH ≥ 1.6.3 und PHP ≥ 5.2.0.

Installation

Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH-Wiki finden Sie weitere Details.

  1. Sichern Sie die Daten auf Ihrem Server.
  2. Entpacken Sie die ZIP-Datei auf Ihrem Rechner.
  3. Laden Sie das ganze Verzeichnis onepage/ auf Ihren Server in CMSimple_XHs Plugin-Verzeichnis hoch.
  4. Machen Sie die Unterverzeichnisse config/, css/ und languages/ beschreibbar.

Einstellungen

Die Plugin-Konfiguration erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch im Administrationsbereich der Website. Wählen Sie Plugins → Onepage.

Sie können die Voreinstellungen von Onepage_XH unter "Konfiguration" ändern. Hinweise zu den Optionen werden beim Überfahren der Hilfe-Icons mit der Maus angezeigt.

Die Lokalisierung wird unter "Sprache" vorgenommen. Sie können die Sprachtexte in Ihre eigene Sprache übersetzen, falls keine entsprechende Sprachdatei zur Verfügung steht, oder diese Ihren Wünschen gemäß anpassen.

Das Aussehen von Onepage_XH kann unter "Stylesheet" angepasst werden.

Verwendung

Template

"Onepage" Websites benötigen ein besonderes Template, bei dem einige der normalen CMSimple_XH Template-Tags durch Alternativen ersetzt sind, die Onepage_XH zur Verfügung stellt.

onepage_toc()

Dies ist ein erforderlicher Ersatz für toc(), der Links zu allen sichtbaren Seiten anzeigt.

onepage_content()

Dies ist ein erforderlicher Ersatz für content(), der alle sichtbaren Seiten auf der Startseite der CMSimple_XH Installation anzeigt.

onepage_toplink()

Dies ist ein optionaler Ersatz für top(), der konfigurierbares sanftes Scrollen anbietet, und nur angezeigt wird, wenn der Anwender bereits etwas nach unten gescrollt hat. Ohne JavaScript-Unterstützung wird der Link immer angezeigt, und statt des sanften Scrollens wird gesprungen. Das Bild des Links kann geändert werden, indem Sie eine Bilddatei mit dem Namen up.png im images/ Ordner des Templates ablegen.

Dieses Template-Tag akzeptiert einen optionalen Parameter, die ID eines Elements. Auf diese Weise können Sie den Anfang der Seite individuell definieren. Wenn Sie der Funktion kein Argument übergeben, verweist der Link ganz oben auf die Seite.

Nicht unterstützte Template-Tags

Mehrere Template-Tags werden für "Onepage" Templates nicht unterstützt: content(), li(), locator(), mailformlink(), nextpage(), previouspage(), printlink() searchbox(), sitemaplink(), submenu(), toc().

Einschränkungen

Nicht alle Browser behandeln Anker mit Sonderzeichen korrekt, so dass Sie urichar_org/new zum Bereinigen Ihrer URLs nutzen sollten.

Vermutlich werden nicht alle Plugins reibungslos unter "Onepage" Websites funktionieren. Z.B. können Sie mit page_params keine seitenspezischen Templates wählen.

Lizenz

Onepage_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2015 Christoph M. Becker

Danksagung

Onepage_XH wurde von Ludwig und oldnema angeregt.

Das Plugin Logo wurde von Klem gestaltet. Vielen Dank für die Freigabe dieses Icons in die Gemeinfreiheit.

Das "nach oben scrollen" Icon wurde vom Oxygen Team gestaltet. Vielen Dank für die Veröffentlichung unter GPL.

Vielen Dank an die Community im CMSimple_XH forum für Hinweise, Anregungen und das Testen. Besonderer Dank gebührt smaxle und knollsen für frühes Testen und gute Vorschläge.

Und zu guter letzt vielen Dank an Peter Harteg, den "Vater" von CMSimple, und allen Entwicklern von CMSimple_XH ohne die es dieses phantastische CMS nicht gäbe.