Plugin-Dokumentation · JTL-Shop 5
Produktbild-Zoom — Konfiguration & Bedienung
Alle Einstellungen im Detail sowie die Bedienung von Hover-Lupe und Lightbox.
Einstellungen
Zu finden unter Plugins → Produktbild-Zoom → Einstellungen:
| Einstellung | Standard | Wirkung |
|---|---|---|
| Plugin aktivieren | Aktiviert | Schaltet Hover-Lupe und Lightbox im Frontend ein oder aus. |
| Zoom-Faktor | 2,5 | Vergrößerungsfaktor der Hover-Lupe. Serverseitig auf einen Bereich von 1,5 bis 5 begrenzt. |
Bedienung im Frontend
- Desktop: Beim Bewegen der Maus über ein Produktbild erscheint eine Lupe mit dem eingestellten Zoom-Faktor. Ein Klick auf das Bild öffnet zusätzlich die Lightbox.
- Tastatur: Das Produktbild ist per Tab erreichbar; Enter oder Leertaste öffnen die Lightbox. Innerhalb der Lightbox hält eine Fokus-Falle den Tastaturfokus im Dialog, Esc schließt sie wieder und der Fokus kehrt zum auslösenden Element zurück.
- Mobilgeräte (≤768px): Die Hover-Lupe wird ausgeblendet, da es dort keinen Mauszeiger gibt. Ein Tap auf das Produktbild öffnet direkt die Lightbox.
- Ladeverhalten: Das hochauflösende Vollbild wird erst beim Hover bzw. beim Öffnen der Lightbox nachgeladen — nicht bereits beim Seitenaufbau. Das schont Ladezeit und Datenvolumen.
Hinweise
Wie erkennt das Plugin die Produktbilder?
Über gängige CSS-Selektoren des NOVA-Templates (u. a. .product-detail img.product-image, .produktdetails .image img, .product-gallery img). Ist ein größeres Originalbild über ein data-src-large-Attribut verfügbar, wird dieses für den Zoom verwendet; andernfalls das angezeigte Bild selbst.
Was passiert bei einem Template-Update?
Ändert ein NOVA-Template-Update die Bildmarkup-Struktur grundlegend, kann das Skript die Bilder nicht mehr zuordnen. Das führt zu keinem Fehler, aber auch zu keinem Zoom mehr. Prüfen Sie nach größeren Template-Updates kurz, ob Hover-Lupe und Lightbox noch funktionieren.
Kollidiert das Plugin mit vorhandenen Bild-Links?
Ist ein Produktbild in eine eigene Verlinkung eingebettet (etwa eine Galerie-eigene Lightbox), unterbindet das Plugin beim Klick das Standardverhalten dieses Links, damit nicht zwei Lightboxen gleichzeitig öffnen oder die Seite ungewollt wechselt.
Was passiert bei der Deinstallation?
Das Plugin legt keine eigenen Datenbanktabellen an; beim Deinstallieren werden nur die Plugin-Einstellungen entfernt.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org