Add Docker runtime privacy toggle

Author: Alexander Phillips

archive/folderview.plus-2026.04.12.05.txz.sha256

@@ -0,0 +1 @@
+ad55e176682f07eaaf44b33b2e1d71561ca399fe3db3002aed508dff72786c18  folderview.plus-2026.04.15.07.txz

archive/folderview.plus-2026.04.12.05.txz archive/folderview.plus-2026.04.15.07.txzarchive/folderview.plus-2026.04.12.05.txz renamed to archive/folderview.plus-2026.04.15.07.txz

@@ -6,13 +6,18 @@
 <!ENTITY launch "Settings/FolderViewPlus">
 <!ENTITY plugdir "/usr/local/emhttp/plugins/&name;">
 <!ENTITY pluginURL "https://raw.githubusercontent.com/&github;/dev/folderview.plus.plg">
-<!ENTITY version "2026.04.15.06">
-<!ENTITY md5 "e132c9cd5f7364a247ccf100e3f79f5f">
+<!ENTITY version "2026.04.15.07">
+<!ENTITY md5 "9e0a0e51ea0e0c8ecbba8d5ef8471aef">
 ]>
 
 <PLUGIN name="&name;" author="&author;" version="&version;" launch="&launch;" pluginURL="&pluginURL;" icon="folder-icon.png" support="https://forums.unraid.net/topic/197631-plugin-folderview-plus/" min="7.0.0">
     <CHANGES>
 
+###2026.04.15.07
+- Feature: Add a Docker runtime privacy toggle beside the Basic view switch.
+- Privacy: Persist Docker blur mode directly from the Docker tab and keep the runtime toggle in sync after host re-renders.
+
+
 ###2026.04.15.06
 - Fix: Docker support-bundle snapshots, trace storage caps, and rendered-state diagnostics.
 - Fix: Docker runtime rows, folder state, and container interactions.

archive/folderview.plus-2026.04.15.07.txz.sha256

@@ -2956,6 +2956,213 @@ const syncDockerVisibleFoldersFromRuntimeCache = () => {
 };
 
 const readDockerListViewMode = () => ($.cookie('docker_listview_mode') == 'advanced' ? 'advanced' : 'basic');
+const DOCKER_RUNTIME_PRIVACY_TOGGLE_ID = 'fvplus-docker-runtime-privacy-toggle';
+const DOCKER_RUNTIME_PRIVACY_TOGGLE_SHELL_ID = 'fvplus-docker-runtime-privacy-shell';
+const DOCKER_RUNTIME_PRIVACY_TOGGLE_FALLBACK_HOST_ID = 'fvplus-docker-runtime-toolbar-controls';
+let dockerRuntimePrivacyToggleMountQueued = false;
+
+const readDockerRuntimePrivacyMode = () => utils.normalizePrefs(folderTypePrefs || {}).dashboard?.privacyMode === true;
+
+const buildDockerRuntimePrivacyPrefsPayload = (enabled) => {
+    const current = utils.normalizePrefs(folderTypePrefs || {});
+    return utils.normalizePrefs({
+        ...current,
+        dashboard: {
+            ...(current.dashboard || {}),
+            privacyMode: enabled === true
+        }
+    });
+};
+
+const persistDockerRuntimePrivacyMode = async (enabled) => {
+    const nextPrefs = buildDockerRuntimePrivacyPrefsPayload(enabled);
+    const payload = {
+        type: 'docker',
+        prefs: JSON.stringify({
+            dashboard: nextPrefs.dashboard
+        })
+    };
+    const request = window.FolderViewPlusRequest;
+    if (request && typeof request.postJson === 'function') {
+        try {
+            return await request.postJson('/plugins/folderview.plus/server/prefs.php', payload, {
+                retries: 1,
+                retryDelayMs: 260
+            });
+        } catch (_error) {
+            // Fall through to the legacy POST path so the runtime toggle still works
+            // when the request wrapper is late or degraded.
+        }
+    }
+    const response = await $.post('/plugins/folderview.plus/server/prefs.php', payload).promise();
+    return parseJsonPayloadSafe(response);
+};
+
+const findDockerRuntimeListViewToggleAnchor = () => {
+    const table = document.querySelector('table#docker_containers');
+    if (!table) {
+        return null;
+    }
+    const scopes = [
+        table.parentElement,
+        table.parentElement?.parentElement,
+        document.body
+    ].filter(Boolean);
+    const switchSelector = 'input[type="checkbox"], .switch-button, .switch-button-background';
+    for (const scope of scopes) {
+        const candidates = Array.from(scope.querySelectorAll('label, div, span, td, th'));
+        for (const candidate of candidates) {
+            const text = String(candidate.textContent || '').replace(/\s+/g, ' ').trim().toLowerCase();
+            if (!text.includes('basic view')) {
+                continue;
+            }
+            if (candidate.querySelector(switchSelector)) {
+                return candidate;
+            }
+            if (candidate.parentElement && candidate.parentElement.querySelector(switchSelector)) {
+                return candidate.parentElement;
+            }
+        }
+    }
+    return null;
+};
+
+const ensureDockerRuntimePrivacyFallbackHost = () => {
+    const table = document.querySelector('table#docker_containers');
+    const mountRoot = table?.parentElement;
+    if (!mountRoot) {
+        return null;
+    }
+    let host = document.getElementById(DOCKER_RUNTIME_PRIVACY_TOGGLE_FALLBACK_HOST_ID);
+    if (!host) {
+        host = document.createElement('div');
+        host.id = DOCKER_RUNTIME_PRIVACY_TOGGLE_FALLBACK_HOST_ID;
+        host.className = 'fvplus-docker-runtime-toolbar-controls';
+    }
+    if (host.parentElement !== mountRoot) {
+        mountRoot.insertBefore(host, table);
+    } else if (host.nextElementSibling !== table) {
+        mountRoot.insertBefore(host, table);
+    }
+    return host;
+};
+
+const resolveDockerRuntimePrivacyToggleMount = () => {
+    const anchor = findDockerRuntimeListViewToggleAnchor();
+    if (anchor && anchor.parentElement) {
+        return {
+            anchor,
+            host: anchor.parentElement,
+            fallback: false
+        };
+    }
+    const fallbackHost = ensureDockerRuntimePrivacyFallbackHost();
+    if (!fallbackHost) {
+        return null;
+    }
+    return {
+        anchor: null,
+        host: fallbackHost,
+        fallback: true
+    };
+};
+
+const renderDockerRuntimePrivacyToggle = () => {
+    const mount = resolveDockerRuntimePrivacyToggleMount();
+    if (!mount?.host) {
+        return;
+    }
+    let shell = document.getElementById(DOCKER_RUNTIME_PRIVACY_TOGGLE_SHELL_ID);
+    if (shell && shell.parentElement !== mount.host) {
+        shell.remove();
+        shell = null;
+    }
+    if (!shell) {
+        shell = document.createElement('div');
+        shell.id = DOCKER_RUNTIME_PRIVACY_TOGGLE_SHELL_ID;
+    }
+    shell.className = `fvplus-docker-runtime-toggle-shell${mount.fallback ? ' is-fallback' : ''}`;
+    if (mount.anchor) {
+        if (mount.anchor.nextElementSibling !== shell) {
+            mount.anchor.insertAdjacentElement('afterend', shell);
+        }
+    } else if (mount.host.firstElementChild !== shell) {
+        mount.host.insertBefore(shell, mount.host.firstChild);
+    }
+    const enabled = readDockerRuntimePrivacyMode();
+    shell.innerHTML = `
+        <span class="fvplus-docker-runtime-toggle-label">Privacy</span>
+        <input id="${DOCKER_RUNTIME_PRIVACY_TOGGLE_ID}" class="basic-switch fvplus-docker-runtime-privacy-switch" type="checkbox" ${enabled ? 'checked' : ''}>
+    `;
+    const $input = $(`#${DOCKER_RUNTIME_PRIVACY_TOGGLE_ID}`);
+    if (!$input.length) {
+        return;
+    }
+    if (typeof $input.switchButton === 'function') {
+        $input.switchButton({
+            labels_placement: 'right',
+            off_label: $.i18n('off'),
+            on_label: $.i18n('on'),
+            checked: enabled
+        });
+    }
+    $input.off('change.fvDockerRuntimePrivacy').on('change.fvDockerRuntimePrivacy', function onDockerRuntimePrivacyChange() {
+        void setDockerRuntimePrivacyMode($(this).is(':checked'));
+    });
+};
+
+const queueDockerRuntimePrivacyToggleMount = () => {
+    if (dockerRuntimePrivacyToggleMountQueued) {
+        return;
+    }
+    dockerRuntimePrivacyToggleMountQueued = true;
+    const flush = () => {
+        dockerRuntimePrivacyToggleMountQueued = false;
+        renderDockerRuntimePrivacyToggle();
+    };
+    if (typeof window?.requestAnimationFrame === 'function') {
+        window.requestAnimationFrame(flush);
+        return;
+    }
+    setTimeout(flush, 0);
+};
+
+const setDockerRuntimePrivacyMode = async (enabled, options = {}) => {
+    const nextEnabled = enabled === true;
+    const previousPrefs = utils.normalizePrefs(folderTypePrefs || {});
+    const previousEnabled = previousPrefs.dashboard?.privacyMode === true;
+    if (previousEnabled === nextEnabled) {
+        queueDockerRuntimePrivacyToggleMount();
+        return;
+    }
+    folderTypePrefs = buildDockerRuntimePrivacyPrefsPayload(nextEnabled);
+    applyRuntimePrefs(folderTypePrefs);
+    queueDockerRuntimePrivacyToggleMount();
+    if (options.persist === false) {
+        return;
+    }
+    const result = await dockerSafeUiActionRunner.run('docker-runtime-privacy-toggle', async () => {
+        const response = await persistDockerRuntimePrivacyMode(nextEnabled);
+        folderTypePrefs = utils.normalizePrefs(response?.prefs || folderTypePrefs);
+        applyRuntimePrefs(folderTypePrefs);
+        queueDockerRuntimePrivacyToggleMount();
+        return response;
+    }, {
+        userVisible: false
+    });
+    if (!result.ok) {
+        folderTypePrefs = previousPrefs;
+        applyRuntimePrefs(folderTypePrefs);
+        queueDockerRuntimePrivacyToggleMount();
+        swal({
+            title: 'Privacy toggle save failed',
+            text: `${escapeHtml(String(result.error?.message || 'FolderView Plus could not save the Docker privacy toggle.'))}<br>Reverted to the previous state.`,
+            type: 'error',
+            html: true,
+            confirmButtonText: 'OK'
+        });
+    }
+};
 
 const emitDockerListViewModeChange = (mode, source = 'cookie-write') => {
     if (typeof window?.dispatchEvent !== 'function' || typeof window?.CustomEvent !== 'function') {
@@ -3011,10 +3218,12 @@ const syncDockerListViewModeFromCookie = (source = 'passive') => {
         source: String(source || 'passive').trim() || 'passive'
     });
     if (!loadedFolder || !globalFolders || Object.keys(globalFolders).length <= 0) {
+        queueDockerRuntimePrivacyToggleMount();
         return;
     }
     syncDockerVisibleFoldersFromRuntimeCache();
     scheduleDockerRuntimeWidthReflow('listview-mode-change', 12);
+    queueDockerRuntimePrivacyToggleMount();
 };
 
 const startDockerListViewModeObserver = () => {
@@ -5304,6 +5513,7 @@ window.listview = () => {
     } else {
         if (FOLDER_VIEW_DEBUG_MODE) console.log('[FV3_DEBUG] Patched listview: loadedFolder is true. Skipped createFolders.');
     }
+    queueDockerRuntimePrivacyToggleMount();
     queueDockerRuntimeResizerBind();
     if (FOLDER_VIEW_DEBUG_MODE) console.log('[FV3_DEBUG] Patched listview: Exit.');
 };
@@ -5805,6 +6015,7 @@ const applyRuntimePrefs = (prefs) => {
     $('body').toggleClass('fvplus-performance-mode', normalized.performanceMode === true);
     $('body').toggleClass('fvplus-performance-mode-strict', dockerRuntimePerformanceProfile?.strict === true);
     $('body').toggleClass('fvplus-privacy-docker-runtime', normalized?.dashboard?.privacyMode === true);
+    queueDockerRuntimePrivacyToggleMount();
     scheduleLiveRefresh(normalized);
 };
 
@@ -5880,6 +6091,7 @@ bindDockerHostOpenDockerPatch();
 bindDockerUpdateActionClickCapture();
 bindDockerPostUpdateRenderReconcile();
 startDockerListViewModeObserver();
+queueDockerRuntimePrivacyToggleMount();
 
 if (FOLDER_VIEW_DEBUG_MODE) {
     console.log('[FV3_DEBUG] Global variables initialized:', {

folderview.plus.plg

@@ -146,6 +146,36 @@ th.fvplus-runtime-resizable .fvplus-runtime-col-resizer:focus-visible::before {
     white-space: nowrap;
 }
 
+.fvplus-docker-runtime-toolbar-controls {
+    display: flex;
+    justify-content: flex-end;
+    align-items: center;
+    gap: 0.7rem;
+    margin: 0 0 0.45rem 0;
+}
+
+.fvplus-docker-runtime-toggle-shell {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.55rem;
+    margin-left: 0.7rem;
+    white-space: nowrap;
+    vertical-align: middle;
+}
+
+.fvplus-docker-runtime-toggle-shell.is-fallback {
+    margin-left: 0;
+}
+
+.fvplus-docker-runtime-toggle-label {
+    font-size: 0.92rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--fvplus-theme-foreground);
+    opacity: 0.88;
+}
+
 /* --- General Folder Styles --- */
 .hover:hover div.folder-preview div:not(.folder-preview-row):not(.folder-preview-divider) {
     visibility: visible;

src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/scripts/docker.js

@@ -40,6 +40,11 @@ test('settings page exposes docker and vm privacy mode dashboard toggles', () =>
 
 test('privacy mode toggles runtime body classes and ships masking selectors across settings runtime and dashboard surfaces', () => {
     assert.match(dockerJs, /toggleClass\('fvplus-privacy-docker-runtime', normalized\?\.dashboard\?\.privacyMode === true\)/);
+    assert.match(dockerJs, /const DOCKER_RUNTIME_PRIVACY_TOGGLE_ID = 'fvplus-docker-runtime-privacy-toggle';/);
+    assert.match(dockerJs, /const renderDockerRuntimePrivacyToggle = \(\) =>/);
+    assert.match(dockerJs, /const findDockerRuntimeListViewToggleAnchor = \(\) =>/);
+    assert.match(dockerJs, /const setDockerRuntimePrivacyMode = async \(enabled, options = \{\}\) =>/);
+    assert.match(dockerJs, /queueDockerRuntimePrivacyToggleMount\(\);/);
     assert.match(vmJs, /toggleClass\('fvplus-privacy-vm-runtime', normalized\?\.dashboard\?\.privacyMode === true\)/);
     assert.match(dashboardJs, /toggleClass\('fvplus-privacy-docker-dashboard', dockerPrefs\?\.dashboard\?\.privacyMode === true\)/);
     assert.match(dashboardJs, /toggleClass\('fvplus-privacy-vm-dashboard', vmPrefs\?\.dashboard\?\.privacyMode === true\)/);
@@ -49,6 +54,9 @@ test('privacy mode toggles runtime body classes and ships masking selectors acro
     assert.match(settingsCss, /#vm-tree-path-hint/);
     assert.match(settingsCss, /\.bulk-item-name/);
     assert.match(dockerCss, /body\.fvplus-privacy-docker-runtime/);
+    assert.match(dockerCss, /\.fvplus-docker-runtime-toggle-shell/);
+    assert.match(dockerCss, /\.fvplus-docker-runtime-toggle-label/);
+    assert.match(dockerCss, /\.fvplus-docker-runtime-toolbar-controls/);
     assert.match(dockerCss, /\.fv-docker-member-menu-name/);
     assert.match(vmCss, /body\.fvplus-privacy-vm-runtime/);
     assert.match(dashboardCss, /body\.fvplus-privacy-docker-dashboard/);