1====== CatMenu Plugin ====== 2 3---- plugin ---- 4description: Muestra un menú en árbol de namespace 5author : Valentin LORTET 6email : contact@valentinlortet.fr 7type : Syntax, Action 8lastupdate : 2026-03-14 9compatible : Librarian 10depends : 11conflicts : 12similar : 13tags : Navigation, Menu, Namespace, ProseMirror 14 15downloadurl: https://github.com/Lortet/dokuwiki-plugin-catmenu/zipball/master 16bugtracker : https://github.com/Lortet/dokuwiki-plugin-catmenu/issues 17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-catmenu/ 18donationurl: 19screenshot_img : 20---- 21 22[[fr:plugin:catmenu|���� Français]] | [[plugin:catmenu|���� English]] | [[de:plugin:catmenu|���� Deutsch]] | ���� **Español** 23 24===== Instalación ===== 25 26Instalar el plugin desde el [[plugin:extension|Gestor de extensiones]]. 27 28===== Descripción ===== 29 30El plugin **catmenu** permite: 31 * mostrar un menú en árbol (páginas + subcarpetas) para un namespace; 32 * abrir automáticamente la rama correspondiente a la página actual; 33 * gestionar las páginas de inicio de namespace (''$conf['start']''); 34 * ofrecer un menú contextual de acciones configurable (según permisos); 35 * insertar marcado DokuWiki personalizado al pie de cada menú. 36 37===== Sintaxis ===== 38 39Uso: 40 * ''{{catmenu>namespace}}'' 41 42Ejemplos: 43 * ''{{catmenu>.}}'' (namespace actual) 44 * ''{{catmenu>wiki}}'' 45 * ''{{catmenu>docs:proyecto}}'' 46 47===== Parámetros ===== 48 49^ Nombre ^ Descripción ^ Valor por defecto ^ 50| skip_file | Expresión regular para ignorar IDs de páginas. También acepta ''@hidepages'' para reutilizar el parámetro ''hidepages'' de DokuWiki. | '''' | 51| skip_page_without_title | Ignorar páginas sin título H1. | ''true'' | 52| show_in_editor_menu | Mostrar el botón de inserción en el editor. | ''true'' | 53| context_menu_items | Acciones disponibles en el menú contextual (casillas de verificación). | todas activadas | 54| footer_content | Marcado DokuWiki multilínea insertado al final de cada menú. | '''' | 55 56===== Compatibilidad ===== 57 58 * Compatible con [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]] 59 * 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. 60 * Compatible con el plugin ''newpagefill'' para la creación de páginas. Cuando está disponible, ''catmenu'' usa su asistente de creación. 61 62===== Menú contextual ===== 63 64Clic derecho sobre un elemento del menú. Cada acción puede activarse o desactivarse individualmente en la configuración: 65 * **Crear nueva página** (''newpage'') — si está autorizado; 66 * **Recargar caché** (''reload'') — (''purge=true''); 67 * **Gestionar multimedia** (''medias'') — abre el gestor de archivos multimedia; 68 * **Gestionar icono** (''pagesicon'') — solo si ''pagesicon'' está instalado; 69 * **Copiar URL** (''url''). 70 71===== Footer DokuCode ===== 72 73El 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. 74 75===== Permisos ===== 76 77El renderizado sigue las reglas ACL de DokuWiki: 78 * se requiere permiso de lectura para mostrar un elemento; 79 * las acciones contextuales están limitadas según los permisos (create/edit/upload). 80