release(v3.1.0): default language + portal i18n + ffmpeg path config (closes #88, closes #89)

- Admin: add “Default language” setting (used when a user has not chosen a language yet)
- Admin: add optional FFmpeg binary path setting (env FR_FFMPEG_PATH overrides / locks)
- Thumbnails: resolve ffmpeg path from env first, then admin config, then PATH
- Portals: add language selector + apply defaultLanguage from siteConfig on first run
- Portals: fix button styling (accent-aware) + refresh button color (fixes #88)
- i18n: split locales into separate files and add Polish/Russian/Japanese; refresh German strings (fixes #89)
- UI: replace hardcoded upload/login alerts/toasts with i18n keys for better translation coverage

Closes #88
Closes #89

Author: error311

CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## Changes 01/16/2026 (v3.1.0)
+
+`release(v3.1.0): default language + portal i18n + ffmpeg path config (closes #88, closes #89)`
+
+**Commit message**  
+
+```text
+release(v3.1.0): default language + portal i18n + ffmpeg path config (closes #88, closes #89)
+
+- Admin: add “Default language” setting (used when a user has not chosen a language yet)
+- Admin: add optional FFmpeg binary path setting (env FR_FFMPEG_PATH overrides / locks)
+- Thumbnails: resolve ffmpeg path from env first, then admin config, then PATH
+- Portals: add language selector + apply defaultLanguage from siteConfig on first run
+- Portals: fix button styling (accent-aware) + refresh button color (fixes #88)
+- i18n: split locales into separate files and add Polish/Russian/Japanese; refresh German strings (fixes #89)
+- UI: replace hardcoded upload/login alerts/toasts with i18n keys for better translation coverage
+
+Closes #88
+Closes #89
+```
+
+**Added**  
+
+- **Admin setting: Default language**
+  - New `display.defaultLanguage` config surfaced in Admin → Header/File List/Language section.
+  - Used automatically when a user has not chosen a language yet.
+- **Admin setting: FFmpeg binary path (optional)**
+  - New `ffmpegPath` config for video thumbnail generation.
+  - `FR_FFMPEG_PATH` remains the source of truth when set (admin field becomes read-only).
+- **New locales shipped**
+  - **Polish (pl)**, **Russian (ru)**, **Japanese (ja)**, plus **Simplified Chinese (zh-CN)** locale file.
+- **Portal language selector**
+  - Added a language dropdown to both **portal.html** and **portal-login.html**.
+
+**Changed**  
+
+- **FFmpeg resolution order for thumbnails**
+  - `FR_FFMPEG_PATH` → admin `ffmpegPath` → fallback to `ffmpeg` from PATH (and standard locations).
+  - This keeps the Docker image lean while still supporting thumbnails when ffmpeg exists on the host/container.
+- **Portals now inherit default language**
+  - If `localStorage.language` is missing, portals fetch `/api/siteConfig.php` and apply `display.defaultLanguage`.
+- **Translations architecture**
+  - Locales are now maintained in dedicated files under `public/js/i18n/locales/` lazy load instead of a giant embedded map.
+  - Added missing i18n keys for upload flows and admin/pro toasts to reduce English-only strings.
+
+**Fixed**  
+
+- **Portal button styling / colors** (fixes #88)
+  - Portal buttons now use accent-aware classes (`portal-btn-primary` / `portal-btn-outline`) and render correctly across themes.
+- **German translation gaps** (fixes #89)
+  - German strings were refreshed and missing UI keys were added/normalized.
+- **More consistent i18n coverage**
+  - Upload-related toasts and some boot/login alerts now use translation keys instead of hardcoded English.
+
+**Notes**  
+
+- There are still parts of the Admin Panel and some edge UI strings that may fall back to English. This release fixes the reported German issues and adds new locales, but translation coverage will continue to improve over time.
+- If you want video thumbnails in Docker without bundling ffmpeg, mount a host ffmpeg binary or install it in your own derived image and set `FR_FFMPEG_PATH` (or set the path in Admin).
+
+---
+
 ## Changes 01/15/2026 (v3.0.2)
 
 `release(v3.0.2): ffmpeg-backed video thumbnails (Docker) + new thumbnail API (closes #79)`

Dockerfile

@@ -32,21 +32,29 @@ ENV DEBIAN_FRONTEND=noninteractive \
     PERSISTENT_TOKENS_KEY=default_please_change_this_key \
     PUID=99 PGID=100
 
+ARG INSTALL_FFMPEG=0
+ARG INSTALL_CLAMAV=1
+ARG INSTALL_7ZIP=1
+ARG INSTALL_UNAR=1
+ARG INSTALL_SMBCLIENT=1
+
 # Install Apache, PHP, and required extensions
 RUN if [ -f /etc/apt/sources.list.d/ubuntu.sources ]; then \
         sed -i 's/^Components: .*/Components: main universe/' /etc/apt/sources.list.d/ubuntu.sources; \
     fi && \
     apt-get update && \
-    apt-get upgrade -y && \
+    set -eux; \
+    extra_pkgs=""; \
+    if [ "${INSTALL_FFMPEG}" = "1" ]; then extra_pkgs="${extra_pkgs} ffmpeg"; fi; \
+    if [ "${INSTALL_CLAMAV}" = "1" ]; then extra_pkgs="${extra_pkgs} clamav clamav-freshclam"; fi; \
+    if [ "${INSTALL_7ZIP}" = "1" ]; then extra_pkgs="${extra_pkgs} 7zip"; fi; \
+    if [ "${INSTALL_UNAR}" = "1" ]; then extra_pkgs="${extra_pkgs} unar"; fi; \
+    if [ "${INSTALL_SMBCLIENT}" = "1" ]; then extra_pkgs="${extra_pkgs} smbclient"; fi; \
     apt-get install -y --no-install-recommends \
       apache2 \
       php php-json php-curl php-zip php-mbstring php-gd php-xml \
-      ffmpeg \
-      ca-certificates curl git openssl \
-      smbclient \
-      7zip \
-      unar \
-      clamav clamav-freshclam \
+      ca-certificates curl openssl \
+      ${extra_pkgs} \
     && apt-get clean && rm -rf /var/lib/apt/lists/*
 
 # Remap www-data to the PUID/PGID provided for safe bind mounts

public/js/adminFolderAccess.js

@@ -1610,7 +1610,7 @@ async function loadUserGroupsList(useCacheOnly) {
         const nameInput = card.querySelector('input[data-group-field="name"]');
         const name = (nameInput && nameInput.value || '').trim();
         if (!name) {
-          showToast('Enter a group name first.');
+          showToast(t('admin_group_name_required'));
           return;
         }
         await openGroupAclEditor(name);
@@ -1673,7 +1673,7 @@ async function saveUserGroupsFromUI() {
   try {
     const res = await saveAllGroups(groups);
     if (!res.success) {
-      showToast(res.error || 'Error saving groups');
+      showToast(res.error || t('admin_groups_save_error'));
       if (status) {
         status.textContent = 'Error saving groups.';
         status.className = 'small text-danger';
@@ -1686,14 +1686,14 @@ async function saveUserGroupsFromUI() {
       status.textContent = 'Groups saved.';
       status.className = 'small text-success';
     }
-    showToast('Groups saved.');
+    showToast(t('admin_groups_saved'));
   } catch (e) {
     console.error(e);
     if (status) {
       status.textContent = 'Error saving groups.';
       status.className = 'small text-danger';
     }
-    showToast('Error saving groups', 'error');
+    showToast(t('admin_groups_save_error'), 'error');
   }
 }
 
@@ -1791,7 +1791,7 @@ function saveGroupAclFromUI() {
   }
   __groupsCache[groupName].grants = grants;
 
-  showToast('Group folder access updated. Remember to Save groups.');
+  showToast(t('admin_group_access_updated'));
   modal.style.display = 'none';
 }
 

public/js/adminOnlyOffice.js

@@ -424,18 +424,18 @@ function attachOnlyOfficeCspHelper(container) {
     const txt = (cspPre.textContent || '').trim();
     const ok = await copyToClipboard(txt);
     if (ok) {
-      showToast('CSP line copied.');
+      showToast(t('admin_onlyoffice_csp_copied'));
     } else {
       try { selectElementContents(cspPre); } catch (e) { /* ignore */ }
-      const reason = window.isSecureContext ? '' : ' (page is not HTTPS or localhost)';
-      showToast('Copy failed' + reason + '. Press Ctrl/Cmd+C to copy.');
+      const reason = window.isSecureContext ? '' : t('admin_onlyoffice_copy_failed_reason_insecure');
+      showToast(t('admin_onlyoffice_copy_failed', { reason }));
     }
   });
 
   document.getElementById('selectOoCsp')?.addEventListener('click', () => {
     try {
       selectElementContents(cspPre);
-      showToast('Selected — press Ctrl/Cmd+C');
+      showToast(t('admin_onlyoffice_select_prompt'));
     } catch (e) {
       /* ignore */
     }
@@ -535,4 +535,4 @@ export function collectOnlyOfficeSettingsForSave(payload) {
 
   payload.onlyoffice = onlyoffice;
   return payload;
-}
+}