﻿Slideshow Modul 0.8 für Contenido 4.8.x

####################################################################################################
TOC (Table of contents)

- BESCHREIBUNG
- INSTALLATION
- CHANGELOG
- SLIDESHOW MODUL THEMEN IM CONTENIDO FORUM
- SCHLUSSBEMERKUNG


####################################################################################################
BESCHREIBUNG

JavaScript Slideshow Modul für Contenido 4.8.*.
Verwendet die JavaScript Libraries Prototype und script.aculo.us für die Darstellung mehrerer Bilder, 
die mit einem Überblendeffekt ausgetauscht werden.
Basiert auf die Slideshow von Remco van ‘t Veer, siehe http://blog.remvee.net/post/17.

Das Modul bietet diverse Einstellungsmöglichkeiten zur Steuerung der Slideshow. Unterstützt die 
Bildformate jpg, jpeg, png, und gif. Die Skalierung der Bilder ist von der installierten GD-Library 
oder ImageMagick abhängig. Die Ausgabe der Slideshow ist valides XHTML-Strict.

Konfigurationsmöglichkeiten des Moduls:
* Auswahl des Bilderordners innerhalb des upload-Verzeichnisses
* Angabe der Slideshowgeschwindigkeit für die Slideshow
* Horizontale Zentrierung der Bilder. Diese Option kann z. B. gewählt werden, wenn Bilder 
  verschiedene Größen haben, und die Slideshow mittig dargestellt soll. Die vertikale Zentrierung 
  ist über die CSS Datei möglich.
* Angabe für maximale Breite/Höhe der Bilder mit Dauer des Bildercaches

Die Slideshow ist nicht dafür gedacht, mehrfach innerhalb einer Seite eingesetzt zu werden.


####################################################################################################
INSTALLATION

Die im Modukpackage enthaltenen Dateien/Sourcen sind wie im Folgenden beschrieben zu installieren.
Die Pfade zu den Sourcen (CSS, JS und Templates) können von Projekt zu Projekt unterschiedlich sein undsind bei Bedarf anzupassen.


/cms/css/slideshow.css:
-----------------------
Formatdefinition für die Slideshow. Entweder die Datei im Header-Bereich des Layouts einbinden
[code]
    <link rel="stylesheet" href="/cms/css/slideshow.css" type="text/css" media="screen, projection" />
[/code]
oder den Inhalt in die eigene CSS-Datei kopieren und die Formatierung den eigenen Wünschen anpassen.


/cms/includes/class.uploadmeta.php:
-----------------------------------
GenericDB Klassen für Zugriff auf die Upload-Meta Tabelle.


/cms/js/scriptaculous/*:
------------------------
Enthält die Sourcen des script.aculo.us JavaScript Frameworks (v 1.8.1). 
Im Header Bereich des Layouts sind 2 JavaScript-Dateien aius dem script.aculo.us Paket einzubinden.
Beispiel:
[code]
    <script src="/cms/js/scriptaculous/lib/prototype.js" type="text/javascript"></script>
    <script src="/cms/js/scriptaculous/src/effects.js" type="text/javascript"></script>
[/code]


/cms/js/protoaculous.js:
------------------------
Alternative komprimierte JS-Datei bestehend aus Prototype 1.6.0.2 und Scriptaculous 1.8.1.
Originalbezeichnung der Datei ist protoaculous.1.8.1.min.js, die Quelle ist:
http://groups.google.com/group/prototype-core/files

Die Datei kann anstatt der Scripte aus "/cms/js/scriptaculous/" im Head-Bereich des Layouts 
eingebunden werden.
[code]
    <script src="/cms/js/protoaculous.js" type="text/javascript"></script>
[/code]
Der Vorteil dabei ist, Prototype und Scriptaculous komplett darin in komprimierter Form enthalten 
ist, d. h. einmal im Header eingebunden, steht die volle Funktionalität beider Libraries auch für 
andere Module/Verwendungszwecke zur Vefügung.


/cms/js/slideshow.js:
---------------------
Die eigentliche JavaScript Datei für die Slideshow.
Hinweis: Wenn die Datei in ein anderes Verzeichnis angelegt werden sollte, ist die Referenz auf die 
Datei in der slideshow.html anzupassen.


/cms/templates/slideshow.html:
-----------------------------
Das Template für die Ausgabe.


/Slideshow.xml:
---------------
XML-Export des Slideshow Moduls. Ist über das Contenido-Backend als Modul zu importieren.


/slideshow_deutsch.xml:
-----------------------
XML-Export der deutschen Modulübersetzung. Ist über das Contenido-Backend als Modulübersetzung 
zu importieren.


####################################################################################################
CHANGELOG

2008-11-16 Slideshow Modul 0.9
    * bugfix: Slideshowfolder is selectable only of actual client

2008-09-28 Slideshow Modul 0.8
    * change: Update auf scriptaculous-js-1.8.1
    * change: Angepasst auf Contenio 4.8.x
    * change: Auslesen der Beschreibung aus der Upload-Meta Tabelle
    * new: Neue Option zum Festlegen der Reihenfolge der Ausgabe

2006-12-20 Slideshow Modul 0.6
    * new: Behandlung von Bildern mit verschiedenen Größen
    * new: Horizontale Zentrierung der Bilder
    * new: Maximale Breite und Höhe für Bilder der Slideshow inklusive der Zeit für das Cachen von 
      skalierten Bildern

2006-12-17 Slideshow Modul 0.4
    * Erste Veröffentlichung des Slideshow Moduls.


####################################################################################################
SLIDESHOW MODUL THEMEN IM CONTENIDO FORUM

SlideShow Modul 0.8 für Contenido 4.8.x:
http://forum.contenido.org/viewtopic.php?t=22583

SlideShow Modul 0.4/0.6 für Contenido 4.6.x:
http://forum.contenido.org/viewtopic.php?t=14923


####################################################################################################
SCHLUSSBEMERKUNG

Benutzung des Moduls auf eigene Gefahr!

Murat Purc, murat@purc.de
