From 9be457f17ff071088bb76ce529242bd1c8d926ca Mon Sep 17 00:00:00 2001
From: Ruben <post@rubensolvang.no>
Date: Sat, 7 Feb 2026 16:12:21 +0100
Subject: [PATCH] Add metadata and config changes to cache invalidation

Improve cache invalidation by including metadata.ini and config file
mtimes in the cache key calculation. This ensures cache entries are
invalidated when either the content file, its metadata, or global
configuration changes.
---
 app/cache.php                       | 31 +++++++++++++++++++----------
 docs/04-development/07-rendering.md |  8 +++++---
 2 files changed, 26 insertions(+), 13 deletions(-)

diff --git a/app/cache.php b/app/cache.php
index e0f2624..c85ca32 100644
--- a/app/cache.php
+++ b/app/cache.php
@@ -1,15 +1,28 @@
 <?php
 
+function buildCacheKey(string $filePath, string $langPrefix = ''): string {
+    $mtime = filemtime($filePath);
+
+    // Include metadata.ini mtime so metadata edits invalidate cache
+    $metadataFile = dirname($filePath) . '/metadata.ini';
+    $metaMtime = file_exists($metadataFile) ? filemtime($metadataFile) : 0;
+
+    // Include global config mtime so config changes invalidate cache
+    $customConfig = __DIR__ . '/../custom/config.ini';
+    $defaultConfig = __DIR__ . '/default/config.ini';
+    $configMtime = file_exists($customConfig) ? filemtime($customConfig) : filemtime($defaultConfig);
+
+    return md5($filePath . $mtime . $metaMtime . $configMtime . $langPrefix);
+}
+
 function getCachedMarkdown(string $filePath, string $langPrefix = ''): ?string {
     $cacheDir = '/tmp/folderweb_cache';
-    $mtime = filemtime($filePath);
-    $cacheKey = md5($filePath . $mtime . $langPrefix);
-    $cachePath = "$cacheDir/$cacheKey";
-    
+    $cachePath = "$cacheDir/" . buildCacheKey($filePath, $langPrefix);
+
     if (file_exists($cachePath)) {
         return file_get_contents($cachePath);
     }
-    
+
     return null;
 }
 
@@ -18,10 +31,8 @@ function setCachedMarkdown(string $filePath, string $html, string $langPrefix =
     if (!is_dir($cacheDir)) {
         mkdir($cacheDir, 0755, true);
     }
-    
-    $mtime = filemtime($filePath);
-    $cacheKey = md5($filePath . $mtime . $langPrefix);
-    $cachePath = "$cacheDir/$cacheKey";
-    
+
+    $cachePath = "$cacheDir/" . buildCacheKey($filePath, $langPrefix);
+
     file_put_contents($cachePath, $html);
 }
diff --git a/docs/04-development/07-rendering.md b/docs/04-development/07-rendering.md
index b2b49d8..c2d1de1 100644
--- a/docs/04-development/07-rendering.md
+++ b/docs/04-development/07-rendering.md
@@ -61,12 +61,14 @@ Feed piggybacks on the existing Markdown cache — no separate feed cache needed
 
 Defined in `app/cache.php`. File-based cache in `/tmp/folderweb_cache/`.
 
-**Cache key:** `md5($filePath . $mtime . $langPrefix)`
+**Cache key:** `md5($filePath . $mtime . $metaMtime . $configMtime . $langPrefix)`
 
-- Invalidates when file is modified (mtime changes)
+- Invalidates when content file is modified (mtime changes)
+- Invalidates when `metadata.ini` in the same directory is modified
+- Invalidates when global config (`custom/config.ini` or `app/default/config.ini`) is modified
 - Invalidates per-language (different link rewriting)
 - No explicit TTL — entries persist until temp directory cleanup
-- **Does not track plugin state** — if a plugin modifies Markdown output (e.g., via PROCESS_CONTENT on files), changing plugin config won't bust the cache. Clear `/tmp/folderweb_cache/` manually after plugin changes that affect rendered Markdown.
+- **Does not track plugin state** — if a plugin modifies Markdown output (e.g., via PROCESS_CONTENT on files), changing plugin code won't bust the cache. Clear `/tmp/folderweb_cache/` manually after plugin changes that affect rendered Markdown.
 
 ```php
 getCachedMarkdown(string $filePath, string $langPrefix = ''): ?string