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