Deep-link folder editor rules workspace

Author: FolderView Plus Test

archive/folderview.plus-2026.04.15.19.txz.sha256

@@ -0,0 +1 @@
+dd432c39770d796457b0ed7882dbdde852665034312a39b8a593730237de1057  folderview.plus-2026.04.17.02.txz

archive/folderview.plus-2026.04.15.19.txz archive/folderview.plus-2026.04.17.02.txzarchive/folderview.plus-2026.04.15.19.txz renamed to archive/folderview.plus-2026.04.17.02.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.17.01">
-<!ENTITY md5 "610fc9335e10973e0401c1bf032b0b02">
+<!ENTITY version "2026.04.17.02">
+<!ENTITY md5 "77edaa4af1469bc0165406b021449844">
 ]>
 
 <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.17.02
+- Fix: Folder editor Rules tab now opens Settings directly into Advanced > Rules > Auto-assignment instead of restoring the last basic tab.
+- UX: Settings bootstrap now honors explicit launch overrides for advanced tab, target section, and Docker or VM rules workspace source.
+
+
 ###2026.04.17.01
 - UX: Folder editor flows, previews, and bootstrap behavior.
 - Refactor: Shared runtime contracts, request plumbing, and cross-page foundations.

archive/folderview.plus-2026.04.17.02.txz.sha256

@@ -62,6 +62,7 @@
         const rulePatternPlaceholders = rawRulesConfig.patternPlaceholders && typeof rawRulesConfig.patternPlaceholders === 'object'
             ? rawRulesConfig.patternPlaceholders
             : defaultRulesConfig.patternPlaceholders;
+        const fullRulesWorkspaceHref = `/Settings/FolderViewPlus?fvMode=advanced&fvAdvancedTab=rules&fvSection=auto-assignment&fvRulesType=${encodeURIComponent(type)}`;
 
         let folderEditorPrefs = normalizePrefs({});
         let folderEditorPrefsLoaded = false;
@@ -347,7 +348,7 @@
                                 <strong>Rules targeting this folder</strong>
                                 <span>Create regex-based plugin rules directly from the folder editor without leaving this page.</span>
                             </div>
-                            <a class="fv-folder-auto-rules-link" href="/Settings/FolderViewPlus">Open full Rules workspace</a>
+                            <a class="fv-folder-auto-rules-link" href="${escapeHtml(fullRulesWorkspaceHref)}">Open full Rules workspace</a>
                         </div>
                         ${buildFolderAutoRulesPanelStatusHtml()}
                         ${bodyHtml}

folderview.plus.plg

@@ -1150,6 +1150,33 @@ const normalizeAdvancedGroup = (value) => (
         : 'operations'
 );
 
+const readSettingsLaunchOverrides = () => {
+    if (typeof URLSearchParams === 'undefined' || !window?.location) {
+        return null;
+    }
+    const params = new URLSearchParams(window.location.search || '');
+    const modeRaw = String(params.get('fvMode') || '').trim().toLowerCase();
+    const advancedTabRaw = String(params.get('fvAdvancedTab') || '').trim().toLowerCase();
+    const sectionKey = String(params.get('fvSection') || '').trim().toLowerCase();
+    const rulesTypeRaw = String(params.get('fvRulesType') || '').trim().toLowerCase();
+    const overrides = {};
+    if (modeRaw === 'advanced' || modeRaw === 'basic') {
+        overrides.mode = modeRaw;
+    }
+    if (ADVANCED_GROUPS.includes(advancedTabRaw)) {
+        overrides.advancedTab = advancedTabRaw;
+    }
+    if (sectionKey) {
+        overrides.sectionKey = sectionKey;
+    }
+    if (rulesTypeRaw === 'docker' || rulesTypeRaw === 'vm') {
+        overrides.rulesType = rulesTypeRaw;
+    }
+    return Object.keys(overrides).length > 0 ? overrides : null;
+};
+
+const settingsLaunchOverrides = readSettingsLaunchOverrides();
+
 const normalizeAdvancedSearchMap = (value) => {
     const source = value && typeof value === 'object' ? value : {};
     const next = {};
@@ -1335,6 +1362,28 @@ const setAdvancedTab = (tab, persist = true) => {
     }
 };
 
+const applySettingsLaunchOverrides = ({ persist = false } = {}) => {
+    if (!settingsLaunchOverrides) {
+        return false;
+    }
+    if (settingsLaunchOverrides.mode === 'advanced' || settingsLaunchOverrides.mode === 'basic') {
+        settingsUiState.mode = settingsLaunchOverrides.mode;
+    }
+    if (settingsLaunchOverrides.advancedTab) {
+        setAdvancedTab(settingsLaunchOverrides.advancedTab, persist);
+    }
+    if (settingsLaunchOverrides.sectionKey) {
+        settingsUiState.activeSectionKey = settingsLaunchOverrides.sectionKey;
+    }
+    if (settingsLaunchOverrides.rulesType) {
+        activeRulesWorkspaceType = normalizeRulesWorkspaceType(settingsLaunchOverrides.rulesType);
+        if (persist) {
+            writeSettingsStorage(RULES_WORKSPACE_STORAGE_KEY, activeRulesWorkspaceType, { delayMs: 60, idle: true });
+        }
+    }
+    return true;
+};
+
 const captureSettingsBaseline = () => {
     if (dirtyTracker && typeof dirtyTracker.captureBaseline === 'function') {
         dirtyTracker.captureBaseline(
@@ -9240,6 +9289,7 @@ settingsActionSupportModule.registerWindowActions(window, {
                 settingsUiState.knownAdvancedSections = new Set();
             }
             restoreTableUiState();
+            applySettingsLaunchOverrides({ persist: false });
         });
         await withFatalBannerPhase({
             phase: 'bootstrap-ui',
@@ -9298,14 +9348,19 @@ settingsActionSupportModule.registerWindowActions(window, {
             const storedMode = String(localStorage.getItem(UI_MODE_STORAGE_KEY) || '').trim();
             const hasLocalModePreference = storedMode === 'advanced' || storedMode === 'basic';
             const serverMode = getServerSettingsMode();
-            if (!hasLocalModePreference && serverMode) {
+            if (!hasLocalModePreference && serverMode && !settingsLaunchOverrides?.mode) {
                 settingsUiState.mode = serverMode;
             }
             refreshSettingsUx();
             captureSettingsBaseline();
             if (settingsUiState.mode) {
                 setSettingsMode(settingsUiState.mode);
             }
+            if (settingsLaunchOverrides?.sectionKey) {
+                window.requestAnimationFrame(() => {
+                    scrollToSectionKey(settingsLaunchOverrides.sectionKey);
+                });
+            }
             if (hasLocalModePreference && serverMode && serverMode !== settingsUiState.mode) {
                 void persistSetupPrefsToServer({ mode: settingsUiState.mode });
             }
@@ -9355,4 +9410,3 @@ settingsActionSupportModule.registerWindowActions(window, {
 })();
 
 
-

src/folderview.plus/usr/local/emhttp/plugins/folderview.plus/scripts/folder.editor.rules.js

@@ -158,6 +158,17 @@ test('settings page exposes theme fallback controls and runtime self-heal action
     assert.match(libPrefsPhp, /function normalizeRuntimePageViewMode\(\$value\): string \{[\s\S]*\['folderview', 'host', 'command', 'tree-explorer'\]/);
 });
 
+test('settings runtime honors explicit launch overrides for advanced rules workspace deep links', () => {
+    assert.match(script, /const readSettingsLaunchOverrides = \(\) => \{/);
+    assert.match(script, /const params = new URLSearchParams\(window\.location\.search \|\| ''\);/);
+    assert.match(script, /const settingsLaunchOverrides = readSettingsLaunchOverrides\(\);/);
+    assert.match(script, /const applySettingsLaunchOverrides = \(\{ persist = false \} = \{\}\) => \{/);
+    assert.match(script, /activeRulesWorkspaceType = normalizeRulesWorkspaceType\(settingsLaunchOverrides\.rulesType\);/);
+    assert.match(script, /applySettingsLaunchOverrides\(\{ persist: false \}\);/);
+    assert.match(script, /if \(!hasLocalModePreference && serverMode && !settingsLaunchOverrides\?\.mode\) \{/);
+    assert.match(script, /window\.requestAnimationFrame\(\(\) => \{\s*scrollToSectionKey\(settingsLaunchOverrides\.sectionKey\);\s*\}\);/);
+});
+
 test('backup endpoint supports scheduler and rollback actions', () => {
     assert.match(backupPhp, /action\s*===\s*'run_schedule'/);
     assert.match(backupPhp, /runScheduledBackups/);
@@ -444,7 +455,7 @@ test('settings mode switches persist the user basic or advanced view choice', ()
     assert.match(script, /if \(persistServer === true && previousMode !== settingsUiState\.mode\) \{\s*void persistSetupPrefsToServer\(\{ mode: settingsUiState\.mode \}\);\s*\}/);
     assert.match(script, /const storedMode = String\(localStorage\.getItem\(UI_MODE_STORAGE_KEY\) \|\| ''\)\.trim\(\);/);
     assert.match(script, /const hasLocalModePreference = storedMode === 'advanced' \|\| storedMode === 'basic';/);
-    assert.match(script, /if \(!hasLocalModePreference && serverMode\) \{\s*settingsUiState\.mode = serverMode;\s*\}/);
+    assert.match(script, /if \(!hasLocalModePreference && serverMode && !settingsLaunchOverrides\?\.mode\) \{\s*settingsUiState\.mode = serverMode;\s*\}/);
     assert.match(script, /if \(hasLocalModePreference && serverMode && serverMode !== settingsUiState\.mode\) \{\s*void persistSetupPrefsToServer\(\{ mode: settingsUiState\.mode \}\);\s*\}/);
     assert.match(script, /setSettingsMode\(mode, \{ persistServer: true \}\);/);
     assert.match(script, /setSettingsMode\('basic', \{ persistServer: true \}\);/);

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

@@ -594,12 +594,12 @@ test('folder editor exposes folder-scoped advanced auto-rules for saved folders'
     assert.match(folderRulesJs, /panel\.className = 'basic fv-modern-field-row is-rules-row fv-folder-auto-rules-panel';/);
     assert.match(folderRulesJs, /Save this folder first to create advanced rules\./);
     assert.match(folderRulesJs, /Open full Rules workspace/);
+    assert.match(folderRulesJs, /const fullRulesWorkspaceHref = `\/Settings\/FolderViewPlus\?fvMode=advanced&fvAdvancedTab=rules&fvSection=auto-assignment&fvRulesType=\$\{encodeURIComponent\(type\)\}`;/);
     assert.match(folderRulesJs, /Create regex-based plugin rules directly from the folder editor without leaving this page\./);
     assert.match(folderRulesJs, /<dt>Advanced auto-rules:<\/dt>/);
     assert.match(folderRulesJs, /<blockquote class="inline_help">/);
     assert.match(folderRulesJs, /\/plugins\/folderview\.plus\/server\/prefs\.php\?type=\$\{encodeURIComponent\(type\)\}/);
     assert.match(folderRulesJs, /requestClient\.postJson\('\/plugins\/folderview\.plus\/server\/prefs\.php'/);
-    assert.match(folderRulesJs, /href="\/Settings\/FolderViewPlus"/);
     assert.match(folderPage, /'\/plugins\/folderview\.plus\/scripts\/folder\.editor\.rules\.js'/);
     assert.match(folderCss, /#fvFolderAutoRulesPanel\.fv-folder-auto-rules-panel/);
     assert.match(folderCss, /#fvFolderAutoRulesPanel\.fv-folder-auto-rules-panel > dl > dd/);