xref: /plugin/catmenu/DOKU_ES (revision aa591c9040aa9d58df44eaf65df693766613dc9f)
1*aa591c90SLORTET====== CatMenu Plugin ======
2*aa591c90SLORTET
3*aa591c90SLORTET---- plugin ----
4*aa591c90SLORTETdescription: Muestra un menú en árbol de namespace
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===== Instalación =====
23*aa591c90SLORTET
24*aa591c90SLORTETInstalar el plugin desde el [[plugin:extension|Gestor de extensiones]].
25*aa591c90SLORTET
26*aa591c90SLORTET===== Descripción =====
27*aa591c90SLORTET
28*aa591c90SLORTETEl plugin **catmenu** permite:
29*aa591c90SLORTET  * mostrar un menú en árbol (páginas + subcarpetas) para un namespace;
30*aa591c90SLORTET  * abrir automáticamente la rama correspondiente a la página actual;
31*aa591c90SLORTET  * gestionar las páginas de inicio de namespace (''$conf['start']'');
32*aa591c90SLORTET  * ofrecer un menú contextual de acciones configurable (según permisos);
33*aa591c90SLORTET  * insertar marcado DokuWiki personalizado al pie de cada menú.
34*aa591c90SLORTET
35*aa591c90SLORTET===== Sintaxis =====
36*aa591c90SLORTET
37*aa591c90SLORTETUso:
38*aa591c90SLORTET  * ''{{catmenu>namespace}}''
39*aa591c90SLORTET
40*aa591c90SLORTETEjemplos:
41*aa591c90SLORTET  * ''{{catmenu>.}}'' (namespace actual)
42*aa591c90SLORTET  * ''{{catmenu>wiki}}''
43*aa591c90SLORTET  * ''{{catmenu>docs:proyecto}}''
44*aa591c90SLORTET
45*aa591c90SLORTET===== Parámetros =====
46*aa591c90SLORTET
47*aa591c90SLORTET^ Nombre ^ Descripción ^ Valor por defecto ^
48*aa591c90SLORTET| skip_file | Expresión regular para ignorar IDs de páginas. También acepta ''@hidepages'' para reutilizar el parámetro ''hidepages'' de DokuWiki. | '''' |
49*aa591c90SLORTET| skip_page_without_title | Ignorar páginas sin título H1. | ''true'' |
50*aa591c90SLORTET| show_in_editor_menu | Mostrar el botón de inserción en el editor. | ''true'' |
51*aa591c90SLORTET| context_menu_items | Acciones disponibles en el menú contextual (casillas de verificación). | todas activadas |
52*aa591c90SLORTET| footer_content | Marcado DokuWiki multilínea insertado al final de cada menú. | '''' |
53*aa591c90SLORTET
54*aa591c90SLORTET===== Compatibilidad =====
55*aa591c90SLORTET
56*aa591c90SLORTET  * Compatible con [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]]
57*aa591c90SLORTET  * Usa [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] para mostrar iconos cuando está disponible. La acción "Gestionar icono" en el menú contextual solo aparece si ''pagesicon'' está instalado.
58*aa591c90SLORTET  * Compatible con el plugin ''newpagefill'' para la creación de páginas. Cuando está disponible, ''catmenu'' usa su asistente de creación.
59*aa591c90SLORTET
60*aa591c90SLORTET===== Menú contextual =====
61*aa591c90SLORTET
62*aa591c90SLORTETClic derecho sobre un elemento del menú. Cada acción puede activarse o desactivarse individualmente en la configuración:
63*aa591c90SLORTET  * **Crear nueva página** (''newpage'') — si está autorizado;
64*aa591c90SLORTET  * **Recargar caché** (''reload'') — (''purge=true'');
65*aa591c90SLORTET  * **Gestionar multimedia** (''medias'') — abre el gestor de archivos multimedia;
66*aa591c90SLORTET  * **Gestionar icono** (''pagesicon'') — solo si ''pagesicon'' está instalado;
67*aa591c90SLORTET  * **Copiar URL** (''url'').
68*aa591c90SLORTET
69*aa591c90SLORTET===== Footer DokuCode =====
70*aa591c90SLORTET
71*aa591c90SLORTETEl parámetro ''footer_content'' acepta marcado DokuWiki multilínea. Se renderiza como HTML y se inserta dentro de un ''<div class="catmenu-footer">'' bajo cada menú. Útil para añadir enlaces permanentes, notas o accesos directos.
72*aa591c90SLORTET
73*aa591c90SLORTET===== Permisos =====
74*aa591c90SLORTET
75*aa591c90SLORTETEl renderizado sigue las reglas ACL de DokuWiki:
76*aa591c90SLORTET  * se requiere permiso de lectura para mostrar un elemento;
77*aa591c90SLORTET  * las acciones contextuales están limitadas según los permisos (create/edit/upload).
78