saltcorn-samba 0.4.14 → 0.4.16

package/CHANGELOG.md

@@ -4,6 +4,153 @@ All notable changes to `saltcorn-samba` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.4.16] – 2026-07-08
+
+### Added – Internationalisierung (Deutsch + Englisch)
+
+Alle sichtbaren Texte im File-Manager, im Tree, im PDF-Fieldview und in den
+Dialogen (Upload, Delete, Rename, Mkdir) sind jetzt übersetzbar.
+
+- Neue Kataloge unter `i18n/de.json` und `i18n/en.json` (~90 Schlüssel,
+  Punkt-Notation nach Bereich `ui.*`, `fm.*`, `tree.*`, `pdf.*`).
+- Neues Server-Modul `i18n.js` – keine externe Dependency, JSON-Kataloge
+  werden gelesen und im Prozess gecacht. Placeholder-Interpolation `{name}`.
+  API: `t(key, {locale, ...params})`, `tFor(locale)`, `catalogFor(locale)`,
+  `resolveLocaleFromReq(req, explicit)`.
+- Locale-Auflösung: expliziter Wert → `req.getLocale()` → Query `?locale=xx`
+  → `Accept-Language`-Header → Fallback `en`. Unbekannte Locales fallen
+  automatisch auf die Sprachbasis oder `en` zurück.
+- Neue Diagnose-Route `GET /samba-i18n.json?locale=xx` liefert den Katalog
+  als JSON (kein Auth, enthält keine Konfiguration).
+- Client bekommt den Katalog **inline** in die View-Shell injiziert – kein
+  zusätzlicher HTTP-Roundtrip beim ersten Rendern, keine englischen Keys, die
+  kurz aufblitzen. `SambaCommon.setCatalog(…)` wird aufgerufen, bevor die
+  view-spezifische JS-Datei geladen wird.
+- Fehlt ein Key: automatischer Fallback auf Englisch, dann auf den Key
+  selbst – nichts bricht.
+
+### Changed – Client-JS: Gemeinsame Utilities in `public/samba-common.js`
+
+- Neues Modul `public/samba-common.js` bündelt: `iconFor()`, `extOf()`,
+  `mediaTypeFor()`, `isViewable()`, `fmtSize()`, `fmtDate()`, `joinPath()`,
+  `parentOf()`, plus die i18n-Funktionen `t()`, `setCatalog()`, `loadCatalog()`.
+- **`iconFor()` war bisher in `samba-filemanager.js` und `samba-tree.js`
+  identisch dupliziert** – jetzt einzige Quelle in `samba-common.js`.
+  Änderungen am Icon-Mapping (neue Extensions etc.) müssen nur noch an einer
+  Stelle gemacht werden.
+- `samba-filemanager.js` und `samba-tree.js` konsumieren die Utilities über
+  `window.SambaCommon`. Die lokalen Kopien von `iconFor`, `extOf`,
+  `mediaTypeFor`, `isViewable`, `fmtSize`, `fmtDate`, `joinPath`, `parentOf`
+  sind entfernt.
+- Alle sichtbaren Strings in beiden Client-JS gehen über `SambaCommon.t(...)`.
+
+### Changed – Bootstrap der View-Shells: zweistufig
+
+`filemanager-view.js` und `tree-view.js` laden jetzt zuerst `samba-common.js`
+(setzt `window.SambaCommon`, wendet den inline gelieferten i18n-Katalog an)
+und erst danach die view-spezifische JS-Datei. Sind beide bereits geladen,
+wird nur re-mounted – kein doppeltes `<script>`-Injecten. `pdf-view.js`
+nutzt serverseitig `tFor(resolveLocaleFromReq(req))`.
+
+### Changed – Namens-Cleanup und Kommentare in beiden Client-JS
+
+Goal: die Client-Dateien sollen sich wie ordentliche Node-ähnliche Module
+lesen, nicht wie ein Minifier-Output.
+
+- `samba-tree.js`: `h`→`element`, `fetchDir`→`fetchDirectory`,
+  `renderList`→`renderLevel`, `openDir`→`toggleDirectory`, `li`→`lineItem`
+  u.ä. Jede exportierte / interne Funktion hat einen JSDoc-Kommentar.
+- `samba-filemanager.js`: `h`→`element`, `modal`→`openModal`, `m`→`dialog`,
+  `r`→`response`, `fd`→`formData`, `overwriteCb`→`overwriteCheckbox`,
+  `picked`→`pickedList`, `uploadBtn`→`uploadButton`. Kommentare ergänzt.
+
+### Added – README: Sicherheits-Abschnitt „Client-/Server-Trennung“
+
+Neuer Unterabschnitt in `## Sicherheit` erklärt explizit:
+
+- Welche Dateien serverseitig laufen (SMB-Credentials, `base_path`,
+  `view_base_path`, Sanitizer, Routen) und welche clientseitig (reine UI).
+- Wo genau Sicherheit durchgesetzt wird: CSRF (Saltcorn-csurf), Auth/Rolle
+  (Saltcorn + `min_role_read`/`min_role_write`), `sanitizeRelativePath`,
+  Base-Path-Enforcement, SMB-Session mit serverseitig konfiguriertem User.
+- Wichtiger Hinweis: `view_base_path` ist **keine** Sicherheitsgrenze
+  zwischen Usern; für Mandantentrennung entweder Rollen-gated Views oder
+  eigene Plugin-Instanzen mit separaten SMB-Usern.
+- Kurzfassung: JavaScript in `public/` ist reine Kosmetik; jeder Client (auch
+  ein manipulierter) bekommt dieselben 403/400-Antworten wie ein regulärer.
+
+Zusätzlich neuer Abschnitt `## Internationalisierung (i18n)` mit
+Entwickler-Doku (Kataloge ergänzen, API, Locale-Auflösung, Diagnose-Route).
+
+### Packaging
+
+- `package.json`: Version 0.4.15 → 0.4.16. `files` ergänzt um `i18n.js` und
+  `i18n/`. `lint`-Script prüft jetzt auch `i18n.js` und `public/samba-common.js`.
+- Keine neuen Runtime-Dependencies. Fortlaufend: nur `smb3-client ^0.2.0`.
+
+### Compatibility
+
+Rückwärtskompatibel:
+
+- Alle bestehenden Routen (`/sambadir`, `/sambafile`, `/sambalink`,
+  `/sambaupload`, `/sambadelete`, `/sambarename`, `/sambamkdir`, `/sambatest`)
+  unverändert in Signatur und Verhalten.
+- View-Konfigurationsschema unverändert; existierende Views laufen weiter.
+- Wer die Client-JS direkt einbindet, muss zusätzlich `samba-common.js` vor
+  `samba-filemanager.js` / `samba-tree.js` laden (das übernimmt die
+  View-Shell automatisch).
+
+## [0.4.15] – 2026-07-07
+
+### Fixed – CSRF-Fehlermeldung bei Upload / Ordner anlegen / Rename / Delete
+
+Bei jedem schreibenden Klick in der File-Manager-View („Ordner anlegen“,
+„Datei hochladen“, „umbenennen“, „löschen“) erschien der Fehler
+`Invalid CSRF token`, obwohl der Client den Token korrekt im Header
+`X-CSRF-Token` mitgeschickt hat.
+
+**Root Cause:** Saltcorns globaler `csurf`-Middleware validiert bereits
+alle POST-Routen der Plugins gegen das Session-Secret. Unser Plugin hatte
+zusätzlich eine manuelle `checkCsrf(req)`-Funktion, die den vom Client
+geschickten Token mit `req.csrfToken()` verglich. `req.csrfToken()` gibt
+aber bei jedem Aufruf einen **frisch gesalzenen** Token zurück – der
+Stringvergleich `provided !== req.csrfToken()` schlug daher immer fehl,
+auch bei völlig gültigen Requests.
+
+**Fix:** `checkCsrf` ist jetzt ein dokumentierter No-Op. Die eigentliche
+CSRF-Prüfung übernimmt weiterhin Saltcorns Middleware (kein Sicherheits-
+abbau). Betroffene Write-Routen (Upload, Mkdir, Rename, Delete) in
+`index.js` sind unverändert und funktionieren jetzt korrekt.
+
+### Added – View-Basispfad (`view_base_path`) für File-Manager und Tree
+
+Beide Views (SambaFileManager und SambaTree) haben ein neues optionales
+Konfigurationsfeld **„View-Basispfad (relativ zum Plugin-Basispfad)“**.
+Damit lässt sich der Pfad zweistufig konfigurieren:
+
+1. **Plugin-Basispfad** (weiterhin Pflicht) – z. B. `static` – legt fest,
+   in welchem Unterverzeichnis der Freigabe der Plugin-Root liegt.
+2. **View-Basispfad** (neu, optional) – z. B. `projekte/2026` – ein
+   statischer Präfix, der nur für diese eine View gilt.
+
+Beispiel: Plugin-Basispfad = `static`, View-Basispfad = `projekte/2026`
+→ die View listet den effektiven Pfad `static/projekte/2026`.
+
+Der bisherige `extra_subpath` in beiden Views ist jetzt konsistent auf
+den `from_field`-Modus beschränkt (dort weiterhin: Suffix hinter dem
+Feldwert der aktuellen Zeile). Im `static`-Modus zählt nur
+`view_base_path`.
+
+Der zusammengesetzte Pfad wird pro Segment slash-getrimmt und
+durchläuft `sanitizeRelativePath`, so dass `..`-Traversal, absolute
+Pfade, UNC-Präfixe usw. weiterhin abgelehnt werden.
+
+### Tests
+
+`test/sanitize.test.js` deckt jetzt zusätzlich die Pfad-Komposition
+(`view_base_path` + Feldwert + `extra_subpath`) inklusive Slash-
+Normalisierung, Modus-Regeln und Traversal-Ablehnung ab.
+
 ## [0.4.14] – 2026-07-06
 
 ### Changed – Code-Review / Aufräumen (keine Verhaltensänderung)

package/README.md

@@ -194,9 +194,10 @@ Optionen:
 
 | Option | Zweck |
 |---|---|
-| **Root directory mode** | `static` = immer Base-Path aus Plugin-Config, `from_field` = Sub-Pfad kommt aus einem DB-Feld der aktuellen Zeile |
-| **Row field with sub-path** | Feld der Tabelle mit dem relativen Ordnernamen (bei `from_field`) |
-| **Extra sub-path** | statischer Suffix (z. B. `invoices`) |
+| **View-Basispfad (relativ zum Plugin-Basispfad)** | Optionaler statischer Präfix nur für diese View. Beispiel: Plugin-Basispfad = `static`, View-Basispfad = `projekte/2026` → View listet `static/projekte/2026`. Zweistufige Konfiguration: einmal serverweit im Plugin, einmal pro View. |
+| **Row-Modus** | `static` = nur der View-Basispfad zählt, `from_field` = zusätzlich wird ein DB-Feldwert der aktuellen Zeile angehängt (z. B. in einer Show-View) |
+| **Feld mit Unterpfad** | Feld der Tabelle mit dem relativen Ordnernamen (nur bei `from_field`) |
+| **Zusätzlicher Suffix (nach dem Feldwert)** | statischer Suffix, z. B. `invoices` (nur bei `from_field`) |
 | **Show hidden files** | `.dotfiles` einblenden |
 | **Allow navigating up** | Up-Button aktivieren (nur bis zum Root, kein Ausbruch) |
 | **Open PDFs / images inline** | Klick öffnet die Datei im integrierten Viewer |
@@ -204,6 +205,10 @@ Optionen:
 | **Page size** | Einträge pro Seite (0 = alle) |
 | **Panel title** | Text im Karten-Header |
 
+Der effektive Pfad wird zusammengesetzt aus (jeweils falls gesetzt):
+`Plugin-Basispfad / View-Basispfad / Feldwert / Zusätzlicher Suffix`.
+`..`-Traversal, absolute Pfade und UNC-Präfixe werden abgelehnt.
+
 Beispiel-Datenmodell für kunden-spezifische Ordner:
 
 ```
@@ -212,12 +217,13 @@ Felder:   name (String), akte_dir (String, z. B. "kunde_42/2026")
 ```
 
 Dann eine Show-View von `kunden` bauen und die `SambaFileManager`-View mit
-Mode = `from_field`, Row field = `akte_dir` einbetten.
+Row-Modus = `from_field`, Feld = `akte_dir` einbetten.
 
 ### View: `SambaTree`
 
 Kompaktere Alternative – lazy-loading Baum, ideal in einer Sidebar oder
-neben Formularen. Gleiche Path-Modi wie beim File-Manager.
+neben Formularen. Gleiche Path-Optionen wie beim File-Manager (inkl.
+**View-Basispfad**, **Row-Modus**, **Feld**, **Zusätzlicher Suffix**).
 
 ### Fieldview `samba_pdf` (deaktiviert seit 0.3.2)
 
@@ -298,6 +304,70 @@ führende/abschließende Punkte oder Windows-Reserved-Names enthalten.
 
 Unit-Tests zum Path- und Filename-Sanitizer laufen in CI (`npm test`).
 
+### Client-/Server-Trennung
+
+Damit klar ist, wo Sicherheit tatsächlich durchgesetzt wird: das Plugin
+läuft in zwei streng getrennten Welten.
+
+- **Serverseitig (Node.js im Saltcorn-Prozess):**
+  `index.js` (HTTP-Routen), `smb-client.js` (SMB3-Verbindung, Auth, Signing,
+  Encryption), `readdir-compat.js` (Verzeichnis-Listing),
+  `filemanager-view.js` / `tree-view.js` / `pdf-view.js`
+  (configuration_workflow, run, computeStartPath, sanitizeRelativePath),
+  `i18n.js` (Übersetzungskatalog) und `tools/diag-*.js` (CLI-Diagnose).
+  **SMB-Credentials (User, Domain, Passwort), Plugin-`base_path` und pro-View
+  `view_base_path` liegen ausschließlich serverseitig in der Saltcorn-DB.**
+  Der Browser sieht davon nichts.
+
+- **Clientseitig (Browser, unter `public/`):**
+  `samba-filemanager.js`, `samba-tree.js`, `samba-common.js` (gemeinsame
+  Utilities + i18n) und `samba.css`. Reine UI. Alle Zugriffe laufen über
+  `fetch()` mit `X-CSRF-Token`-Header.
+
+- **Enforcement-Punkte serverseitig — in jeder Request-Bearbeitung:**
+  1. **CSRF** – Saltcorns globale csurf-Middleware. Ohne Token: 403.
+  2. **Auth/Rolle** – Saltcorn prüft Login und View/Table-Rechte vor `run(…)`.
+     Zusätzlich prüft jede Route `min_role_read` bzw. `min_role_write`.
+  3. **Pfad-Sanitizing** – `sanitizeRelativePath` lehnt `..`, absolute Pfade,
+     UNC-Präfixe, Laufwerksbuchstaben und NUL-Bytes ab.
+  4. **Base-Path-Enforcement** – der effektive Pfad ist immer relativ zum
+     serverseitig konfigurierten `base_path`; `view_base_path` stammt aus der
+     View-Konfig, nie aus dem Request.
+  5. **SMB-Session** läuft mit dem serverseitig konfigurierten SMB-User; der
+     Client kann keine anderen Credentials injizieren.
+
+- **Wichtige Hinweise:**
+  `view_base_path` ist **keine** Sicherheitsgrenze zwischen Usern – nur
+  Bequemlichkeit. Für Mandantentrennung entweder eigene Views pro Mandant
+  (mit Rollen-Steuerung), oder mehrere Plugin-Instanzen mit unterschiedlichen
+  SMB-Usern. Produktions-Empfehlung: dedizierter SMB-Service-Account mit
+  minimalen Rechten; die Fileserver-ACL limitiert dann zusätzlich.
+
+- **Kurzfassung:** JavaScript in `public/` ist reine Kosmetik. Alle
+  Zugriffsrechte werden serverseitig durchgesetzt — ein manipulierter Client
+  bekommt genau die gleichen 403/400-Antworten wie ein regulärer.
+
+---
+
+## Internationalisierung (i18n)
+
+Ab v0.4.16 sind alle sichtbaren Texte übersetzbar. Ausgeliefert werden **de**
+und **en**.
+
+- Kataloge liegen als JSON unter `i18n/<locale>.json`.
+- Serverseitige Nutzung: `const { t, tFor } = require("./i18n");`
+  → `t("fm.upload.button", { locale: "de" })` bzw.
+  `const _t = tFor("de"); _t("fm.upload.button")`.
+- Clientseitig: `window.SambaCommon.t("fm.upload.button")`. Der Katalog wird
+  von der View-Shell inline in die Seite injiziert (kein Extra-Request).
+- Locale-Auflösung: explizit übergebener Wert → `req.getLocale()` →
+  `?locale=xx` → `Accept-Language` → Fallback `en`.
+- Neue Sprache ergänzen: `i18n/<locale>.json` anlegen, `availableLocales` in
+  `i18n.js` erweitern, PR aufmachen. Fehlt ein Key, greift automatisch der
+  englische Fallback — nichts bricht.
+- Diagnose-Endpoint: `GET /samba-i18n.json?locale=de` liefert den kompletten
+  Katalog als JSON (ohne Auth, enthält keine Konfiguration).
+
 ---
 
 ## Entwicklung

package/filemanager-view.js

@@ -18,6 +18,7 @@ const Field = require("@saltcorn/data/models/field");
 const Table = require("@saltcorn/data/models/table");
 
 const { sanitizeRelativePath } = require("./smb-client");
+const { catalogFor, resolveLocaleFromReq } = require("./i18n");
 
 // ---------------------------------------------------------------------------
 // Configuration workflow
@@ -44,31 +45,42 @@ const configuration_workflow = () =>
             .map((f) => f.name);
           return new Form({
             fields: [
+              new Field({
+                name: "view_base_path",
+                label: "View-Basispfad (relativ zum Plugin-Basispfad)",
+                type: "String",
+                sublabel:
+                  "Optional. Statischer Pfad relativ zum Plugin-Basispfad, der f\u00fcr diese View gilt. " +
+                  "Beispiel: Plugin-Basispfad = 'static', View-Basispfad = 'projekte/2026' \u2192 View listet 'static/projekte/2026'. " +
+                  "Keine f\u00fchrenden/abschlie\u00dfenden Slashes n\u00f6tig. Traversal (\u201e..\u201c) wird abgelehnt.",
+              }),
               new Field({
                 name: "mode",
-                label: "Root directory mode",
+                label: "Row-Modus",
                 type: "String",
                 required: true,
                 attributes: {
                   options: ["static", "from_field"],
                 },
                 sublabel:
-                  "static = always the plugin base_path. from_field = append a row field value to base_path (only when the view is embedded in a Show view).",
+                  "static = immer nur der View-Basispfad. from_field = h\u00e4nge einen Feldwert der aktuellen Zeile an " +
+                  "(nur sinnvoll, wenn die View in einer Show-View eingebettet ist).",
                 default: "static",
               }),
               new Field({
                 name: "path_field",
-                label: "Row field with sub-path",
+                label: "Feld mit Unterpfad",
                 type: "String",
                 attributes: { options: stringFieldOptions },
                 showIf: { mode: "from_field" },
               }),
               new Field({
                 name: "extra_subpath",
-                label: "Extra sub-path (appended)",
+                label: "Zus\u00e4tzlicher Suffix (nach dem Feldwert)",
                 type: "String",
                 sublabel:
-                  "Optional. Static suffix appended after the field value. Example: 'invoices'",
+                  "Optional. Statischer Suffix, der nach dem Feldwert angeh\u00e4ngt wird. Beispiel: 'invoices'.",
+                showIf: { mode: "from_field" },
               }),
               new Field({
                 name: "show_hidden",
@@ -122,22 +134,58 @@ async function get_state_fields() {
   return [];
 }
 
+/**
+ * Compose the start path (relative to the plugin base_path) from three
+ * optional parts:
+ *   1. `view_base_path`  — static, per-view prefix
+ *   2. row field value    — only in "from_field" mode
+ *   3. `extra_subpath`   — static suffix, only in "from_field" mode
+ *
+ * Empty parts are dropped. The final joined path is passed through
+ * sanitizeRelativePath so traversal / absolute paths / backslashes are
+ * rejected consistently.
+ */
 function computeStartPath(configuration, row) {
   const parts = [];
+  if (configuration.view_base_path) {
+    parts.push(String(configuration.view_base_path));
+  }
   if (configuration.mode === "from_field" && configuration.path_field && row) {
     const v = row[configuration.path_field];
     if (v) parts.push(String(v));
   }
-  if (configuration.extra_subpath) parts.push(String(configuration.extra_subpath));
-  return sanitizeRelativePath(parts.join("/"));
+  if (
+    configuration.mode === "from_field" &&
+    configuration.extra_subpath
+  ) {
+    parts.push(String(configuration.extra_subpath));
+  }
+  const joined = parts
+    .map((p) => p.replace(/^\/+|\/+$/g, ""))
+    .filter(Boolean)
+    .join("/");
+  return sanitizeRelativePath(joined);
 }
 
 // ---------------------------------------------------------------------------
 // Shell renderer
 // ---------------------------------------------------------------------------
 
-function renderShell(startPath, configuration, pluginVersion, csrfToken) {
+/**
+ * Serialisiert den i18n-Katalog inline in die Seite. Alternative w\u00e4re ein
+ * zus\u00e4tzlicher HTTP-Roundtrip auf /samba-i18n.json — inline spart einen
+ * Request und rendert die Oberfl\u00e4che ohne Aufblitzen englischer Keys.
+ * `</script>` wird escaped, damit das JSON-Blob den HTML-Parser nicht t\u00f6tet.
+ */
+function serialiseCatalog(catalog) {
+  return JSON.stringify(catalog || {}).replace(/</g, "\\u003c");
+}
+
+function renderShell(startPath, configuration, pluginVersion, csrfToken, locale, catalog) {
   const id = "samba-fm-" + Math.random().toString(36).slice(2, 10);
+  // Panel-Titel: wenn der User keinen eigenen Titel gesetzt hat, greift die
+  // \u00fcbersetzte Default-Bezeichnung aus dem i18n-Katalog.
+  const defaultTitle = (catalog && catalog["fm.title_default"]) || "Samba files";
   const opts = {
     startPath,
     showHidden: !!configuration.show_hidden,
@@ -145,10 +193,16 @@ function renderShell(startPath, configuration, pluginVersion, csrfToken) {
     pdfInline: configuration.pdf_inline !== false,
     exposeSmbLink: configuration.expose_smb_link !== false,
     pageSize: Number(configuration.page_size) || 0,
-    title: configuration.title || "Samba files",
+    title: configuration.title || defaultTitle,
     csrfToken: csrfToken || "",
+    locale: locale || "en",
   };
 
+  // Zwei-Stufen-Bootstrap:
+  //   1. samba-common.js laden (SambaCommon global) und Katalog setzen
+  //   2. samba-filemanager.js laden und mounten
+  // Wenn beide Skripte bereits geladen sind, wird nur remounted.
+  const catalogJson = serialiseCatalog(catalog);
   return (
     div(
       { class: "samba-fm card" },
@@ -167,14 +221,23 @@ function renderShell(startPath, configuration, pluginVersion, csrfToken) {
     ) +
     script(
       `(function(){
-         function boot(){window.saltcornSambaMountFM && window.saltcornSambaMountFM(${JSON.stringify(
+         var CATALOG=${catalogJson};
+         function applyCatalog(){ if(window.SambaCommon && window.SambaCommon.setCatalog) window.SambaCommon.setCatalog(CATALOG); }
+         function mount(){window.saltcornSambaMountFM && window.saltcornSambaMountFM(${JSON.stringify(
            id
          )}, ${JSON.stringify(opts)});}
-         if(window.saltcornSambaMountFM){boot();return;}
-         var s=document.createElement('script');
-         s.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-filemanager.js';
-         s.onload=boot;
-         document.head.appendChild(s);
+         function loadFM(){
+           if(window.saltcornSambaMountFM){ mount(); return; }
+           var s=document.createElement('script');
+           s.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-filemanager.js';
+           s.onload=mount;
+           document.head.appendChild(s);
+         }
+         if(window.SambaCommon){ applyCatalog(); loadFM(); return; }
+         var c=document.createElement('script');
+         c.src='/plugins/public/saltcorn-samba@${pluginVersion}/samba-common.js';
+         c.onload=function(){ applyCatalog(); loadFM(); };
+         document.head.appendChild(c);
        })();`
     )
   );
@@ -196,9 +259,21 @@ function extractCsrf(extra) {
   return "";
 }
 
+/**
+ * Liest die vom Nutzer bevorzugte Sprache aus dem Request (Saltcorn setzt
+ * das aus Login-Cookie / Accept-Language) und liefert Locale + Katalog. Bei
+ * Ausfall greift `en` als Notnagel – hardgecodete Strings werden nie leer.
+ */
+function resolveLocaleAndCatalog(extra) {
+  const req = extra && extra.req;
+  const locale = resolveLocaleFromReq(req);
+  return { locale, catalog: catalogFor(locale) };
+}
+
 async function run(table_id, viewname, configuration, state, extra) {
   const pluginVersion = configuration.__pluginVersion || "0.3.0";
   const csrf = extractCsrf(extra);
+  const { locale, catalog } = resolveLocaleAndCatalog(extra);
   let row = extra && extra.row;
   if (!row && configuration.mode === "from_field" && table_id) {
     const table = await Table.findOne({ id: table_id });
@@ -216,12 +291,13 @@ async function run(table_id, viewname, configuration, state, extra) {
   } catch (e) {
     return div({ class: "alert alert-danger" }, "Samba file manager: " + e.message);
   }
-  return renderShell(startPath, configuration, pluginVersion, csrf);
+  return renderShell(startPath, configuration, pluginVersion, csrf, locale, catalog);
 }
 
 async function runMany(table_id, viewname, configuration, state, extra) {
   const pluginVersion = configuration.__pluginVersion || "0.3.0";
   const csrf = extractCsrf(extra);
+  const { locale, catalog } = resolveLocaleAndCatalog(extra);
   const rows = (extra && extra.rows) || [];
   return rows.map((row) => {
     let startPath = "";
@@ -231,7 +307,7 @@ async function runMany(table_id, viewname, configuration, state, extra) {
       startPath = "";
     }
     return {
-      html: renderShell(startPath, configuration, pluginVersion, csrf),
+      html: renderShell(startPath, configuration, pluginVersion, csrf, locale, catalog),
       row,
     };
   });

package/i18n/de.json

@@ -0,0 +1,93 @@
+{
+  "$meta": {
+    "language": "Deutsch",
+    "locale": "de",
+    "note": "Übersetzungskatalog für saltcorn-samba. Punkt-Notation gruppiert nach Bereich."
+  },
+
+  "ui.loading": "Lädt …",
+  "ui.close": "Schließen",
+  "ui.cancel": "Abbrechen",
+  "ui.confirm": "OK",
+  "ui.error": "Fehler",
+  "ui.empty": "(leeres Verzeichnis)",
+  "ui.empty_short": "(leer)",
+  "ui.path": "Pfad:",
+  "ui.show_hidden": "Versteckte Dateien anzeigen",
+  "ui.up": "⬆ Übergeordnet",
+  "ui.up_title": "Ein Verzeichnis nach oben",
+  "ui.home_title": "Zur Wurzel springen",
+  "ui.refresh_title": "Aktualisieren",
+  "ui.page_of": "Seite {page} / {total}",
+  "ui.prev_page": "‹",
+  "ui.next_page": "›",
+
+  "fm.title_default": "Samba-Dateien",
+  "fm.col.filename": "Dateiname",
+  "fm.col.media_type": "MIME-Typ",
+  "fm.col.size": "Größe",
+  "fm.col.modified": "Geändert",
+  "fm.col.actions": "Aktionen",
+  "fm.counter": "{dirs} Ordner · {files} Dateien",
+  "fm.open": "Öffnen",
+  "fm.open_new_tab": "In neuem Tab öffnen",
+  "fm.view": "Anzeigen",
+  "fm.download": "Herunterladen",
+  "fm.rename": "Umbenennen",
+  "fm.rename_title": "Umbenennen",
+  "fm.delete": "Löschen",
+  "fm.delete_title": "Löschen",
+  "fm.smb_link_title": "Im Datei-Manager öffnen (Nemo/Nautilus/Explorer)",
+  "fm.upload": "⬆ Hochladen",
+  "fm.upload_title": "Dateien in dieses Verzeichnis hochladen",
+  "fm.new_folder": "+ Ordner",
+  "fm.new_folder_title": "Neuen Ordner anlegen",
+
+  "fm.confirm_delete.title": "Löschen bestätigen",
+  "fm.confirm_delete.prompt_prefix": "„",
+  "fm.confirm_delete.prompt_suffix": "\" wirklich löschen?",
+  "fm.confirm_delete.dir_hint": "Klappt nur, wenn das Verzeichnis leer ist.",
+  "fm.confirm_delete.file_hint": "Dieser Vorgang kann nicht rückgängig gemacht werden.",
+  "fm.deleted_ok": "„{name}\" gelöscht",
+  "fm.deleted_fail": "Löschen fehlgeschlagen: {msg}",
+
+  "fm.rename.title": "„{name}\" umbenennen",
+  "fm.rename.label": "Neuer Name",
+  "fm.rename.hint": "Slashes sind nicht erlaubt. Zum Verschieben stattdessen die ↗-Funktion nutzen.",
+  "fm.renamed_ok": "Umbenannt in „{name}\"",
+  "fm.rename_fail": "Umbenennen fehlgeschlagen: {msg}",
+
+  "fm.mkdir.title": "Ordner anlegen in {path}",
+  "fm.mkdir.label": "Ordnername",
+  "fm.mkdir.placeholder": "Neuer Ordnername",
+  "fm.mkdir.create": "Anlegen",
+  "fm.mkdir_ok": "Ordner „{name}\" angelegt",
+  "fm.mkdir_fail": "Ordner anlegen fehlgeschlagen: {msg}",
+
+  "fm.upload.title": "Dateien hochladen",
+  "fm.upload.dropzone": "Dateien hierher ziehen oder klicken zum Auswählen",
+  "fm.upload.into_prefix": "Ziel: ",
+  "fm.upload.limit": ". Max. {mb} MiB pro Datei.",
+  "fm.upload.or_pick": "…oder Dateien auswählen",
+  "fm.upload.overwrite": "Vorhandene Dateien überschreiben",
+  "fm.upload.button": "Hochladen",
+  "fm.upload.uploading": "Wird hochgeladen …",
+  "fm.upload.no_files": "Keine Dateien ausgewählt",
+  "fm.upload.ok": "{n} Datei(en) hochgeladen",
+  "fm.upload.partial_summary": "{ok} von {total} Dateien hochgeladen. Fehler:",
+  "fm.upload.some_failed": "Einige Uploads fehlgeschlagen",
+  "fm.upload.failed": "Upload fehlgeschlagen: {msg}",
+  "fm.upload.failed_short": "Upload fehlgeschlagen",
+
+  "tree.open_in_fm": "Im Datei-Manager öffnen",
+  "tree.open_in_fm_title": "Im Datei-Manager öffnen",
+  "tree.error_prefix": "Fehler: ",
+  "tree.samba_prefix": "Samba: ",
+  "tree.open_new_tab": "In neuem Tab öffnen",
+
+  "pdf.download": "Herunterladen",
+  "pdf.open_in_fm": "Im Datei-Manager öffnen",
+  "pdf.open_in_fm_title": "In Nemo/Nautilus/Explorer öffnen",
+  "pdf.open_new_tab": "In neuem Tab öffnen",
+  "pdf.empty": "—"
+}

package/i18n/en.json

@@ -0,0 +1,93 @@
+{
+  "$meta": {
+    "language": "English",
+    "locale": "en",
+    "note": "Translation catalogue for saltcorn-samba. Dot notation groups keys by area."
+  },
+
+  "ui.loading": "Loading…",
+  "ui.close": "Close",
+  "ui.cancel": "Cancel",
+  "ui.confirm": "OK",
+  "ui.error": "Error",
+  "ui.empty": "(empty directory)",
+  "ui.empty_short": "(empty)",
+  "ui.path": "Path:",
+  "ui.show_hidden": "Show hidden",
+  "ui.up": "⬆ Up",
+  "ui.up_title": "Up one directory",
+  "ui.home_title": "Go to root",
+  "ui.refresh_title": "Refresh",
+  "ui.page_of": "Page {page} / {total}",
+  "ui.prev_page": "‹",
+  "ui.next_page": "›",
+
+  "fm.title_default": "Samba files",
+  "fm.col.filename": "Filename",
+  "fm.col.media_type": "Media type",
+  "fm.col.size": "Size",
+  "fm.col.modified": "Modified",
+  "fm.col.actions": "Actions",
+  "fm.counter": "{dirs} folders · {files} files",
+  "fm.open": "Open",
+  "fm.open_new_tab": "Open in new tab",
+  "fm.view": "View",
+  "fm.download": "Download",
+  "fm.rename": "Rename",
+  "fm.rename_title": "Rename",
+  "fm.delete": "Delete",
+  "fm.delete_title": "Delete",
+  "fm.smb_link_title": "Open in file manager (Nemo/Nautilus/Explorer)",
+  "fm.upload": "⬆ Upload",
+  "fm.upload_title": "Upload files to this directory",
+  "fm.new_folder": "+ Folder",
+  "fm.new_folder_title": "Create new folder",
+
+  "fm.confirm_delete.title": "Confirm delete",
+  "fm.confirm_delete.prompt_prefix": "Delete \"",
+  "fm.confirm_delete.prompt_suffix": "\"?",
+  "fm.confirm_delete.dir_hint": "This will only succeed if the directory is empty.",
+  "fm.confirm_delete.file_hint": "This action cannot be undone.",
+  "fm.deleted_ok": "Deleted {name}",
+  "fm.deleted_fail": "Delete failed: {msg}",
+
+  "fm.rename.title": "Rename \"{name}\"",
+  "fm.rename.label": "New name",
+  "fm.rename.hint": "Slashes are not allowed. To move, use the ↗ file-manager link instead.",
+  "fm.renamed_ok": "Renamed to {name}",
+  "fm.rename_fail": "Rename failed: {msg}",
+
+  "fm.mkdir.title": "Create folder in {path}",
+  "fm.mkdir.label": "Folder name",
+  "fm.mkdir.placeholder": "New folder name",
+  "fm.mkdir.create": "Create",
+  "fm.mkdir_ok": "Created folder {name}",
+  "fm.mkdir_fail": "Create folder failed: {msg}",
+
+  "fm.upload.title": "Upload files",
+  "fm.upload.dropzone": "Drop files here or click to select",
+  "fm.upload.into_prefix": "Uploading to ",
+  "fm.upload.limit": ". Max {mb} MiB per file.",
+  "fm.upload.or_pick": "…or pick files",
+  "fm.upload.overwrite": "Overwrite existing files",
+  "fm.upload.button": "Upload",
+  "fm.upload.uploading": "Uploading…",
+  "fm.upload.no_files": "No files selected",
+  "fm.upload.ok": "Uploaded {n} file(s)",
+  "fm.upload.partial_summary": "Uploaded {ok} / {total} files. Failures:",
+  "fm.upload.some_failed": "Some uploads failed",
+  "fm.upload.failed": "Upload failed: {msg}",
+  "fm.upload.failed_short": "Upload failed",
+
+  "tree.open_in_fm": "Open in file manager",
+  "tree.open_in_fm_title": "Open in file manager",
+  "tree.error_prefix": "Error: ",
+  "tree.samba_prefix": "Samba: ",
+  "tree.open_new_tab": "Open in new tab",
+
+  "pdf.download": "Download",
+  "pdf.open_in_fm": "Open in file manager",
+  "pdf.open_in_fm_title": "Open in Nemo/Nautilus/Explorer",
+  "pdf.open_new_tab": "Open in new tab",
+  "pdf.empty": "—"
+}