Contenido-Repo

Beschreibung

JavaScript Slideshow Modul für Contenido 4.8.x. Verwendet die JavaScript Frameworks 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.

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.

Installation

Die im Modulpackage 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 und sind bei Bedarf anzupassen.

Bei der Installationsbeschreibung wird davon ausgegangen, dass Contenido in das DocumentRoot-Verzeichnis eines Webservers installiert wurde und das Mandantenverzeichnis "cms/" ist.

/cms/css/slideshow.css:
Formatdefinition für die Slideshow. Entweder (a) die Datei im head-Bereich des Layouts einbinden

<link rel="stylesheet" href="/cms/css/slideshow.css" type="text/css" media="screen, projection" />

oder (b) 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, ist in das Verzeichnis "cms/includes/" zu kopieren.

/cms/js/scriptaculous/*:
Enthält die Sourcen des script.aculo.us JavaScript Frameworks (v 1.8.2). Im head-Bereich des Layouts sind 2 JavaScript-Dateien aus dem script.aculo.us Paket einzubinden. Beispiel:

<script src="/cms/js/scriptaculous/lib/prototype.js" type="text/javascript"></script>
<script src="/cms/js/scriptaculous/src/effects.js" type="text/javascript"></script>

/cms/js/protoaculous.js:
Alternative komprimierte JS-Datei bestehend aus Prototype 1.6.0.2 und Scriptaculous 1.8.2. Originalbezeichnung der Datei ist protoaculous.1.8.2.min.js, aus Prototype: Core. Die Datei kann anstatt der Scripte aus "/cms/js/scriptaculous/" im head-Bereich des Layouts eingebunden werden.

<script src="/cms/js/protoaculous.js" type="text/javascript"></script>

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 Verfügung.

/cms/js/slideshow.js:
Die eigentliche JavaScript Datei für die Slideshow, ist im head-Bereich des Layouts einzubinden

<script src="/cms/js/slideshow.js" type="text/javascript"></script>

/cms/templates/slideshow.html:
Das Template für die Ausgabe, ist in das Verzeichnis "cms/templates/" zu kopieren.

/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.

Konfiguration

• Auswahl des Bilderordners innerhalb des upload-Verzeichnisses
• Optionen zur Reihenfolge der Ausgabe
• 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
• Mehrfache Verwendung innerhalb einer Seite

Changelog

Version 0.0.3

26-February-2009

• Security Fixes
  • Fixed security issue in imagerotate(), background colour isn't validated correctly with a non truecolour image. Reported by Hamid Ebadi, APA Laboratory (Fixes CVE-2008-5498). (Scott)
  • Fixed a crash on extract in zip when files or directories entry names contain a relative path. (Pierre)
  • Fixed explode() behavior with empty string to respect negative limit. (Shire)
  • Fixed a segfault when malformed string is passed to json_decode(). (Scott)
  • Fixed bug in xml_error_string() which resulted in messages being off by one. (Scott)
• Changed __call() to be invoked on private/protected method access, similar to properties and __get(). (Andrei)
• Added optional sorting type flag parameter to array_unique(). Default is SORT_REGULAR. (Andrei)
• Fixed zip filename property read. (Pierre)
• Fixed error conditions handling in stream_filter_append(). (Arnaud)
• Fixed bug #47422 (modulus operator returns incorrect results on 64 bit linux). (Matt)
• Fixed bug #47399 (mb_check_encoding() returns true for some illegal SJIS characters). (for-bugs at hnw dot jp, Moriyoshi)