1====== Visualindex Plugin ====== 2 3---- plugin ---- 4description: Displays a visual index 5author : Valentin LORTET, Gabriel CHOIMET 6email : contact@valentinlortet.fr 7type : Syntax, Action 8lastupdate : 2026-03-14 9compatible : Librarian 10depends : 11conflicts : 12similar : 13tags : Navigation, Index, Media, ProseMirror, pagesicon 14 15downloadurl: https://github.com/Lortet/dokuwiki-plugin-visualindex/zipball/master 16bugtracker : https://github.com/Lortet/dokuwiki-plugin-visualindex/issues 17sourcerepo : https://github.com/Lortet/dokuwiki-plugin-visualindex/ 18donationurl: 19screenshot_img : 20---- 21 22[[fr:plugin:visualindex|���� Français]] | **���� English** | [[de:plugin:visualindex|���� Deutsch]] | [[es:plugin:visualindex|���� Español]] 23 24===== Installation ===== 25 26Install the plugin from the [[plugin:extension|Extension Manager]]. 27 28===== Description ===== 29 30The plugin **visualindex** displays a visual index of pages (or media files) from a DokuWiki namespace. 31 32It is compatible with: 33 * the classic editor; 34 * [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]]. 35 36{{https://i.ibb.co/5WKQFcdF/Screenshot-2026-03-09-at-15-37-11-Wiki-doc-Wiki-BSPP.png}} 37 38===== Syntax ===== 39 40Base syntax: 41 * ''{{visualindex>namespace}}'' 42 43Examples: 44 * ''{{visualindex>.}}'' 45 * ''{{visualindex>wiki}}'' 46 * ''{{visualindex>wiki;filter=start|syntax*}}'' 47 * ''{{visualindex>wiki;desc=1}}'' 48 * ''{{visualindex>wiki;medias=1}}'' 49 * ''{{visualindex>.;filter=guide*;desc=1;medias=1}}'' 50 51Options: 52 * ''filter'' : simple wildcard filter with ''*'' (example: ''guide*|doc*''); 53 * ''desc'' : descending sort (''1'' / ''true''); 54 * ''medias'' : list media from namespace (''1'' / ''true''). 55 56Special namespace: 57 * ''.'' : current namespace; 58 * ''~sub:folder'' : namespace relative to current namespace. 59 60===== Settings ===== 61 62^ Name ^ Description ^ Default value ^ 63| icon_size | Icon size (example: ''100px''). | ''100px'' | 64| text_size | Text size (example: ''13px''). | ''13px'' | 65| text_color | Text color (hex, rgb/rgba, or CSS color name). | ''black'' | 66| skip_file | Regex of pages to ignore. | '''' | 67| show_in_editor_menu | Show Visualindex in editor menus (classic and ProseMirror). | ''true'' | 68| use_pagesicon | Use ''pagesicon'' helper when available. | ''true'' | 69| default_image | Default image (media ID), e.g. ''wiki:logo.png''. | '''' | 70 71===== pagesicon integration ===== 72 73If [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] is installed and ''use_pagesicon'' is enabled: 74 * Visualindex resolves page icons; 75 * Visualindex resolves media icons; 76 * fallback is used if no icon is found. 77 78Fallback order: 79 * icon provided by ''pagesicon''; 80 * Visualindex ''default_image''; 81 * plugin internal image (''images/default_image.png''). 82 83===== ProseMirror ===== 84 85The plugin exposes a ''Visualindex'' button in ProseMirror (when ''show_in_editor_menu'' is enabled), with a configuration popup: 86 * namespace; 87 * filter; 88 * descending order; 89 * media listing. 90 91===== Main files ===== 92 93 * ''syntax/visualindex.php'' : parsing and XHTML rendering; 94 * ''action/prosemirror.php'' : editor integration; 95 * ''script/prosemirror.js'' : ProseMirror node; 96 * ''script/toolbar.js'' : button and popup; 97 * ''style.css'' : display styles. 98
