Dokumentation
Eine jQuery Slideshow für moziloCMS
Das coinSlider Plugin generiert eine navigierbare Slideshow mit verschiedenen Effekten aus Bildern einer in moziloCMS vorhandenen Galerie.
Folgende Vorraussetzungen sind für das coinSlider Plugin notwendig:
- moziloCMS ab Version 2.0
- Aktiviertes Javascript im Browser
coinSlider-master.zip [~33 KB]
Das Plugin kann im moziloCMS Backend unter Plugins installiert werden. Dazu die gepackte Plugindatei auswählen (.zip-Datei mit exakt dem gleichen Namen wie das Plugin selbst) und mit Install bestätigen. Das jetzt aufgeführte coinSlider Plugin kann nun aktiviert und konfiguriert werden.
Zur manuellen Installation des Plugins, wird ein Serverzugang wie FTP oder SSH benötigt.
- Die .zip-Datei entpacken und den Ordner coinSlider in das Pluginverzeichnis:
<moziloroot>/plugins/
von Mozilo hochladen. - Ordner- und Dateirechte (chmod) auf 777 für Ordner und 666 für Dateien setzen.
- Im Backend unter Plugins das jetzt aufgeführte coinSlider Plugin aktivieren und die gewünschte Konfiguration setzen.
{coinSlider|<name>|<width>|<height>|<spw>|<sph>|<delay>|<sDelay>|<opacity>|<titleSpeed>|<effect>|<navigation>|<links>|<hoverPause>}
Gibt den coinSlider zurück.
- Parameter
<name>
: Der Name einer in mozilCMS existierenden Galerie. Wird ein falscher oder kein Name angegeben, gibt das Plugin eine Meldung aus. - Parameter
<width>
: Die Breite der Slideshow in Pixeln (z.B. 500). - Parameter
<height>
: Die Höhe der Slideshow in Pixeln (z.B. 200). - Parameter
<spw>
: Quadrate pro Breite (Anzahl von animierten Quadraten über die Breite des Sliders, z.B. 10) - Parameter
<sph>
: Quadrate pro Höhe (Anzahl von animierten Quadraten über die Höhe des Sliders, z.B. 4) - Parameter
<delay>
: Anzeigedauer eines Bildes (Zeit in Millisekunden, die ein Bild angezeigt wird, z.B. 3000) - Parameter
<sDelay>
: Anzeigedauer der Quadrate (Zeit in Millisekunden, die ein einzelnes Quadrat beim Bildwechsel angezeigt wird, z.B. 300) - Parameter
<opacity>
: Transparenz von Beschreibung und Navigation (Ein Wert zwischen 0.0 und 1.0 zur Beschreibung der Transparenz der Bilduntertitel und der Naviagionspfeile) - Parameter
<titleSpeed>
: Erscheinungsdauer der Beschreibung (Zeit in Millisekunden, die der Bilduntertitel braucht, um zu erscheinen, z.B. 500) - Parameter
<effect>
: Überblendeffekt - Legt den Effekt fest, mit dem zwischen Bildern gewechselt wird. Mögliche Werte sind:-
random
: Zufällige Reihenfolge der Quadrate beim Überblenden -
swirl
: Quadrate blenden in Schneckenform über -
rain
: Quadrate blenden in einer Diagonalen über -
straight
: Quadrate blenden zeilenweise über
-
- Parameter
<navigation>
: Navigation anzeigen (Legt fest ob die Navigationspfeile und -buttons anzeigen). Mögliche Werte sindtrue
oderfalse
. - Parameter
<links>
: Bilder als Verweis setzen (Legt fest, ob Bilder auf sich selbst verlinken oder nicht). Mögliche Werte sindtrue
oderfalse
. - Parameter
<hoverPause>
: Beim Maushover anhalten (Legt fest, ob der Slider bei Maushover anhält). Mögliche Werte sindtrue
oderfalse
.
Optimale Anzeige erreicht man, wenn die Größe des Sliders exakt mit der der in der Galerie befindlichen Bilder übereinstimmt!
Sind die Effekte mit mehreren Quadraten, welche nacheinander faden, nicht erwünscht, so kann bei Quadrate pro Breite und Quadrate pro Höhe einfach eine 1 notiert werden. Damit faden die kompletten Bilder direkt ineinander über. Evt. muss dann die Anzeigedauer der Quadrate angepasst werden.
Zu viele Quadrate können die Performance der Übergänge beeinträchtigen.
Folgende Administratoreinstellungen sind für dieses Plugin möglich:
- Vorheriges Bild: Hier kann das Label für den Rückwärtsnavigation gesetzt werden.
- Nächstes Bild: Hier kann das Label für den Vorwärtsnavigation gesetzt werden.
{coinSlider|@=coinslidertest=@|499|283|6|3|3000|30|0.7|500|rain|true|true|true}
Ausgabe:
Das Plugin steht unter der GNU General Public License (GPL) v3, oder frei nach Wahl jede folgende Version. Jegliche Hinweise auf Autor und Urheber müssen erhalten bleiben.
Das Plugin basiert auf dem Coin Slider: Image Slider with Unique Effects Projekt von Ivan Lazarevic. http://workshop.rs/2010/04/coin-slider-image-slider-with-unique-effects https://github.com/kopipejst/coin-slider
Bildquelle für Beispielbild:
http://www.n24.de/n24/Mediathek/Bilderserien/d/303040/futuristisches-auf-der-iaa.html?index=14
Frontend: Deutsch, Englisch
Backend: Deutsch, Englisch
Falls dir dieses Plugin gefällt — ich freue mich immer über eine kleine Unterstützung: