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