Google translator »

(Opens in a new window - öffnet in einem neuen Fenster)

Kurz-Dokumentation Plugin "Multimedia2"

Version Multimedia2 v2.0 - released 07/2014

MultiMedia2 ist ein CMSimple Plugin, mit dem Sie Audio- und Videodateien auf Ihren CMSimple Seiten abspielen können.

MultiMedia2 hat einen eigenen Mobile optimierten AudioPlayer, es können aber auch die browserinternen Player genutzt werden.

MultiMedia2 nutzt die html5-Tags <audio> und <video>. Von einigen älteren Browsern wird html5 nicht unterstützt, in diesem Fall erscheint ein entsprechender Hinweis. In der Konfiguration kann für diesen Fall ein Link auf die Datei aktiviert werden. Achtung! Die Aktivierung dieser Option kann zum direkten Download der Datei führen.

!!! Bitte beachten Sie Urheberrechte und CopyRights der Audio- und Videodateien !!!

1. Systemvoraussetzungen

Voraussetzung ist eine funktionierende Installation von CMSimple 4.2 oder höher.

Empfohlen wird die aktuelle Version von CMSimple »

2. Installation

  1. zip-Datei herunterladen und mit einem geeigneten Programm entpacken
    • Laden Sie die komplette Ordner-Struktur des Verzeichnisses "CMSimpleRoot" (die Verzeichnisse "plugins" und "usefiles") in das Installationsverzeichnis von CMSimple hoch.
    • Ihr ftp Programm wird merken, dass es diese Verzeichnisse bereits gibt, und Sie fragen, ob Sie das wirklich tun wollen. Beantworten Sie diese Frage einfach mit "ja", "ok" oder was immer Ihr ftp Programm anbietet.
    • Bei einem Update laden Sie einfach das Verzeichnis "userfiles" nicht mit hoch.
  3. Vergeben Sie mit Ihrem ftp-Programm die erforderlichen Lese- und Schreibrechte für Ordner und Dateien.

Vor einem Update erstellen Sie unbedingt eine Sicherheitskopie des alten Plugins, damit Sie eventuelle Änderungen/Ergänzungen an der stylesheet.css, der Konfiguration und den Sprachdateien wieder herstellen können.

3. Datei- und Ordnerrechte

Damit das Programm funktioniert und arbeiten kann (bzw. administrierbar ist), müssen für bestimmte Dateien und Ordner bestimmte Schreib- und Leserechte vergeben werden.

Dateien: chmod 666

Ordner: chmod 777

Damit der Datei Upload per CMSimple Filebrowser funktioniert, müssen die Dateitypen ogg, mp3, mp4, webm und ogv
in der CMS Konfiguration unter Einstellungen => CMS => Filebrowser => Extensions_userfiles eingetragen sein / werden.

4. Die Plugin Aufrufe

Damit die Player in fast allen Browsern funktionieren, müssen die Audio- und Videodateien mit dem gleichen Namen in verschiedenen Formaten vorliegen:

Hier ein Link zu einem Online Konvertierungsprogramm: online-convert.com

4.1 MultiMedia2 AudioPlayer

{{{PLUGIN:mm2audio('Dateiname', 'Dateiinfo', 'Breite', 'Klasse');}}}

4.2 Browserinterne AudioPlayer

Standard:

{{{PLUGIN:mm2audioBP('Dateiname', 'Breite', 'Klasse');}}}

Flexibel (für Fortgeschrittene):

{{{PLUGIN:mm2audioFlex('Dateiname', 'Eigenschaften');}}}

Beispiel Hintergrundmusik (Audioplayer unsichtbar):

{{{PLUGIN:mm2audioFlex('Dateiname', 'autoplay loop');}}}

Beispiel mit style und class (Audioplayer sichtbar):

{{{PLUGIN:mm2audioFlex('Dateiname', 'controls style="width: 600px;" class="my_class"');}}}

4.3 Browserinterne VideoPlayer

{{{PLUGIN:mm2video('Dateiname', 'Breite', 'Klasse', 'autoplay', 'loop');}}}

Beispiele:

Video mit 360px Breite, ohne autoplay, aber mit Loop:

{{{PLUGIN:mm2video('Dateiname', '360px', 'mm2videoDefault', '', 'loop');}}}

Der einfachste Plugin Aufruf ist der mit den Standard Einstellungen: 100% Breite, Standard Design, kein autoplay, kein loop:

{{{PLUGIN:mm2video('Dateiname');}}}

Oder Standard Einstellungen, aber mit definierter Breite:

{{{PLUGIN:mm2video('Dateiname', '360px');}}}

Wenn Sie ein Bild "dateiname.jpg" (Dateiname der 3 Videos in den 3 Formaten) im Video Verzeichnis ablegen, wird dieses Bild vom VideoPlayer automatisch als Vorschaubild verwendet. Dieses Bild sollte das gleiche Seitenverhältnis wie das Video haben und mindestens so gross sein wie das Video (Breite und Höhe).

5. Player Design

Ist der AudioPlayer schmaler als 280px, wird ein minimierter Audioplayer angezeigt.

Die Player können mit CSS (stylesheet.css des Plugins) gestaltet werden.

5.1 Global (alle Player)

In der stylesheet.css gibt es 3 Klassen, eine für den MultiMedia2 AudioPlayer, eine für die browserinternen AudioPlayer (... BP) und eine für den VideoPlayer. Mit diesen Klassen können Sie das Aussehen der Player global gestalten:

div.mm2audioDefault { ... }
div.mm2audioDefaultBP { ... }
div.mm2videoDefault { ... }

5.2 Player Klassen

Definieren Sie am Ende der stylesheet.css Klassen und tragen Sie diese in die Plugin Aufrufe ein. Im Kollisionen mit anderen stylesheets zu vermeiden, sollten diese Klassen mit mm2audio, mm2audioBP oder mm2video beginnen.

6. Hinweise / Datensicherheit

Bei einem Update erstellen Sie unbedingt eine Sicherheitskopie des alten Plugins, damit Sie eventuelle Änderungen/Ergänzungen an der stylesheet.css, der Konfiguration und den Sprachdateien wieder herstellen können.

Von einigen älteren Browsern wird html5 nicht unterstützt, in diesem Fall erscheint ein entsprechender Hinweis. In der Konfiguration kann für diesen Fall ein Link auf die mp3 (audio) bzw. mp4 (video) Datei aktiviert werden. Was dann mit dieser Datei geschieht, hängt von den Browsereinstellungen des Besuchers ab.

Achtung! Die Aktivierung dieser Option kann zum direkten Download der Datei führen.