schachbulle/contao-digiviewer-bundle

Digitaler Betrachter für Bildsammlungen mit Blätterfunktion, Zoom, Drehung und Vorschauleiste.

2.0.0 2026-08-06 10:21 UTC

Requires

• php: ^8.1
• contao/core-bundle: ^4.13 || ^5.0
• symfony/config: ^5.4 || ^6.4 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
• symfony/http-kernel: ^5.4 || ^6.4 || ^7.0

Requires (Dev)

• contao/manager-plugin: ^2.0

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Frank Hoppe
• Joerg Breitbart

• contao
• Viewer
• bilder
• bildsammlung
• digiviewer

Published on Packagist.org on 2026-08-06 10:28 UTC

README

Digitaler Betrachter für Bildsammlungen — etwa eingescannte Zeitschriften, Chroniken oder Urkunden. Der Besucher blättert durch die Bilder, zoomt stufenweise hinein und springt über eine aufklappbare Vorschauleiste direkt zu einer Seite. Unter dem Betrachter erscheinen die je Bild hinterlegten Texte (etwa per OCR erkannte Inhalte), damit die Contao-Suche und Suchmaschinen die Bildinhalte erfassen können.

Als Anzeige-Engine dient der DigiViewer von Joerg Breitbart (GPL), der auf der JavaScript-Bibliothek prototype.js aufbaut. Beide Dateien liegen dem Bundle bei; es werden keine fremden Server kontaktiert.

Voraussetzungen

• Contao 4.13 oder 5.x
• PHP 8.1 oder neuer

Installation

Über den Contao Manager (Paket schachbulle/contao-digiviewer-bundle) oder per Composer:

composer require schachbulle/contao-digiviewer-bundle

Anschließend den Datenbank-Abgleich im Install-Tool bzw. über contao:migrate ausführen.

Nutzung

1. Backend: Unter Inhalte → DigiViewer eine Bildsammlung anlegen. Je Sammlung lassen sich Anzeigebreite und -höhe des Betrachters, die Breite der Vorschauleiste sowie die Zoomstufen (in Prozent, durch Komma getrennt) und der Standardzoom festlegen.
2. Der Sammlung Bilder hinzufügen. Die Reihenfolge wird per Verschieben bestimmt; je Bild kann ein Textinhalt (z. B. OCR-Text) hinterlegt werden.
3. Frontend: Ein Modul vom Typ DigiViewer-Bildsammlung anlegen, die Sammlung auswählen und das Modul in einen Artikel oder ein Layout einbinden.

Hinweise

• Der Betrachter arbeitet mit festen Element-IDs, deshalb ist nur ein DigiViewer je Seite möglich.
• Die Originalmaße der Bilder werden automatisch aus den Dateien ermittelt; sie sind die Bezugsgröße für die Zoomstufen (100 % = Originalgröße).
• Das Bundle bindet prototype.js ein. Auf Seiten, die bereits andere JavaScript-Bibliotheken mit $-Kurzzeichen nutzen (etwa jQuery ohne noConflict), kann es zu Konflikten kommen.

Umstieg von der Contao-3-Erweiterung

Die Datenbanktabellen (tl_digiviewer, tl_digiviewer_items) und der Modultyp digiviewer_collection sind unverändert — bestehende Sammlungen und Module einer umgestellten Installation laufen ohne Nacharbeit weiter. Das alte Verzeichnis system/modules/digiviewer muss entfernt werden.

Lizenz

• PHP-Code des Bundles: LGPL-3.0-or-later
• DigiViewer-JavaScript-Bibliothek (digiviewer.js): GPL, © 2007 Joerg Breitbart
• prototype.js: MIT, © 2005–2007 Sam Stephenson