Integration von Bildgalerien in Joomla 6: Implementierung von bildbasierten Verzeichnisstrukturen in Beiträge, automatisierte Generierung von Vorschaubildern und Aktivierung der Lightbox-Funktionalität via Single-Click-Event.
Bildergalerien für Joomla 6: Ordner mit Bildern in den Beitrag einfügen, Vorschaubilder entstehen automatisch, ein Klick öffnet die Lightbox.
Was kann SK Gallery?
- Galerie per Tag im Beitrag einbinden – ohne Programmieren
- Automatische Vorschaubilder (JPG, PNG, WebP, GIF), zugeschnitten oder im Seitenverhältnis
- Eigene Lightbox ohne Fremdbibliothek: Pfeiltasten, Esc, Wischen am Handy, Bildzähler, optional Download
- Titel und Beschreibungen pro Bild, auch mehrsprachig
- Sortierung, Bildlimit, Dateifilter, Listenansicht, Lazy Loading
- Admin-Verwaltung für Galerien: anlegen, Bilder hochladen, beschriften, löschen
- Name des Tags frei einstellbar, zusätzliche Tags möglich
So bindest du eine Galerie ein
- In der Komponente SK Gallery eine Galerie anlegen und Bilder hochladen.
- Den angezeigten Tag mit Kopieren übernehmen.
- Im Beitrag an der gewünschten Stelle einfügen und speichern.
{gallery}images/galleries/urlaub{/gallery}Der Pfad beginnt immer unterhalb von images. Ordner mit eigenen Bildern kannst du auch per FTP anlegen und direkt verwenden.
Optionen im Tag
Alle Einstellungen aus dem Plugin lassen sich pro Galerie überschreiben. Die Optionen folgen nach dem Pfad, getrennt durch Kommas:
{gallery}images/galleries/urlaub,width=300,height=200,columns=4,limit=12,sort=date_desc,captions=1{/gallery}| Option | Standard | Wirkung |
|---|---|---|
width | 250 | Breite der Vorschaubilder in px (40–2000) |
height | 250 | Höhe der Vorschaubilder in px (40–2000) |
crop | 1 | 1 = mittig auf exakt Breite × Höhe zuschneiden, 0 = Seitenverhältnis behalten |
quality | 82 | Qualität der Vorschaubilder (30–100) |
columns | 0 | Feste Spaltenzahl (1–12), 0 = automatisch nach Vorschaubreite |
gap | 16 | Abstand zwischen den Bildern in px (0–64) |
list | 0 | 1 = Listenansicht statt Vorschaubilder |
captions | 0 | 1 = Titel unter den Vorschaubildern anzeigen |
captions_file | 1 | Titel/Beschreibungen aus captions.txt lesen |
convert_names | 1 | Ohne Eintrag den Dateinamen als Titel verwenden |
lazy | 1 | Lazy Loading der Bilder |
lightbox | 1 | Klick öffnet das Originalbild in der Lightbox |
info | 1 | Titel und Beschreibung in der Lightbox zeigen |
download | 0 | Download-Button in der Lightbox |
sort | name_asc | name_asc, name_desc, date_asc, date_desc, random, file |
limit | 0 | Maximale Bildanzahl, 0 = alle |
filter | – | Nur Dateien, deren Name einen der Begriffe enthält (mit | trennen) |
Eigener Tag-Name
In den Plugin-Einstellungen (Reiter Tag-Name) legst du den Haupt-Tag selbst fest, zum Beispiel bilder statt gallery. Unter Zusätzliche Tags trägst du weitere Namen kommagetrennt ein, etwa fotos,galerie. Alle Namen funktionieren gleichzeitig.
gallery unter den zusätzlichen Tags ein, damit bestehende Beiträge weiter funktionieren. Erlaubt sind Kleinbuchstaben, Ziffern, Unterstrich und Bindestrich.Titel und Beschreibungen
Lege im Galerie-Ordner eine Datei captions.txt an (oder pflege die Texte direkt in der Verwaltung). Pro Zeile ein Bild:
strand.jpg|Am Strand|Abendstimmung auf Sylt
berge.jpg|GipfelblickFür mehrere Sprachen gibt es captions-de-DE.txt, captions-en-GB.txt usw.; die Datei der aktuellen Sprache hat Vorrang. Fehlt ein Eintrag, wird der Dateiname als Titel verwendet. Mit sort=file bestimmt die Reihenfolge in der Textdatei die Reihenfolge der Galerie. Texte werden immer maskiert ausgegeben, HTML ist nicht möglich.
Lightbox
- Vor/Zurück per Pfeiltasten, Schaltflächen oder Wischgeste
- Schließen mit Esc, Klick neben das Bild oder Kreuz
- Bildzähler, Titel und Beschreibung unter dem Bild
- Nachbarbilder werden vorgeladen, der Fokus bleibt im Fenster (barrierearm)
- Optionaler Download-Button für das Originalbild
Verwaltung im Backend
- Galerien: Übersicht mit Bildanzahl, Tag zum Kopieren, Verwalten und Löschen
- Upload: mehrere Bilder gleichzeitig, Dateinamen werden bereinigt, doppelte Namen automatisch nummeriert
- Beschriftungen: Titel und Beschreibung je Bild, gespeichert in
captions.txt - Vorschaubilder löschen: erzwingt neue Vorschaubilder, z. B. nach geänderter Größe
- Einstellungen: Galerie-Verzeichnis (Standard
images/galleries), maximale Dateigröße, Berechtigungen
Plugin-Einstellungen
- Layout: Listenansicht, Spalten, Abstand, Titel unter Bildern, Lazy Loading, Sortierung, Limit, Dateifilter
- Vorschaubilder: Größe, Zuschneiden, Qualität, neue Vorschaubilder pro Seitenaufruf
- Lightbox: ein/aus, Titel und Beschreibung, Download
- Texte: captions.txt verwenden, Dateinamen als Titel
Bei großen Galerien werden pro Seitenaufruf nur begrenzt viele neue Vorschaubilder erzeugt (Standard 24); der Rest folgt bei den nächsten Aufrufen. So gibt es keine Zeitüberschreitung.
Sicherheit und Technik
- Galerie-Pfade sind auf den Ordner
imagesbeschränkt;.., absolute Pfade und Symlinks werden abgewiesen - Alle Ausgaben (Titel, Beschreibungen, Dateinamen) werden maskiert
- Upload nur für echte Bilder (JPG, PNG, GIF, WebP), geprüft nach Inhalt und Dateiendung
- Alle Backend-Aktionen sind per Token und Joomla-Berechtigung geschützt
- Besucher sehen bei einer fehlerhaften Galerie keine Fehlermeldung, angemeldete Verwalter schon
- Voraussetzung: Joomla 6, PHP 8.3, PHP-Erweiterung GD für die Vorschaubilder