Inial implementation for folder opening

syntax/open.php

@@ -0,0 +1,79 @@
+<?php
+
+use dokuwiki\Extension\SyntaxPlugin;
+
+/**
+ * File Tools Plugin: Open local path syntax.
+ *
+ * Renders an inline button. Clicking it triggers client-side JS that attempts
+ * to open the configured path in the default file manager (best-effort).
+ */
+class syntax_plugin_filetools_open extends SyntaxPlugin
+{
+    /** @inheritdoc */
+    public function getType()
+    {
+        return 'substition';
+    }
+
+    /** @inheritdoc */
+    public function getPType()
+    {
+        // inline
+        return 'normal';
+    }
+
+    /** @inheritdoc */
+    public function getSort()
+    {
+        return 222;
+    }
+
+    /** @inheritdoc */
+    public function connectTo($mode)
+    {
+        $this->Lexer->addSpecialPattern('\{\{open>.+?\}\}', $mode, 'plugin_filetools_open');
+    }
+
+    /** @inheritdoc */
+    public function handle($match, $state, $pos, Doku_Handler $handler)
+    {
+        $match = substr($match, strlen('{{open>'), -2);
+        [$path, $caption] = array_pad(explode('|', $match, 2), 2, '');
+
+        $path = trim($path);
+        $caption = trim($caption);
+        if ($caption === '') $caption = $path !== '' ? $path : 'Open';
+
+        // Basic scheme filtering to avoid javascript: style injections.
+        // Allow either file:// URLs, or plain paths (Windows/UNC/Linux style).
+        if (preg_match('/^[a-zA-Z][a-zA-Z0-9+.-]*:/', $path)) {
+            if (!str_starts_with(strtolower($path), 'file://')) {
+                return false;
+            }
+        }
+
+        return [$path, $caption];
+    }
+
+    /** @inheritdoc */
+    public function render($format, Doku_Renderer $renderer, $data)
+    {
+        if ($data === false) return false;
+        [$path, $caption] = $data;
+
+        if ($format !== 'xhtml') {
+            // no meaningful representation in non-browser formats
+            $renderer->cdata($caption);
+            return true;
+        }
+
+        if ($path === '') {
+            $renderer->cdata('[n/a]');
+            return true;
+        }
+
+        $renderer->doc .= '<button type="button" class="filetools-open" data-path="' . hsc($path) . '">' . hsc($caption) . '</button>';
+        return true;
+    }
+}