1====== CatMenu Plugin ====== 2 3---- plugin ---- 4description: Zeigt ein Namespace-Baummenü an 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[[fr:plugin:catmenu|���� Français]] | [[plugin:catmenu|���� English]] | ���� **Deutsch** | [[es:plugin:catmenu|���� Español]] 23 24===== Installation ===== 25 26Plugin über den [[plugin:extension|Erweiterungs-Manager]] installieren. 27 28===== Beschreibung ===== 29 30Das **catmenu**-Plugin ermöglicht: 31 * die Anzeige eines Baummenüs (Seiten + Unterordner) für einen Namespace; 32 * das automatische Öffnen des Astes, der zur aktuellen Seite gehört; 33 * die Verarbeitung von Namespace-Startseiten (''$conf['start']''); 34 * ein konfigurierbares Kontextmenü mit Aktionen (je nach Berechtigung); 35 * das Einfügen von benutzerdefiniertem DokuWiki-Markup am Ende des Menüs. 36 37===== Syntax ===== 38 39Verwendung: 40 * ''{{catmenu>namespace}}'' 41 42Beispiele: 43 * ''{{catmenu>.}}'' (aktueller Namespace) 44 * ''{{catmenu>wiki}}'' 45 * ''{{catmenu>docs:projekt}}'' 46 47===== Einstellungen ===== 48 49^ Name ^ Beschreibung ^ Standardwert ^ 50| skip_file | Regulärer Ausdruck zum Ignorieren von Seiten-IDs. Akzeptiert auch ''@hidepages'', um die DokuWiki-Einstellung ''hidepages'' zu übernehmen. | '''' | 51| skip_page_without_title | Seiten ohne H1-Titel ausblenden. | ''true'' | 52| show_in_editor_menu | Einfüge-Schaltfläche im Editor anzeigen. | ''true'' | 53| context_menu_items | Aktionen im Kontextmenü (Kontrollkästchen). | alle aktiviert | 54| footer_content | Mehrzeiliges DokuWiki-Markup, das am Ende jedes Menüs eingefügt wird. | '''' | 55 56===== Kompatibilität ===== 57 58 * Kompatibel mit [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]] 59 * Verwendet [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] zur Anzeige von Symbolen, wenn verfügbar. Die Aktion „Symbol verwalten" im Kontextmenü erscheint nur, wenn ''pagesicon'' installiert ist. 60 * Kompatibel mit dem Plugin ''newpagefill'' zur Seitenerstellung. Wenn vorhanden, verwendet ''catmenu'' dessen Erstellungsassistenten. 61 62===== Kontextmenü ===== 63 64Rechtsklick auf einen Menüeintrag. Jede Aktion kann in der Konfiguration einzeln aktiviert oder deaktiviert werden: 65 * **Neue Seite erstellen** (''newpage'') — wenn berechtigt; 66 * **Cache neu laden** (''reload'') — (''purge=true''); 67 * **Medien verwalten** (''medias'') — öffnet den Medien-Manager; 68 * **Symbol verwalten** (''pagesicon'') — nur wenn ''pagesicon'' installiert ist; 69 * **URL kopieren** (''url''). 70 71===== Footer-DokuCode ===== 72 73Die Einstellung ''footer_content'' akzeptiert mehrzeiliges DokuWiki-Markup. Es wird als HTML gerendert und in einem ''<div class="catmenu-footer">'' unterhalb jedes Menüs eingefügt. Nützlich für permanente Links, Hinweise oder Schnellzugriffe. 74 75===== Berechtigungen ===== 76 77Die Darstellung folgt den DokuWiki-ACL-Regeln: 78 * Leseberechtigung ist erforderlich, um einen Eintrag anzuzeigen; 79 * Kontextaktionen sind je nach Berechtigung eingeschränkt (create/edit/upload). 80