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