1====== CatMenu Plugin ====== 2 3---- plugin ---- 4description: Displays a namespace tree menu 5author : Valentin LORTET 6email : contact@valentinlortet.fr 7type : Syntax, Action 8lastupdate : 2026-03-14 9compatible : Librarian 10depends : 11conflicts : 12similar : 13tags : Navigation, Menu, Namespace, ProseMirror 14 15downloadurl: https://github.com/Lortet/dokuwiki-plugin-catmenu/zipball/master 16bugtracker : https://github.com/Lortet/dokuwiki-plugin-catmenu/issues 17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-catmenu/ 18donationurl: 19screenshot_img : 20---- 21 22===== Installation ===== 23 24Install the plugin from the [[plugin:extension|Extension Manager]]. 25 26===== Description ===== 27 28The **catmenu** plugin allows you to: 29 * display a tree menu (pages + subfolders) for a namespace; 30 * automatically open the branch matching the current page; 31 * handle namespace start pages (''$conf['start']''); 32 * provide a configurable right-click context menu (depending on permissions); 33 * inject custom DokuWiki markup at the bottom of the menu. 34 35===== Syntax ===== 36 37Usage: 38 * ''{{catmenu>namespace}}'' 39 40Examples: 41 * ''{{catmenu>.}}'' (current namespace) 42 * ''{{catmenu>wiki}}'' 43 * ''{{catmenu>docs:project}}'' 44 45===== Settings ===== 46 47^ Name ^ Description ^ Default value ^ 48| skip_file | Regex used to ignore page IDs. Also accepts ''@hidepages'' to reuse DokuWiki's ''hidepages'' setting. | '''' | 49| skip_page_without_title | Ignore pages without an H1 title. | ''true'' | 50| show_in_editor_menu | Show the insert button in the editor. | ''true'' | 51| context_menu_items | Actions available in the right-click context menu (checkboxes). | all enabled | 52| footer_content | Multiline DokuWiki markup injected at the bottom of every menu. | '''' | 53 54===== Compatibility ===== 55 56 * Compatible with [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]] 57 * Uses [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] to display icons when available. The "Manage icon" context menu action only appears if ''pagesicon'' is installed. 58 * Compatible with the ''newpagefill'' plugin for page creation. When available, ''catmenu'' uses its creation helper. 59 60===== Context menu ===== 61 62Right-click on a menu item. Each action can be individually enabled or disabled in the configuration: 63 * **Create a new page** (''newpage'') — if allowed; 64 * **Reload cache** (''reload'') — (''purge=true''); 65 * **Manage media** (''medias'') — opens the media manager; 66 * **Manage icon** (''pagesicon'') — only shown if ''pagesicon'' is installed; 67 * **Copy URL** (''url''). 68 69===== Footer DokuCode ===== 70 71The ''footer_content'' setting accepts multiline DokuWiki markup. It is rendered as HTML and injected inside a ''<div class="catmenu-footer">'' below every menu. Useful for adding permanent links, notes or shortcuts. 72 73===== Permissions ===== 74 75Rendering follows DokuWiki ACL rules: 76 * read permission is required to show an item; 77 * context actions are limited by permissions (create/edit/upload). 78