Release status: stable
|Hook, Special page
|Shows direct children of current page in article header and provides a special page to browse all articles with subpages of the wiki in different modalities
|Master maintains backward compatibility.
|GNU General Public License 2.0 or later
|32 (Ranked 117th)
|Translate the SubpageNavigation extension if it is available at translatewiki.net
SubpageNavigation shows a collapsible list of subpages on the header of each article, including empty articles, with subpages. By contrast to similar extensions, SubpageNavigation does not require to add a parser function in the wikitext, and shows only direct children of a page. (a direct child, however, might include slashes if the parent page does not exist). It also features a breadcrumb navigation placed above the title, and a special page where to browse all the pages of the wiki grouped by subpages, in a similar way to the GitHub file manager.
After the installation the extension adds a link in the side-panel to browse all the articles of the wiki in 3 different modalities (by grouping subpages, only pages with children, and filesystem-like) and adds the features described below.
- Download and move the extracted
SubpageNavigationfolder to your
Developers and code contributors should install the extension from Git instead, using:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SubpageNavigation
- Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'SubpageNavigation' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Collapsible list of subpages edit
The extension will show in any page of your wiki with subpages an header like the following, without the need to add a parser function.
The list of subpages is also shown for non-existing articles, this is useful for instance when subpages are created in a programmatic way: however if the intermediate pages are empty, the children won't be grouped in the Special Page "Browse subpages", so it is always preferable to have an empty article for each intermediate level (unless the title itself does not contain a slash, in this case it will be handled correctly by the extension).
When the list of subpages shown on a given article exceeds a given threshold, SubpagesNavigation will display a link to the special page Browse subpages where the user can navigate the entire list of subbpages with the standard MediaWiki navigation.
When the current page has a parent page, the extension will also show a breadcrumb navigation like the following:
The breadcrumb is also shown on Special pages navigation, so the user can easily return to the list of Special pages.
This feature can be disabled setting
$wgSubpageNavigationDisableBreadcrumb = true; in LocalSettings.php after loading the extension.
Special page "Browse subpages" edit
Since version 1.1 SubpageNavigation displays a link "Browse subpages" in the side-panel that points to a special page where the articles of the wiki can be navigated in 3 different modalities (by grouping subpages, only pages with children, and filesystem-like).
The navigation panel allows to switch mode, between "standard", "folders", and "filesystem": the first mode will display articles with subpages and articles without subpages together, but will group the articles with subpages. The second mode, "folders" will display only articles with children, and the mode "filesystem" will display first the articles with children and then the articles without children.
A future version of the extension might feature a hierarchical navigation using Ajax, however the current panel allows to navigate among a large number of articles using the standard Mediawiki navigation, and this is the key feature of SubpageNavigation.
Global parameters edit
|max number of subpages shown in the article header
|Disable breadcrumb navigation
Known issues edit
Currently breadcrumb is disabled for the Vector-2022 skin. This because the breadcrumb is currently inserted within the Page status indicators, and it seems that there is no way on such skin to manually display the indicators above the title using PHP.
- hierarchical navigation performed through Ajax, optionally shown in the side-panel and in the special page "Browse subpages".
Support & bugs edit
Please post error messages in the Talk page of the extension.
For professional support please write at the email address posted here