Slideshow_XH – ein CMSimple_XH Plugin

Plugin
Icon

Slideshow_XH ermöglicht die Anzeige aller Bilder in einem angegeben Ordner als Diashow. Diese Diashows erlauben keinerlei Interaktion durch den Benutzer. Mehrere Diashows mit unterschiedlichen Effekten und Zeitabläufen sind möglich.

Bitte lesen Sie diese Dokumentation bevor Probleme auftreten!

Wichtiger Hinweis

Slideshow_XH konnte bisher nicht in diversen Umgebungen getestet werden. Es ist eine so genannte BETA-Version. Vorsicht bei der Verwendung!

Voraussetzungen

Slideshow_XH ist ein Plugin für CMSimple_XH ≥ 1.6. Es benötigt 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 slideshow/ auf Ihren Server in CMSimple_XHs Plugin-Verzeichnis hoch.
  4. Machen Sie die Unterverzeichnisse config/ und languages/ beschreibbar.
  5. Gehen Sie zu "Slideshow" im Administrationsbereich, um zu prüfen, ob alle Voraussetzungen erfüllt sind.

Einstellungen

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

Sie können die Voreinstellungen von Slideshow_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.

Verwendung

Um eine Diashow auf allen Seiten anzuzeigen, fügen sie ins Template ein:

<?php echo slideshow('%ORDNER%', '%OPTIONEN%');?>

Um eine Diashow auf einer einzelnen Seite oder in einer Newsbox anzuzeigen, geben auf der Seite ein:

{{{PLUGIN:slideshow('%ORDNER%', '%OPTIONEN%');}}}

Die Parameter haben die folgende Bedeutung:

%ORDNER%
Der Pfad eines Ordners relativ zu CMSimple_XHs Bilderordner. Alle JPEG, PNG und GIF Bilder in diesem Ordner werden für die Diashow verwendet; es müssen sich mindestens zwei Bilder in diesem Ordner befinden. Alle Bilder sollten das gleiche Seitenverhältnis aufweisen.
%OPTIONEN%
Jede angegebene Option überschreibt die entsprechende Voreinstellung im "default" Abschnitt der Pluginkonfiguration. Das Format dieses Parameters ist das gleiche wie bei einem "Query-String" (siehe die Beispiele weiter unten). Die Optionen können in beliebiger Reihenfolge angegeben werden. Wenn Sie bei den Voreinstellungen bleiben wollen, können Sie diesen Parameter auslassen. Die folgenden Optionen können angegeben werden:
order
Die Reihenfolge der Bilder: "fixed" (alphabetisch sortiert; beginnt mit dem ersten Bild), "sorted" (alphabetisch sortiert; beginnt mit einem zufällig gewählten Bild) oder "random" (zufällig geordnet).
effect
Die Art des Übergangs: "fade", "slide", "curtain" oder "random".
easing
Der Beschleunigungseffekt: "linear", "easeIn", "easeOut" oder "easeInOut".
delay
Die Verzögerung in ms bis zum ersten Start der Diashow.
pause
Die Dauer der Pause zwischen den Übergängen in ms.
duration
Die Dauer des Übergangseffekts in ms.

Beispiele

Zum Anzeigen der Bilder in userfiles/images/banner/ mit den Voreinstellungen auf jeder Seite:

<?php echo slideshow('banner');?>

Zum Anzeigen der Bilder in der Art eines Fließbands:

{{{slideshow('slides/fliessband/', 'effect=slide&pause=0&duration=2000');}}}

Zum Anzeigen der Bilder als ruhige, langsam überblendende Diashow:

{{{slideshow('slides/ruhig/', 'effect=fade&pause=5000&duration=100');}}}

Zum Anzeigen geigneter Bilder als Daumenkino:

{{{slideshow('slides/daumenkino/', 'order=fixed&effect=fade&pause=100&duration=100');}}}

Einschränkungen

Die Diashows werden nur abgespielt, wenn JS im Browser des Besuchers aktiviert ist. Ansonsten wird nur das erste Bild angezeigt. Die Übergangseffekte sind rechenintensiv, besonders für große Bilder. Daher sollten Sie sich auf nur wenige Diashows mit kleinen oder mittelgroßen Bildern auf der selben Seite beschränken, um Besuchern mit geringer Rechenleistung keine stotternden Diashows zu präsentieren.

Lizenz

Slideshow_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2012-2014 Christoph M. Becker

Dänische Übersetzung © 2012 Jens Maegard
Tschechische Übersetzung © 2012-2013 Josef Němec
Slovakische Übersetzung © 2013 Dr. Martin Sereday
Französische Übersetzung © 2014 Patrick Varlet

Danksagung

Slideshow_XH wurde von Joe angeregt.

Das Pluginicon wurde von Mischa McLachlan entworfen. Vielen Dank für die Veröffentlichung unter einer freien Lizenz.

Dieses Plugin verwendet freie Anwendungs-Icons von Aha-Soft. Vielen Dank für die freie Verwendbarkeit dieser Icons.

Many thanks to the community at the CMSimple_XH-Forum for tips, suggestions and testing.

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.