Fix custom icon endpoint locking on Unraid flash storage

Author: FolderView Plus Test

archive/folderview.plus-2026.04.11.02.txz.sha256

@@ -0,0 +1 @@
+9e78dfac913144b03e796da49d79b81e0168bb768b3a51eb022607c88f027050  folderview.plus-2026.04.14.14.txz

archive/folderview.plus-2026.04.11.03.txz.sha256

@@ -0,0 +1 @@
+3543a28255e17209ae7525d232318aa05508a49d23011b510193abc0b574c051  folderview.plus-2026.04.14.15.txz

archive/folderview.plus-2026.04.11.03.txz archive/folderview.plus-2026.04.14.14.txzarchive/folderview.plus-2026.04.11.03.txz renamed to archive/folderview.plus-2026.04.14.14.txz

@@ -0,0 +1,3 @@
+###2026.04.14.14
+- Fix: Custom icon manager requests now keep their lock file under `/tmp` instead of the flash-backed icon storage path.
+- Fix: Custom icon list, stats, and usage reads now use shared locks so the manager can load reliably on Unraid.

archive/folderview.plus-2026.04.14.14.txz.sha256

@@ -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.14.13">
-<!ENTITY md5 "07376d047fc962390c36ae7661cd5085">
+<!ENTITY version "2026.04.14.15">
+<!ENTITY md5 "fe4f555eb370a953b773daedc4949ad6">
 ]>
 
 <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.14.15
+- UX: Icon picker, bundled icon packs, and custom icon management.
+- Docs: Project documentation and support guidance.
+
+
 ###2026.04.14.13
 - UX: Folder editor flows, previews, and bootstrap behavior.
 - UX: Icon picker, bundled icon packs, and custom icon management.

archive/folderview.plus-2026.04.11.02.txz archive/folderview.plus-2026.04.14.15.txzarchive/folderview.plus-2026.04.11.02.txz renamed to archive/folderview.plus-2026.04.14.15.txz

@@ -114,7 +114,15 @@ function customIconDirectoryHealth(): array {
 }
 
 function customIconLockPath(): string {
-    return customIconDirPath() . '/.upload.lock';
+    $tmpRoot = function_exists('sys_get_temp_dir') ? trim((string)sys_get_temp_dir()) : '/tmp';
+    if ($tmpRoot === '') {
+        $tmpRoot = '/tmp';
+    }
+    $normalized = rtrim(str_replace('\\', '/', $tmpRoot), '/');
+    if ($normalized === '') {
+        $normalized = '/tmp';
+    }
+    return $normalized . '/folderview.plus-custom-icons.lock';
 }
 
 function withCustomIconLock(bool $exclusive, callable $callback) {
@@ -1326,7 +1334,7 @@ function handleCustomIconUploadAction(): array {
 }
 
 function handleCustomIconListAction(): array {
-    return withCustomIconLock(true, static function (): array {
+    return withCustomIconLock(false, static function (): array {
         $customDir = ensureCustomIconDirExists(false);
         $search = trim((string)($_REQUEST['query'] ?? ''));
         $sort = trim((string)($_REQUEST['sort'] ?? 'newest'));
@@ -1341,7 +1349,7 @@ function handleCustomIconListAction(): array {
 }
 
 function handleCustomIconStatsAction(): array {
-    return withCustomIconLock(true, static function (): array {
+    return withCustomIconLock(false, static function (): array {
         $customDir = ensureCustomIconDirExists(false);
         syncCustomIconMetadataIndex($customDir);
         $usageMap = customIconUsageMap();
@@ -1441,7 +1449,7 @@ function handleCustomIconRenameAction(): array {
 }
 
 function handleCustomIconUsageAction(): array {
-    return withCustomIconLock(true, static function (): array {
+    return withCustomIconLock(false, static function (): array {
         $name = normalizeCustomIconFileNameInput((string)($_REQUEST['name'] ?? ''));
         $usageMap = customIconUsageMap();
         $refs = is_array($usageMap[$name] ?? null) ? array_values($usageMap[$name]) : [];

archive/folderview.plus-2026.04.14.15.txz.sha256

@@ -134,13 +134,23 @@ test('upload endpoint stores metadata and supports dedupe or replace flows', ()
 test('upload endpoint includes self-heal directory checks and fix hints', () => {
     assert.match(uploadPhp, /function customIconDirectoryHealth\s*\(/);
     assert.match(uploadPhp, /function customIconRepairHintCommand\s*\(/);
+    assert.match(uploadPhp, /function customIconLockPath\(\): string/);
+    assert.match(uploadPhp, /sys_get_temp_dir/);
+    assert.match(uploadPhp, /return \$normalized \. '\/folderview\.plus-custom-icons\.lock';/);
     assert.match(uploadPhp, /'runtimePath'\s*=>\s*\$runtimePath/);
     assert.match(uploadPhp, /'publicMode'\s*=>\s*\(string\)\(\$health\['publicMode'\] \?\? 'missing'\)/);
     assert.match(uploadPhp, /'migratedFileCount'\s*=>\s*max\(0,\s*\(int\)\(\$health\['migratedFileCount'\] \?\? 0\)\)/);
     assert.match(uploadPhp, /fvplusEnsureCustomIconStorageReady\(false\)/);
     assert.match(uploadPhp, /repairHint/);
 });
 
+test('upload endpoint uses shared locks for read-only custom icon actions and tmp-backed lock storage', () => {
+    assert.match(uploadPhp, /function handleCustomIconListAction\(\): array \{[\s\S]*?withCustomIconLock\(false,/);
+    assert.match(uploadPhp, /function handleCustomIconStatsAction\(\): array \{[\s\S]*?withCustomIconLock\(false,/);
+    assert.match(uploadPhp, /function handleCustomIconUsageAction\(\): array \{[\s\S]*?withCustomIconLock\(false,/);
+    assert.match(uploadPhp, /function handleCustomIconUploadAction\(\): array \{[\s\S]*?withCustomIconLock\(true,/);
+});
+
 test('upload and third-party endpoints share the same icon extension allowlist', () => {
     const thirdPartyExt = parsePhpStringArray(thirdPartyPhp, 'FVPLUS_THIRD_PARTY_ICON_EXTENSIONS');
     const uploadExt = parsePhpStringArray(uploadPhp, 'FVPLUS_CUSTOM_ICON_EXTENSIONS');