BottleBot LightBox
BottleBot LightBox ist ein Plugin für das Joomla Content-Management-System in den Versionen 1.5x, 1.6x und 1.7x mit dessen Hilfe eine "LightBox" eingebunden werden kann.

Dieses Plugin richtet sich an Joomla-Nutzer, die eigene, selbstgemachte, Thumbail(Vorschau)-Bilder verwenden wollen. Der Vorteil der BottleBot LightBox gegenüber anderen PlugIns liegt darin, dass man bereits im Backend-Editor, z.B. TinyMCE, erahnen kann, wie die endgültige Seite im Frontend aussehen wird.
HINWEIS: ab Version 1.0 werden Galerien nicht mehr mit "[MeineGalerie]" gebildet. Der neue Code lautet "[bbgal=MeineGalerie]".
Inhalt:
Installation
Anleitung Bilder
Anleitung Videos (ab Version 1.0)
HD Videos (ab Version 1.3)
Editoren
Lizenzhinweise
Installation
1.
Datei "bottlebotlightbox_X.X_erst_entpacken.zip" entpacken.
2.
Datei "plg_content_bottleBotLightbox_X.X.zip" über "Erweiterungen->Installieren/Deinstallieren" hochladen/installieren.
3.
BottleBot Lightbox aktivieren ("Erweiterungen->Plugins")
4.
BottleBot LightBox-Parameter
Wenn nötig können in den BottleBot Plugin-Parametern individuelle Einstellungen vorgenommen werden. Dies ist unter "Erweiterungen->Plugins" mit einem Klick auf "BottleBot LightBox" möglich.
Anleitung Bilder
1.
BottleBot LightBox-Upload Man nehme zwei Bilder, das Hauptbild (beispiel.jpg) und das dazugehörige Thumbnail (tmb_beispiel.jpg) und lade sie in einen gemeinsamen Ordner hoch.
2.
BottleBot LightBox-Bild einfuegen Mit Hilfe des Bilder-Buttons im TinyMCE wird NUR das Thumbnail-Bild (tmb_beispiel.jpg) eingefügt.
Wenn gewünscht, können Titel und Beschreibung eingegeben werden.
3.
BottleBot LightBox-Bilder gruppieren 1 BottleBot LightBox-Bilder gruppieren 2 Um Bilder einer Galerie (Bildfolge) hinzuzufügen, vor der Bildbeschreibung einen Galerienamen im Format [bbgal=MeineGalerie] angeben.

Ein kleiner Hinweis an die User des TinyMCE ab Version 3:
In den Plugin-Parametern des TinyMCE sollte die "Komplett"-Funktionalität ausgewählt sein.
Überprüft, ob in den erweiterten Parametern der "Erweiterte Bildmanager" aktiviert ist.
Nur wenn dieser an ist, kann man Titel und Bildbeschreibung der BottleBot Lightbox nutzen.
Benutzung anderer Editoren:
Grundsätzlich ist das Plugin für den TinyMCE optimiert. Es sollte aber auch problemlos mit anderen Editoren funktionieren. Im JCE, z.B., heißt das Feld für die Bildbeschreibung "Alternate Text".
Für die HTML-Coder unter Euch: Alle Optionen und Parameter der BottleBot LightBox werden in den "alt"-Tag des Thumbnail-Images geschrieben.
Anleitung Videos (ab Version 1.0)
Endlich ist es so weit: BottleBot LightBox unterstützt jetzt auch Videos (nur Shadowbox und FancyBox).
Dieses umfangreiche Update hat mich eine Menge Gehirnschmalz und Zeit gekostet, weshalb hier noch einmal dezent auf die Möglichkeit einer kleinen Spende hingewiesen wird.
Es werden folgende Dateitypen unterstützt: YouTube, swf, flv, sowie H.264-kodierte
Dateien ( .mp4, .m4v, .mov ).
Zunächst wird genau wie bei den Bildern ein Thumbnail in den Editor geladen
(Präfix, z.B. tmb_, nicht vergessen).

Jetzt gibt es mehrere Möglichkeiten für verschiedene Szenarien:
1.
Lokal auf dem Server gespeicherte Video-Datei im Verzeichnis des Thumbnail-Bildes:

Dies ist auch die einfachste Variante.

Vor die Bildbeschreibung folgendes eingeben:

[bbvid=auto]

Nehmen wir an, das Thumbnail-Bild hieße "tmb_beispielvid.jpg", dann sucht das Plugin automatisch nach der Video-Datei namens "beispielvid." + "eine der von BottleBot LightBox unterstützten Video-Dateiendung".
2.
Lokal auf dem Server gespeicherte Video-Datei nicht im Verzeichnis des Thumbnail-Bildes:

Im Gegensatz zu den reinen Bild-Lightboxes ist es bei Videos auch möglich einen individuellen Pfad zum gewünschten Video anzugeben.

Vor die Bildbeschreibung folgendes eingeben:

[bbvid=dies/ist/ein/beispiel/verzeichnis/zur/videodatei.swf]
3.
YouTube-Urls:

Vor die Bildbeschreibung folgendes eingeben:

[bbvid=http://www.youtube.com/watch?v=XXXXXXXXX]

Oft sind die YouTube-Urls mit zusätzlichen Parametern versehen, die vom Plugin jedoch nicht beachtet werden. Um unvorhersagbare Probleme zu vermeiden, empfiehlt es sich die Urls nur bis zum ersten "&"-Zeichen zu kopieren (ohne das "&"-Zeichen).
Um die Größe der Videos (Breite und Höhe) zu beeinflussen, gibt es in den BottleBot LightBox-Parametern die Möglichkeit diese global für alle Filmchen zu setzen (Video-Rescale).

Wer Breite und Höhe für jedes Videos separat einstellen möchte, kann das mit den Parametern "bbw" und "bbh" in der Bildbeschreibung tun. Hier einige Beispiele dazu:

[bbvid=dies/ist/ein/beispiel/verzeichnis/zur/videodatei.m4v,bbw=640,bbh=480]
[bbvid=auto,bbw=352,bbh=288]
[bbvid=http://www.youtube.com/watch?v=XXXXXXXXX,bbw=487,bbh=345]


Und jetzt kommt's:

Galerien sind auch mit Videos möglich. Dies funktioniert genauso wie bei den Bildern:

[bbgal=MeineGalerie][bbvid=auto,bbw=352,bbh=288]optionale Beschreibung


HD Funktionalität für Videos ist seit der Version 1.3 möglich. Hierzu einfach ein zusätzliches HD-Video mit der Kennung "_HD" im Dateinamen hochladen. Insgesamt müssen dann 3 Dateien in einem Ordner liegen.

Beispiel:

tmb_video.jpg
video.mp4
video_HD.mov.

Das HD-Plugin muss in den Video-Parametern aktiviert werden.
Im Player taucht (bei vorhandenem HD-Video) dann ein kleiner Button mit der Aufschrift "HD" in der Kontrollleiste auf. Wer hätte das gedacht :)
Lizenzen:
Das "BottleBot LightBox Plugin" unteliegt der GNU/GPL-Lizenz und darf privat und komerziell genutzt werden.
Die eingebunden, nicht von mir programmierten Lightboxen, unterliegen anderen Lizenzrechten.
Einige dürfen sowohl privat als auch kommerziell genutzt werden, andere nur privat.
Bitte hierzu die dem Download beigefügten Lizenzhinweise der Lightboxen lesen (und somit akzeptieren).

BottleBot Lightbox:
http://www.gnu.org/licenses/gpl.html

FancyZoom 1.1 (seit BottleBot Lightbox 0.8 nicht mehr im Plugin enthalten):
http://www.fancyzoom.com

Shadowbox:
http://www.shadowbox-js.com/#license

Litebox 1.0 (seit BottleBot Lightbox 0.9 nicht mehr im Plugin enthalten):
http://creativecommons.org/licenses/by/2.5/

Slimbox 2.04:
http://www.digitalia.be

FancyBox 1.3.1
http://fancybox.net

Spenden:

Da ich, wie viele andere auch, ein armer Student bin, der Studiengebühren abdrücken muss, bitte ich um eine kleine Spende. Jeder Cent hilft mir ins nächste Semester zu kommen.

Also vielen Dank schonmal und viel Spaß beim Joomeln.

--
BottleBot



Download | ChangeLog | Hilfe/Forum | Links | Disclaimer | Impressum