Add cache inclalidation for Chronological

src/CacheInvalidation.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace dokuwiki\plugin\luxtools;
+
+/**
+ * Cache invalidation helpers for luxtools.
+ *
+ * Provides a full DokuWiki cache purge (all rendered pages, instructions,
+ * CSS/JS bundles) as well as luxtools-specific cache cleanup (thumbnails,
+ * pagelink mapping).
+ */
+class CacheInvalidation
+{
+    /**
+     * Purge the complete DokuWiki cache directory.
+     *
+     * This removes all files and subdirectories inside the configured
+     * cache directory ($conf['cachedir']).  It is equivalent to running
+     * `rm -rf data/cache/*` on the server.
+     *
+     * @return int Number of removed entries.
+     */
+    public static function purgeAll(): int
+    {
+        global $conf;
+
+        $cacheDir = rtrim((string)($conf['cachedir'] ?? ''), '/');
+        if ($cacheDir === '' || !is_dir($cacheDir)) {
+            return 0;
+        }
+
+        return self::removeDirectoryEntries($cacheDir);
+    }
+
+    /**
+     * Remove all files and subdirectories inside a directory
+     * without removing the directory itself.
+     *
+     * @param string $directory
+     * @return int Number of removed files/directories.
+     */
+    public static function removeDirectoryEntries(string $directory): int
+    {
+        if ($directory === '' || !is_dir($directory) || !is_readable($directory)) {
+            return 0;
+        }
+
+        $entries = @scandir($directory);
+        if (!is_array($entries)) return 0;
+
+        $removed = 0;
+        foreach ($entries as $entry) {
+            if ($entry === '.' || $entry === '..') continue;
+
+            $path = $directory . '/' . $entry;
+            if (is_dir($path) && !is_link($path)) {
+                $removed += self::removeDirectoryEntries($path);
+                if (@rmdir($path)) {
+                    $removed++;
+                }
+                continue;
+            }
+
+            if ((is_file($path) || is_link($path)) && @unlink($path)) {
+                $removed++;
+            }
+        }
+
+        return $removed;
+    }
+}

src/MenuItem/InvalidateCache.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace dokuwiki\plugin\luxtools\MenuItem;
+
+use dokuwiki\Menu\Item\AbstractItem;
+
+class InvalidateCache extends AbstractItem
+{
+    /**
+     * @param string $label
+     * @param string $title
+     */
+    public function __construct(string $label, string $title)
+    {
+        global $ID;
+
+        $this->id = is_string($ID) ? $ID : '';
+        $this->type = 'show';
+        $this->method = 'get';
+        $this->params = [
+            'do' => 'show',
+            'luxtools_invalidate_cache' => 1,
+        ];
+        $this->nofollow = true;
+        $this->label = $label;
+        $this->title = $title;
+        $this->svg = DOKU_INC . 'lib/images/menu/calendar-clock.svg';
+
+        if (function_exists('getSecurityToken')) {
+            $this->params['sectok'] = getSecurityToken();
+        }
+    }
+
+    /**
+     * Keep a distinct class hook for template styling.
+     *
+     * @return string
+     */
+    public function getType()
+    {
+        return 'luxtools-invalidate-cache';
+    }
+}