AddOn


Uppy für Redaxo

Beschreibung

# Uppy Uploader für REDAXO
Multiuploader 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_MEDIALIST und 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

Für REDAXO
^5.19.1
Veröffentlicht am
10.08.2026
Require / PHP
>=8.1

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

Für REDAXO
^5.19.1
Veröffentlicht am
10.05.2026
Require / PHP
>=8.1

kleiner color fix für buttons

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.8.0...2.8.1

2.8.0

Für REDAXO
^5.19.1
Veröffentlicht am
04.05.2026
Require / PHP
>=8.1

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

Für REDAXO
^5.19.1
Veröffentlicht am
28.04.2026
Require / PHP
>=8.1

Kleine Fixes im Session-Bereich

What's Changed

Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.7.0...2.7.1

2.7.0

Für REDAXO
^5.19.1
Veröffentlicht am
28.04.2026
Require / PHP
>=8.1

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_auth aktiv.
    • 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/group verfü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).
  • Info-Center Widget: Wenn das AddOn info_center installiert 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

Full Changelog: https://github.com/FriendsOfREDAXO/uppy/compare/2.6.1...2.7.0

2.6.1

Für REDAXO
^5.19.1
Veröffentlicht am
02.03.2026
Require / PHP
>=8.1

dark mode fix for button

2.6.0

Für REDAXO
^5.19.1
Veröffentlicht am
19.02.2026
Require / PHP
>=8.1

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_types mehr nötig.

2.5.1

Für REDAXO
^5.19.1
Veröffentlicht am
11.02.2026
Require / PHP
>=8.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: uppy2email berücksichtigt nun explizit den konfigurierten upload_folder (Custom Folder), falls gesetzt.
  • Extension Points: Neue Hooks UPPY_AUTH_CHECK (Custom Auth Provider) und UPPY_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

Für REDAXO
^5.19.1
Veröffentlicht am
10.02.2026
Require / PHP
>=8.1

2.4.0-beta1 introduces email action for yform

2.3.2

Für REDAXO
^5.19.1
Veröffentlicht am
02.02.2026
Require / PHP
>=8.1
  • Font-Size fix: changed rem to em

2.3.1

Für REDAXO
^5.19.1
Veröffentlicht am
01.02.2026
Require / PHP
>=8.1

Removed some fixed font sizes

2.3.0

Für REDAXO
^5.19.1
Veröffentlicht am
21.01.2026
Require / PHP
>=8.1

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

Für REDAXO
^5.19.1
Veröffentlicht am
21.01.2026
Require / PHP
>=8.1

2.2.0

Für REDAXO
^5.19.1
Veröffentlicht am
12.01.2026
Require / PHP
>=8.1

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-files Limit

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 complete Event 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

Für REDAXO
^5.19.1
Veröffentlicht am
08.01.2026
Require / PHP
>=8.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

Für REDAXO
^5.19.1
Veröffentlicht am
21.12.2025
Require / PHP
>=8.1

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)

  1. Über Attribute (JSON): Flexible Konfiguration im Tablemanager
  2. Nativer YForm Value-Typ: uppy_uploader Feldtyp
  3. 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! 🎊