Repository navigation
Releases
Releases · steffenglock/Paperless-ngx-Export-
v1.1.7 UI - Verbesserungen
Änderungsprotokoll / Changelog version 1.1.x
Version 1.1.7
| Bereich | Änderung |
|---|---|
| Tabellen-Tooltips | Natives title-Attribut ersetzt durch data-tooltip — CSS-Styling jetzt möglich |
| Tooltip-Hintergrund Tabelle | Hintergrundfarbe #F0F3F4 korrekt auf alle Tabellenzellen-Tooltips angewendet |
| Versions-Tooltip Farbe | Schriftfarbe #D95457 korrekt via #main-title[data-tooltip]::after gesetzt |
| Tooltip-System vereinheitlicht | Alle Tooltips (Tabelle, Modal-Labels, Überschrift) nutzen dasselbe [data-tooltip] CSS-System |
| Tooltip-Position Tabelle | Erscheint oberhalb der Zelle, linksbündig ausgerichtet |
Version 1.1.6
Deutsch
Benutzeroberfläche
- Toolbar neu strukturiert: Die drei Schaltflächen (Dokumente laden, CSV Export, Filter zurücksetzen) sind linksbündig angeordnet. Die Seitennavigation und die Auswahl der Einträge pro Seite befinden sich in derselben Zeile rechtsbündig.
- Paginierung unterhalb der Tabelle ist ebenfalls rechtsbündig ausgerichtet.
- Versions-Tooltip: Ein Hover über die Überschrift „Paperless-ngx Export" zeigt die aktuelle Versionsnummer
1.1.6in der Farbe#D95457an. - Tooltip-Design: Alle Tooltips haben nun eine einheitliche Hintergrundfarbe
#F0F3F4mit Rahmen und Schatten. Die übrigen Schriftfarben bleiben unverändert. - Tooltips im Einstellungsdialog: Die Beschriftungen für Basis-URL und API-Token zeigen beim Hovern einen erklärenden Tooltip mit Hintergrundfarbe
#F0F3F4an.
Technisch
- Neue CSS-Variablen
--tooltip-bg(#F0F3F4) und--version-color(#D95457) eingeführt. - Versionsnummer in Titel-Tag und Tooltip auf
1.1.6aktualisiert.
English
User Interface
- Toolbar restructured: The three buttons (Load documents, CSV Export, Reset filters) are left-aligned. The page navigation and the entries-per-page selector are placed in the same row, right-aligned.
- Pagination below the table is also right-aligned.
- Version tooltip: Hovering over the heading „Paperless-ngx Export" displays the current version number
1.1.6in the color#D95457. - Tooltip design: All tooltips now have a consistent background color of
#F0F3F4with a border and shadow. All other text colors remain unchanged. - Tooltips in the settings dialog: The labels for Base URL and API Token display an explanatory tooltip with background color
#F0F3F4on hover.
Technical
- New CSS variables
--tooltip-bg(#F0F3F4) and--version-color(#D95457) introduced. - Version number updated to
1.1.6in the title tag and tooltip.
Deutsch
Paperless-ngx Export — Änderungsprotokoll
Version 1.0.x → 1.1.4
Sicherheit
- Rate-Limiting auf allen API-Endpunkten eingeführt (Einstellungen: 10/min, Datenabruf: 60/min, Meta-Refresh: 5/min)
- Input-Validierung: Nur explizit erlaubte API-Parameter werden an Paperless weitergeleitet
- URL-Schema-Validierung beim Speichern der Konfiguration (
http://oderhttps://erforderlich) - Flask Debug-Modus explizit deaktiviert (
debug=False) - Container läuft nicht mehr als root, sondern unter einem eigenen Benutzer
appuser - API-Token wird im Einstellungsdialog maskiert angezeigt und kann per Schaltfläche temporär sichtbar gemacht werden
Neue Funktionen
- Mehrsprachigkeit: Die Oberfläche ist auf Deutsch 🇩🇪, Französisch 🇫🇷 und Englisch 🇬🇧 verfügbar
- Automatische Erkennung der Browsersprache beim ersten Start
- Manuelle Umschaltung über Flaggen-Schaltflächen oben links
- Gewählte Sprache wird im
localStoragegespeichert - CSV-Spaltenüberschriften werden in der gewählten Sprache exportiert
- Vollständige Paginierung: Alle Dokumente werden geladen, nicht nur die ersten 25
- Fortschrittsbalken zeigt den Ladevorgang an
- Mehrfachauswahl bei Filtern: Alle vier Dropdown-Filter (Korrespondent, Dokumententyp, Tags, Speicherpfad) unterstützen Mehrfachauswahl
- Umschaltung zwischen Einzel- und Mehrfachauswahl per
+ Multi/- EinzelButton - Im Mehrfachmodus: einfaches Anklicken wählt aus, erneutes Anklicken wählt ab — keine Strg/Cmd-Taste erforderlich
- Die Auswahlliste ist in der Höhe per Maus ziehbar
- Der gewählte Modus wird im
localStoragegespeichert und beim nächsten Besuch wiederhergestellt
- Umschaltung zwischen Einzel- und Mehrfachauswahl per
- „Leer"-Option in allen Dropdown-Filtern: ermöglicht die gezielte Suche nach Dokumenten ohne Korrespondent, Typ, Tag oder Speicherpfad
- Reset-Button: Setzt alle aktiven Filter auf einmal zurück
- Tooltips an den Konfigurationsfeldern erklären wo URL und API-Token in Paperless-ngx zu finden sind
- Volltextsuche durchsucht Titel und per OCR erkannten Dokumenteninhalt über den nativen
query-Parameter der Paperless-API
Verbesserungen
- Meta-Cache mit TTL: Metadaten (Korrespondenten, Tags, Typen, Pfade) werden 5 Minuten lang zwischengespeichert und nicht bei jedem Seitenaufruf neu geladen
- Differenzierte Fehlerbehandlung mit spezifischen HTTP-Statuscodes (401, 502, 504)
- CSV-Export enthält UTF-8 BOM für korrekte Darstellung in Microsoft Excel
- Datumsfelder werden beim Sortieren korrekt als Datum (numerisch) sortiert
- Deduplizierung bei Mehrfach-Requests verhindert doppelte Einträge in der Ergebnisliste
/data-Verzeichnis wird beim Container-Start automatisch angelegt
English
Paperless-ngx Export — Changelog
Version 1.0.x → 1.1.4
Security
- Rate limiting introduced on all API endpoints (settings: 10/min, data: 60/min, meta refresh: 5/min)
- Input validation: Only explicitly allowed API parameters are forwarded to Paperless
- URL scheme validation when saving configuration (
http://orhttps://required) - Flask debug mode explicitly disabled (
debug=False) - Container no longer runs as root, instead uses a dedicated
appuseraccount - API token is masked in the settings dialog and can be temporarily revealed via a toggle button
New Features
- Multilingual interface: The UI is available in German 🇩🇪, French 🇫🇷 and English 🇬🇧
- Automatic browser language detection on first launch
- Manual language switching via flag buttons in the top-left corner
- Selected language is persisted in
localStorage - CSV column headers are exported in the selected language
- Full pagination: All matching documents are loaded, not just the first 25
- A progress bar indicates the loading process
- Multi-selection for filters: All four dropdown filters (correspondent, document type, tags, storage path) support multiple selection
- Toggle between single and multi-selection using the
+ Multi/- Singlebutton - In multi mode: a single click selects an item, clicking again deselects it — no Ctrl/Cmd key required
- The selection list height is resizable by dragging
- The chosen mode is saved in
localStorageand restored on next visit
- Toggle between single and multi-selection using the
- "Empty" option in all dropdown filters: allows searching specifically for documents without a correspondent, type, tag or storage path
- Reset button: Clears all active filters at once
- Tooltips on configuration fields explain where to find the URL and API token in Paperless-ngx
- Full-text search searches both title and OCR-recognised document content via the native
queryparameter of the Paperless API
Improvements
- Meta cache with TTL: Metadata (correspondents, tags, types, paths) is cached for 5 minutes and not reloaded on every page visit
- Improved error handling with specific HTTP status codes (401, 502, 504)
- CSV export includes a UTF-8 BOM for correct display in Microsoft Excel
- Date columns are sorted correctly as dates (numerically) rather than as plain text
- Deduplication during multi-requests prevents duplicate entries in the results table
/datadirectory is automatically created when the container starts