Hoverbox_XH - ein CMSimple_XH (ab Version 1.7) Plugin

Bauklötze

Hoverbox_XH ermöglicht die Präsentation von Bildern auf einer CMSimple_XH-Website. Auf diese Weise können sie Bilder - Hover Texte und Links einfügen, und diese auf mehreren Seiten wiederverwenden.






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

Voraussetzungen

Hoverbox_XH ist ein Plugin für CMSimple_XH. Es benötigt eine UTF-8 kodierte Version.

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 hoverbox/ auf Ihren Server in CMSimple_XHs Plugin-Verzeichnis hoch.
  4. Machen Sie die Unterverzeichnisse config/, css/, languages/ und den Datenordner des Plugins beschreibbar.
  5. Gehen Sie zu Plugins → Hoverbox im Administrationsbereich, um zu prüfen, ob alle Voraussetzungen erfüllt sind.

Beachten Sie, dass die Datendateien von Hoverbox_XH durch direkten Aufruf ihrer URL eingesehen werden können. Eine .htaccess Datei um das zu verhindern befindet sich bereits im voreingestellten Datenordner. Für andere Server oder für angepasste Datenordner müssen Sie selbst darauf achten, dass diese Daten vor nicht autorisiertem Zugriff geschützt sind.

Einstellungen

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

Sie können die Voreinstellungen von Hoverbox_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 Hoverbox_XH kann unter "Stylesheet" angepasst werden.

Verwendung

Sie können Ihre Textblöcke im Administrationsbereich verwalten; gehen Sie zu Plugins → Hoverbox → Text-Blöcke. Die Verwendung sollte weitgehend selbsterklärend sein, aber ein paar Hinweise erscheinen angebracht:

  • Die Namen der Textblöcke können beliebig gewählt werden, aber sie dürfen nur Kleinbuchstaben (a-z), Ziffern (0-9), Unter- und Bindestriche enthalten
  • Die Eingabefelder rechts enthalten den benötigten Pluginaufruf. Klicken Sie sie einfach an und kopieren Sie die Auswahl in die Zwischenablage, um sie später auf einer CMSimple_XH Seite einfügen zu können.
  • Von CMSimple_XH 1.5.2 an können die Textblöcke mit dem selben Editor bearbeitet werden, mit dem auch CMSimple_XH Seiten bearbeitet werden. In älteren Versionen ist nur eine Textarea verfügbar.
  • Von CMSimple_XH 1.5 an können Sie Pluginaufrufe in den Textblöcken verwenden, so dass Sie TextBlöcke verschachteln können oder nach Wunsch ein anderes Plugin aufrufen können.

Das Einfügen eines Textblocks auf einer Seite erfolgt mit dem folgenden Pluginaufruf:

{{{hoverbox('BLOCK-NAME');}}}

Ersetzen Sie BLOCK-NAME durch den Namen eines bereits definierten Textblocks. Die einfachste Möglichkeit ist es den Pluginaufruf aus der Administration von Hoverbox_XH per Copy&Paste zu übernehmen.

Außerdem können die Texblocks in Kategorien organisiert werden. Sie können die Kategorien erstellen und dann in den Kategorien neue Textblocks erstellen.

Das Einfügen eines Textblocks aus einer bestimmten Kategorie auf einer Seite erfolgt mit dem folgenden Pluginaufruf:

{{{hoverbox('BLOCK-NAME'.'KATEGORIE NAME');}}}

Lizenz

Hoverbox_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2017 Ingo Sell (knollsen)

Danksagung

Das Plugin wurde von Ingo Sell entworfen. Vielen Dank für die Veröffentlichung als Freeware.

Vielen Dank an Sascha Schroeter (SiNiTaSa) im CMSimple_XH-Forum für Tipps, viele Anregungen und das Testen.