xref: /plugin/catmenu/DOKU_DE (revision 339ba49c4f5b2a42161c07b899707ee1625d260f)
1aa591c90SLORTET====== CatMenu Plugin ======
2aa591c90SLORTET
3aa591c90SLORTET---- plugin ----
4aa591c90SLORTETdescription: Zeigt ein Namespace-Baummenü an
5aa591c90SLORTETauthor     : Valentin LORTET
6aa591c90SLORTETemail      : contact@valentinlortet.fr
7aa591c90SLORTETtype       : Syntax, Action
8aa591c90SLORTETlastupdate : 2026-03-14
9aa591c90SLORTETcompatible : Librarian
10aa591c90SLORTETdepends    :
11aa591c90SLORTETconflicts  :
12aa591c90SLORTETsimilar    :
13aa591c90SLORTETtags       : Navigation, Menu, Namespace, ProseMirror
14aa591c90SLORTET
15aa591c90SLORTETdownloadurl: https://github.com/Lortet/dokuwiki-plugin-catmenu/zipball/master
16aa591c90SLORTETbugtracker : https://github.com/Lortet/dokuwiki-plugin-catmenu/issues
17aa591c90SLORTETsourcerepo : https://github.com/Lortet/dokuwiki-plugin-catmenu/
18aa591c90SLORTETdonationurl:
19aa591c90SLORTETscreenshot_img :
20aa591c90SLORTET----
21aa591c90SLORTET
22*339ba49cSLORTET[[fr:plugin:catmenu|���� Français]] | [[plugin:catmenu|���� English]] | ���� **Deutsch** | [[es:plugin:catmenu|���� Español]]
23*339ba49cSLORTET
24aa591c90SLORTET===== Installation =====
25aa591c90SLORTET
26aa591c90SLORTETPlugin über den [[plugin:extension|Erweiterungs-Manager]] installieren.
27aa591c90SLORTET
28aa591c90SLORTET===== Beschreibung =====
29aa591c90SLORTET
30aa591c90SLORTETDas **catmenu**-Plugin ermöglicht:
31aa591c90SLORTET  * die Anzeige eines Baummenüs (Seiten + Unterordner) für einen Namespace;
32aa591c90SLORTET  * das automatische Öffnen des Astes, der zur aktuellen Seite gehört;
33aa591c90SLORTET  * die Verarbeitung von Namespace-Startseiten (''$conf['start']'');
34aa591c90SLORTET  * ein konfigurierbares Kontextmenü mit Aktionen (je nach Berechtigung);
35aa591c90SLORTET  * das Einfügen von benutzerdefiniertem DokuWiki-Markup am Ende des Menüs.
36aa591c90SLORTET
37aa591c90SLORTET===== Syntax =====
38aa591c90SLORTET
39aa591c90SLORTETVerwendung:
40aa591c90SLORTET  * ''{{catmenu>namespace}}''
41aa591c90SLORTET
42aa591c90SLORTETBeispiele:
43aa591c90SLORTET  * ''{{catmenu>.}}'' (aktueller Namespace)
44aa591c90SLORTET  * ''{{catmenu>wiki}}''
45aa591c90SLORTET  * ''{{catmenu>docs:projekt}}''
46aa591c90SLORTET
47aa591c90SLORTET===== Einstellungen =====
48aa591c90SLORTET
49aa591c90SLORTET^ Name ^ Beschreibung ^ Standardwert ^
50aa591c90SLORTET| skip_file | Regulärer Ausdruck zum Ignorieren von Seiten-IDs. Akzeptiert auch ''@hidepages'', um die DokuWiki-Einstellung ''hidepages'' zu übernehmen. | '''' |
51aa591c90SLORTET| skip_page_without_title | Seiten ohne H1-Titel ausblenden. | ''true'' |
52aa591c90SLORTET| show_in_editor_menu | Einfüge-Schaltfläche im Editor anzeigen. | ''true'' |
53aa591c90SLORTET| context_menu_items | Aktionen im Kontextmenü (Kontrollkästchen). | alle aktiviert |
54aa591c90SLORTET| footer_content | Mehrzeiliges DokuWiki-Markup, das am Ende jedes Menüs eingefügt wird. | '''' |
55aa591c90SLORTET
56aa591c90SLORTET===== Kompatibilität =====
57aa591c90SLORTET
58aa591c90SLORTET  * Kompatibel mit [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]]
59aa591c90SLORTET  * 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.
60aa591c90SLORTET  * Kompatibel mit dem Plugin ''newpagefill'' zur Seitenerstellung. Wenn vorhanden, verwendet ''catmenu'' dessen Erstellungsassistenten.
61aa591c90SLORTET
62aa591c90SLORTET===== Kontextmenü =====
63aa591c90SLORTET
64aa591c90SLORTETRechtsklick auf einen Menüeintrag. Jede Aktion kann in der Konfiguration einzeln aktiviert oder deaktiviert werden:
65aa591c90SLORTET  * **Neue Seite erstellen** (''newpage'') — wenn berechtigt;
66aa591c90SLORTET  * **Cache neu laden** (''reload'') — (''purge=true'');
67aa591c90SLORTET  * **Medien verwalten** (''medias'') — öffnet den Medien-Manager;
68aa591c90SLORTET  * **Symbol verwalten** (''pagesicon'') — nur wenn ''pagesicon'' installiert ist;
69aa591c90SLORTET  * **URL kopieren** (''url'').
70aa591c90SLORTET
71aa591c90SLORTET===== Footer-DokuCode =====
72aa591c90SLORTET
73aa591c90SLORTETDie 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.
74aa591c90SLORTET
75aa591c90SLORTET===== Berechtigungen =====
76aa591c90SLORTET
77aa591c90SLORTETDie Darstellung folgt den DokuWiki-ACL-Regeln:
78aa591c90SLORTET  * Leseberechtigung ist erforderlich, um einen Eintrag anzuzeigen;
79aa591c90SLORTET  * Kontextaktionen sind je nach Berechtigung eingeschränkt (create/edit/upload).
80