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