xref: /plugin/catmenu/README (revision 339ba49c4f5b2a42161c07b899707ee1625d260f)
16983cdfdSLORTET# CatMenu
26983cdfdSLORTET
3*339ba49cSLORTET���� Français | [���� English](README_EN) | [���� Deutsch](README_DE) | [���� Español](README_ES)
4*339ba49cSLORTET
56983cdfdSLORTET`catmenu` affiche un menu arborescent (pages + sous-dossiers) pour un namespace DokuWiki.
66983cdfdSLORTET
76983cdfdSLORTET## Syntaxe
86983cdfdSLORTET
96983cdfdSLORTET```text
106983cdfdSLORTET{{catmenu>namespace}}
116983cdfdSLORTET```
126983cdfdSLORTET
136983cdfdSLORTETExemples :
146983cdfdSLORTET
156983cdfdSLORTET```text
166983cdfdSLORTET{{catmenu>.}}
176983cdfdSLORTET{{catmenu>wiki}}
186983cdfdSLORTET{{catmenu>docs:projet}}
196983cdfdSLORTET```
206983cdfdSLORTET
216983cdfdSLORTET- `.` : utilise le namespace courant.
226983cdfdSLORTET- `namespace` : utilise le namespace indiqué.
236983cdfdSLORTET
246983cdfdSLORTET## Comportement
256983cdfdSLORTET
266983cdfdSLORTET- liste les pages et sous-dossiers accessibles en lecture.
276983cdfdSLORTET- ouvre automatiquement la branche correspondant à la page courante.
286983cdfdSLORTET- gère les pages d'accueil de namespace (`$conf['start']`).
296983cdfdSLORTET- masque les pages sans titre H1 si `skip_page_without_title` est activé.
306983cdfdSLORTET
316983cdfdSLORTET## Configuration
326983cdfdSLORTET
336983cdfdSLORTETDans le gestionnaire de configuration :
346983cdfdSLORTET
35aa591c90SLORTET- `skip_file` : regex pour ignorer certains IDs de page. Accepte aussi la valeur spéciale `@hidepages` pour réutiliser automatiquement le paramètre `hidepages` de DokuWiki.
366983cdfdSLORTET- `skip_page_without_title` : ignorer les pages sans H1.
376983cdfdSLORTET- `show_in_editor_menu` : afficher le bouton d'insertion dans l'éditeur.
38aa591c90SLORTET- `context_menu_items` : cases à cocher pour choisir les actions disponibles dans le menu contextuel (clic droit). Toutes activées par défaut.
39aa591c90SLORTET- `footer_content` : DokuCode multiligne injecté à la fin de chaque menu (liens, notes, etc.). Vide par défaut.
406983cdfdSLORTET
416983cdfdSLORTET## Compatibilité
426983cdfdSLORTET
436983cdfdSLORTET- Compatible avec le plugin [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror)
44aa591c90SLORTET- `catmenu` utilise le plugin [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) pour afficher les icônes, si disponible. L'action "Gérer l'icône" dans le menu contextuel n'apparaît que si pagesicon est installé.
45aa591c90SLORTET- Compatible avec le plugin `newpagefill` pour la création de pages. S'il est présent, `catmenu` utilise son assistant de création.
466983cdfdSLORTET
476983cdfdSLORTET## Menu contextuel
486983cdfdSLORTET
49aa591c90SLORTETClic droit sur un item (actions configurables individuellement) :
506983cdfdSLORTET
516983cdfdSLORTET- créer une nouvelle page (selon droits),
526983cdfdSLORTET- recharger le cache (`purge=true`),
536983cdfdSLORTET- ouvrir le gestionnaire de médias,
546983cdfdSLORTET- ouvrir la gestion d'icône (`pagesicon`) si disponible,
556983cdfdSLORTET- copier l'URL.
566983cdfdSLORTET
576983cdfdSLORTET## Permissions
586983cdfdSLORTET
596983cdfdSLORTETLe rendu respecte les ACL DokuWiki :
606983cdfdSLORTET
616983cdfdSLORTET- lecture minimale pour afficher un item,
626983cdfdSLORTET- actions contextuelles limitées selon les droits (create/edit/upload).
63