AddOn
Uppy für Redaxo
Beschreibung
# Uppy Uploader für REDAXOMultiuploader für REDAXO basierend auf [Uppy 5.0](https://uppy.io/).
Features
- ✅ Moderne UI: Responsive File-Upload-Oberfläche mit Drag & Drop
- ✅ Chunk-Upload: Unterstützung für sehr große Dateien durch Aufteilung in kleine Pakete (umgeht PHP
upload_max_filesize) - ✅ Client-seitige Bildoptimierung: Automatisches Resizing und EXIF-Korrektur vor dem Upload
- ✅ Image Editor: Integrierte Bildbearbeitung (Zuschneiden, Drehen, Spiegeln) mit festen Seitenverhältnissen
- ✅ Webcam-Integration: Direkte Foto-Aufnahme im Browser
- ✅ Metadaten-Verwaltung: Automatische Erkennung und Editor für MetaInfo-Felder (inkl. Mehrsprachigkeit)
- ✅ REDAXO Integration: Volle Unterstützung für
REX_MEDIA,REX_MEDIALISTund YForm - ✅ Dark Theme: Automatische Erkennung und manuelle Umschaltung
- ✅ Lokaler Build: Keine externen CDN-Abhängigkeiten (DSGVO-konform)
github.com/FriendsOfREDAXO/uppy
Umsetzung
Versionen
2.9.0
Version 2.9.0 (2026-08-10)
Neue Features
- Datei-Ersetzen im Mediapool mit Uppy: Auf der Medien-Detailseite (
mediapool/media) steht ein eigenes Uppy-Panel zum Ersetzen bestehender Dateien zur Verfügung. - Chunk-Replace für große Dateien: Auch das Ersetzen nutzt den Chunk-Workflow (
prepare/chunk/finalize) und funktioniert damit zuverlässig für große Dateien.
Verbesserungen
- Sichere Rechteprüfung beim Replace: Ersetzen ist nur für berechtigte Backend-User in erlaubten Mediapool-Kategorien möglich.
- UX nach erfolgreichem Replace: Automatischer Reload auf die Detailseite mit REDAXO-Info-Meldung.
- Dark-Mode-angepasstes Panel: Neue Replace-Panel-Styles folgen REDAXO Theme-Layern (Light, explizit Dark, Auto-Dark).
Einstellungen
- Neue Option: „Datei-Ersetzen im Mediapool mit Uppy“ zum Ein-/Ausschalten des Panels auf der Mediapool-Detailseite.
2.8.1
kleiner color fix für buttons
What's Changed
- chore: Update Uppy dependencies by @github-actions[bot] in https://github.com/FriendsOfREDAXO/uppy/pull/43
Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.8.0...2.8.1
2.8.0
Version 2.8.0 (2026-05-04)
Verbesserungen
- Optionale Medienanzeige bei Custom-Ordnern (
upload_folder) .Dateien koennen im Widget optional angezeigt und heruntergeladen werden. - Lightbox fuer Bilder und Videos im Widget: Vorschau per Klick (inkl. Video-Playback mit Controls).
Security
- Interner Backend-API-Endpunkt fuer Dateiabruf aus Custom-Ordnern (
rex-api-call=uppy_file_access) mit Backend-Session-Pflicht und robuster Pfadauflösung relativ zum Webroot (inkl.../).
2.7.1
Kleine Fixes im Session-Bereich
What's Changed
- 2.6.1 by @skerbis in https://github.com/FriendsOfREDAXO/uppy/pull/42
Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.7.0...2.7.1
2.7.0
Version 2.7.0 (2026-XX-XX)
Neue Features
- YCom-Medienberechtigungen beim Upload setzen: Optionales, ausklappbares Panel auf der Upload-Seite, mit dem berechtigte Backend-User die Frontend-Sichtbarkeit (
ycom_auth_type,ycom_group_type,ycom_groups) für alle in der Sitzung neu hochgeladenen Dateien vorbelegen können.- Voraussetzung: Plugin
ycom/media_authaktiv. - In den Einstellungen aktivierbar via Schalter „YCom-Medienberechtigungen beim Upload setzen“.
- Eigene Backend-Permission
uppy[ycom_media_auth](oder Admin) zur Steuerung, wer das Panel sehen und nutzen darf. - Werte werden pro Backend-Session gespeichert und automatisch auf jede neue Datei angewendet (Standard- und Chunk-Upload).
- Gruppenfelder erscheinen nur, wenn
ycom/groupverfügbar ist und ein passender Auth-/Gruppentyp gewählt ist. - Status-Badge im Panel-Header zeigt jederzeit, ob aktuell „Alle (öffentlich)“ oder „Nur eingeloggte“ als Default greift; Reset-Button setzt die Sitzungs-Defaults sofort zurück (UI + Session).
- Voraussetzung: Plugin
- Info-Center Widget: Wenn das AddOn
info_centerinstalliert ist, registriert Uppy ein Dashboard-Widget mit Kategorieauswahl, Drag&Drop-Bereich und direktem Link zur kompletten Upload-Seite.
Bugfixes
- Custom-Widget-Modus: Upload-Endpoint wird nun explizit auf den Backend-Controller gesetzt, damit die Backend-Session-Cookies mitgesendet werden. Dadurch greifen YCom-Auth-Defaults und sonstige Backend-User-bezogene Logik auch im Custom-Widget korrekt.
Security
- Strikte Doppelprüfung der YCom-Auth-Defaults: Plugin aktiv und Setting aktiviert und Backend-Session und Permission – server- wie clientseitig.
What's Changed
- chore: Update Uppy dependencies by @github-actions[bot] in https://github.com/FriendsOfREDAXO/uppy/pull/38
- chore: Update Uppy dependencies by @github-actions[bot] in https://github.com/FriendsOfREDAXO/uppy/pull/39
- Bump lodash from 4.17.23 to 4.18.1 by @dependabot[bot] in https://github.com/FriendsOfREDAXO/uppy/pull/40
- Ycom media auth by @skerbis in https://github.com/FriendsOfREDAXO/uppy/pull/41
Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.6.1...2.7.0
2.6.1
dark mode fix for button
2.6.0
Neue Features
- Erweiterte Dateitypen-Auswahl: Settings-Seite mit vollständigem Dateitypen-Katalog in 8 Gruppen (Bilder, Dokumente, Archive, Video, Audio, Office, OpenDocument, Fonts).
- Automatische Mediapool-Erweiterung: Vom Uppy konfigurierte MIME-Types werden zur Laufzeit automatisch im Mediapool freigeschaltet – keine manuelle Pflege der
allowed_mime_typesmehr nötig.
2.5.1
Version 2.5.1 (2026-02-10)
Fixed: AUTH-CHECKS in Frontend
Die AUTH-Kette war nicht durchgehend wodurch 404 Rückmeldungen entstanden.
Neue Features
- Helper Klasse:
FriendsOfRedaxo\Uppy\Utils::ensureApiSession()zum einfachen Setzen des API-Tokens im Frontend. - Not-Aus: Option "Auth Checks deaktivieren" für Notfälle oder internes Testen hinzugefügt (mit visueller Warnung).
- YForm Action:
uppy2emailberücksichtigt nun explizit den konfiguriertenupload_folder(Custom Folder), falls gesetzt. - Extension Points: Neue Hooks
UPPY_AUTH_CHECK(Custom Auth Provider) undUPPY_UPLOAD_COMPLETE(Post-Processing).
Security
- Auth-Hierarchie: Strikte Priorisierung implementiert: Backend User > Custom Auth (EP) > Not-Aus > YCom User > API Token.
- Settings UI: Verbesserte Darstellung der Sicherheitseinstellungen (API Token Warnung, Farbkodierung für Auth-Status).
- API Token: Fallback-Mechanismus gehärtet, Token wird nicht mehr im HTML-Markup exposed.
Dokumentation
- Struktur: Aufteilung der Dokumentation in Übersicht (README) und Integration (
frontend_usage.md). - Frontend-Guide: Neue, ausführliche Anleitung für YForm-Integration, Nutzung in eigenen Formularen und API-Features.
- Troubleshooting: Tipps zu Caching, Reverse Proxies (Nginx, Cloudflare), CSP-Headern und Server-Limits ergänzt.
2.4.0-beta1
2.4.0-beta1 introduces email action for yform
2.3.2
- Font-Size fix: changed rem to em
2.3.1
Removed some fixed font sizes
2.3.0
Neu:
- Upload in beliebigen Ordner. 📂
- Es kann das custom upload feld auch im Medienpool und der Upload Seite aktiviert werden.
- Dokumentation erweitert.
2.2.1
Fixed: https://github.com/FriendsOfREDAXO/uppy/issues/30, https://github.com/FriendsOfREDAXO/uppy/issues/29
- Syslogmeldungen entfernt
- Kategorieauswahl korrigiert.
2.2.0
Version 2.2.0 (2026-01-12)
Neue Features
- Drag & Drop auf Widget: Dateien können jetzt direkt auf das Upload-Widget gezogen werden
- Visuelles Feedback beim Hovern (blaue Umrandung)
- Modal öffnet sich automatisch mit den gezogenen Dateien
- Respektiert
max-filesLimit
Bugfixes
- Frontend-Upload: XHRUpload Response wird jetzt korrekt aus dem XHR-Objekt extrahiert
- Chunked-Upload: Chunk-Size Kalkulation korrigiert (MB zu Bytes Konvertierung)
- Chunked-Upload: Loop-Problem durch falsches
completeEvent behoben - Chunked-Upload: Unnötige Debug-Logs entfernt
Verbesserungen
- Frontend-Integration: Vollständige Dokumentation für Frontend-Usage hinzugefügt
- Chunked-Upload: Chunk-Size wird jetzt korrekt als MB interpretiert (nicht als Bytes)
- Error-Handling: Verbesserte Fehlerbehandlung bei ungültigen Server-Responses
Dokumentation
- README um Frontend-Integration erweitert
- Beispiel-Code für Frontend-Upload mit Chunked-Support
- Drag & Drop Feature dokumentiert
2.0.1
fixed: Bei chunked Upload wurden die Metas nicht übernommen
Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.0.0...2.0.1
2.0.0
Version 2.0.0 - Komplette Neuentwicklung
Hinweis: Dies ist ein Major-Release. Bitte die README und Migrationshinweise beachten.
Frohe Weihnachten an alle REDAXOianer! 🎄✨
Diese Version ist eine komplette Neuentwicklung des Uppy-Addons mit vielen neuen Features und Verbesserungen.
Neue Features
Custom Widget
- Minimale UI-Variante für kompakte Integration als Alternative zum Dashboard
- Perfekt für Frontend-Formulare und platzsparende Backend-Integrationen
- Leichtgewichtig und schnell initialisiert
Medienpool-Integration
- Auswahl bestehender Dateien aus dem REDAXO Mediapool
- Unterstützt Einzel- und Mehrfachauswahl
- Respektiert automatisch max_files-Einschränkungen
- Direkter URL-Ansatz für Multi-Select
File Management
- Unbegrenzte Dateien: Unterstützung für
max_files=0 - File Count Badge: Live-Anzeige der Dateianzahl (z.B. "Anzahl: 2/5")
- Orange Warnung wenn Maximum erreicht
- Verbesserte Icon-Anordnung: Delete, Edit, 24px Gap, Move-Buttons
YForm Integration (3 Varianten)
- Über Attribute (JSON): Flexible Konfiguration im Tablemanager
- Nativer YForm Value-Typ:
uppy_uploaderFeldtyp - setValueField(): Programmatische Feldkonfiguration
Automatisches Cleanup
- Optional: Automatisches Löschen nicht mehr verwendeter Dateien
- Intelligente Prüfung ob Datei noch in anderen Feldern verwendet wird
- Schutz vor versehentlichem Löschen im Mediapool
- Vollständige Protokollierung aller Löschvorgänge
Dark Mode
- Vollständige Unterstützung aller REDAXO Dark Themes
- Automatische Theme-Erkennung
- Optimierte CSS-Variablen für alle Farben und Abstände
Technische Verbesserungen
- Moderner Build-Prozess: esbuild statt Webpack
- Optimierte Bundles: Frontend/Backend getrennt für minimale Ladezeiten
- Robustere Templates: Elvis-Operator-Fix für korrekte 0-Werte
- Callback-System: Saubere Medienpool-Integration über
window.uppyMediapoolCallbacks - Multi-Upload Fix: Korrektur bei mehreren gleichzeitigen Uploads
Dokumentation
- Umfassende README mit allen Features
- API-Dokumentation für Entwickler
- Live-Demo im Backend
Für die Community
Danke an alle REDAXOianer für euer Feedback und eure Unterstützung!
Frohe Feiertage und einen guten Rutsch ins neue Jahr 2026! 🎊