Jürgen Mummert
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
# Flipbook Bundle (Contao 5.7)
|
|
|
|
Contao Inhaltselement zum Darstellen von PDFs als blaetterbares Flipbook.
|
|
|
|
## Features
|
|
|
|
- Reines JavaScript (ES Modules)
|
|
- `pdfjs-dist` fuer PDF-Rendering in `<canvas>`
|
|
- `flipbook-js` fuer den Blaettereffekt
|
|
- Lazy Rendering: 2-4 Seiten sofort, Rest on-demand
|
|
- Optional Vor-/Zurueck-Navigation im Modul
|
|
- Tastatursteuerung (Pfeiltasten) und Touch-Swipe
|
|
- Responsive Breite mit beibehaltenem Seitenverhaeltnis
|
|
|
|
## Installation (VCS oder Paket)
|
|
|
|
```bash
|
|
composer require mummert/flipbook-bundle
|
|
```
|
|
|
|
## Inhaltselement im Backend
|
|
|
|
Elementtyp: `Blätterbares PDF`
|
|
|
|
Felder:
|
|
|
|
- `PDF-Datei` (singleSRC / UUID)
|
|
- `Initial geladene Seiten` (2, 3 oder 4)
|
|
- `Startmodus` (zentriert oder als Doppelseite)
|
|
- `Navigation anzeigen` (optional)
|
|
|
|
## Hinweise
|
|
|
|
- Das Inhaltselement rendert PDF-Seiten als `<canvas>` innerhalb von `.c-flipbook__page`.
|
|
- Die benoetigten Open-Source-Dateien sind lokal im Bundle enthalten.
|
|
- Fuer Shared-Hosting ohne konfigurierbare MIME-Types werden PDF.js-Module als `.js` ausgeliefert (statt `.mjs`).
|
|
- Siehe `THIRD_PARTY_LICENSES.md` fuer Abhaengigkeiten.
|
|
|
|
## Release
|
|
|
|
```bash
|
|
git tag v1.0.0
|
|
git push origin v1.0.0
|
|
```
|