bas Lightbox

• Download v0.5
• Plugin Help
• Forum Thread
• Demo

Diese Plugin erweitert Textpattern um Lightbox JS 2.0 von Lokesh Dhakar.

Lightbox ist ein einfaches, barrierefreies Script, das zu Thumbnails die Originalbilder auf einer neuen Ebene über der eigentlichen Seite zeigt.

Da sich mit Textpattern Thumbnails auf für Laien sehr einfach erzeugen lassen, ist bas_Lightbox eine sehr einfache Methode, um Bildergalerien zu erstellen und zu pflegen.

Lightbox funktioniert mit Prototype von Sam Stephenson und script.aculo.us von Thomas Fuchs .

Um ein klein wenig Platz zu sparen, benutze ich eine von John-David Dalton kompremierte Version von Prototype.

Screencast

Installation

Wie jedes Textpattern Plugin installieren:

• Kopiere den Plugin Code
• Öffne Dein Textpattern
• Gehe zu Administration -> Plugins
• Füge den Plugin Code in die Textbox ein
• Klicke auf Hochladen
• Jetzt sollte*bas_lightbox* in der Plugin Liste auftauchen
• Aktiviere es

Erweitere Installation

bas_lightbox braucht einige Dateien und einige Einstellungen müssen in der Datenbank gespeichert werden.

Um die Installation so einfach wie möglich zu halten, enthält das Plugin ein Installationsskript, dass alle Dateien kopiert, einige Anpassungen imLightbox Javascript und in den Stylesheets macht und auch die Einstellungen in die Datenbank setzt.

Weil das Plugin ohne das alles nicht funktioniert, muss Du die erweiterte Installation unter Erweiterungen -> bas Lightbox durchführen.

Sollte der automatischen Import nicht funktionieren oder wenn Du nie nichts installierst, was Du nicht selber kontrolliert hast, dann kannst Du den Import auch überspringen und die Dateien aus bas_lightbox.zip manuell hochladen.
Benutze in dem Fall für die Bilder die Textpattern Bilder-Verwaltung und für die Dateien mit den TXP Dateimanager!

Nach dem Import der Dateien siehst Du die Plugin Einstellungen und kannst diese auch ändern.

Wenn Du ein Custom-Field für die Bilder-Kategorien benutzen willst, dann nenne ein Custom-Field Lightbox.
Die Namen für die Felder findest Du unter Administration -> Erweiterte Einstellungen.

Plugin Einstellungen

Nachdem Du die erweiterte Installation durchgeführt hast, kannst Du die Einstellungen für das Plugin speichern.
Die gespeicherten Einstellungen werden als Default-Werte benutzt, Du kannst diese überschreiben, indem Du im Plugin-Tag das jeweilig Attribut setzt.

Du kannst die Einstellungen natürlich auch später ändern, indem Du zur Erweiterung zurückkommst.

Deinstallieren

Bevor Du bas Lightbox über das Plugin Tab löschst, sollest Du das Deinstallationsskript durchführen, welches Du in der bas Lightbox Erweiterung findest. Dies löscht alle Plugin Einstellungen aus der Datenbank und alle Dateien.

Verwendung

Du kannst bas Lightbox entweder im Artikel oder in Seitenvorlagen bzw. Bausteinen verwenden.

Egal wo Du es verwenden willst, zunächst muss Du

in den head Deiner Seite ein, diese Tag fügt alle benötigten Scripte und Stylesheets ein.
Die Scripte sind ca. 124 kB groß, deshalb füge sie nur in Sektionen ein, in denen Du Lightbox auch benutzen willst.

Im Artikel oder in Artikelbausteinen

Füge <txp:bas_lightbox /> in einen Artikel (Body oder Excerpt) oder in den Artikelbaustein ein.

Die Bilder bestimmst Du entweder über das Attribut img

oder per cat

Oder Du benutzt nur <txp:bas_lightbox /> im Artikel oder Artikelbaustein und bestimmst die Bilder:

• Getrennt durch Kommas im Feld Artikelbild
• Nenne ein Custom-Field Lightbox. Dieses Feld wird durch eine Dropdown-Liste alle Bilder Kategorien ersetzt. Wähle eine Kategorie von dieser Liste.

In Seitenvorlagen oder Bausteinen

Du kannst <txp:bas_lightbox /> auch in Seitenvorlagen benutzen.
Füge es zum Beispiel in Deine Sidebar ein und zeige dort Deine Thumbnails da.

Logischerweise kannst Du die Bilder in Seitenvorlagen nicht so referenzieren, wie oben für die Verwendung in Artikeln beschrieben. Benutze stattdessen use_section oder use_cat:

Damit werden alle Thumbs aus der Bilder Kategorie gezeigt, die denselben Namen hat, wie die aktuelle Section. Zum Beispiel werden in der Section about alle Bilder aus der Bilder Kategorie about gezeigt. Achte auf Groß- und Kleinschreibung und auf Sonderzeichen, denn Sektionsname und Sektionstitel sind nicht zwangsläugig identisch.

Damit werden alle Thumbs gezeigt, die in der Bilder Kategorie sind, die so heißt, wie die aktuelle Artikel Kategorie.

Plugin Attribute

Du kannst das Plugin über verschiedene Attribute anpassen. Die Default-Werte kannst Du unter Erweiterungen -> bas Lightbox setzen.

<txp:bas_lightbox />

bas_plugin_attributes	bas_plugin_values	bas_plugin_default	bas_plugin_description
img	Image ID	leer	Eine oder mehrere TXP Bilder ID. Komma getrennt
cat	Image Kategorie	leer	Add TXP image categorie. Can be used insted of img
caption	[name|alt|caption|none]	caption	Bestimme welcher Text als Untertitel gezeigt wird.
label	String	bas Lightbox	Text vor den Bildern
labeltag	bas_plugin_tag	h2	Tag für _label_
wraptag	bas_plugin_tag	ul	Tag um alle Bilder
wrapclass	bas_plugin_class	lightbox	Klasse für _wraptag_
break	bas_plugin_tag	li	Tag um jedes Bild
breakclass	bas_plugin_class	leer	Klasse für _break
use_cat	boolean	false	Auf true setzen, um <bas_lightbox/> außerhalb von Artikeln oder Artikelbausteinen die Bilderkategorie gleich Artikelkategorie zu setzen.
use_section	boolan	false	Auf true setzen, um <bas_lightbox/> außerhalb von Artikeln oder Artikelbausteinen die Bilderkategorie gleich Sektionsnamen zu setzen.

Die Default-Werte kannst Du unter Erweiterungen -> bas Lightbox ändern.

Changelog

0.5

• Update für TXP 4.0.5
• Weniger Datenbankabfragen
• Komprimiertes Prototype
• Custom-Field Support

0.4

• Update für TXP 4.0.4