Release status: stable
|Description||Enables the designation of disambiguation pages with a magic word|
Translate the Disambiguator extension if it is available at translatewiki.net
|Check usage and version matrix; code metrics|
|Open tasks · Report a bug|
The Disambiguator extension is designed to make disambiguation pages easier to work with programmatically. It allows you to designate all disambiguation pages with the __DISAMBIG__ magic word (or an equivalent alias), which then marks them as such in the database. This allows other extensions to handle disambiguation pages as a separate class of page.
Installation[edit | edit source]
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'Disambiguator' );
- Special:Version on your wiki to verify that the extension is successfully installed. Done - Navigate to
To users running MediaWiki 1.24 or earlier:
The instructions above describe the new way of installing extensions using
wfLoadExtension(), since MediaWiki 1.25. If you need to install this extension in earlier versions, instead of
wfLoadExtension( 'Disambiguator' );, you need to use:
(To run an extension on an earlier release, you may need to download the version of it tagged for that release from Special:ExtensionDistributor.)
Features[edit | edit source]
Disambiguator provides the following features:
- Programmatic identification of disambiguation pages via the __DISAMBIG__ magic word
- New special pages for listing all disambiguation pages and pages linking to disambiguation pages
- New API functions equivalent to the above special pages as well as an API function for querying whether or not a page is a disambiguation page
- Modifies Special:LonelyPages to ignore disambiguation pages
- Modifies Special:Random to ignore disambiguation pages (requires MediaWiki 1.26.0)
- If VisualEditor is enabled, allows marking a page as a disambiguation page via the page properties interface
- If VisualEditor is enabled, shows whether a page is a disambiguation page or not in the link inspector
- If WikiEditor is enabled, shows whether a page is a disambiguation page or not in the link dialog
- If configured, add a 'mw-disambig' CSS class to links to disambiguation pages (See #Configuration below)
Configuration[edit | edit source]
The following configuration variables can be set from your LocalSettings.php file.
- $wgDisambiguatorIndicateLinks: whether to add a 'mw-disambig' CSS class to links to disambiguation pages (default is true)
Usage[edit | edit source]
Once Disambiguator is installed, the best way to use it is to add the __DISAMBIG__ magic word to a template that is then included in all of your disambiguation pages.
Once the magic word is in place, your disambiguation pages will all have the 'disambiguation' page property assigned to them in the database. This property resides in the page_props table.
You will also have two new special pages:
- Special:DisambiguationPages, which lists all the disambiguation pages on your wiki.
- Special:DisambiguationPageLinks, which lists all of the pages on your wiki that link to disambiguation pages. (This is a replacement for the old Special:Disambiguations page which is deprecated.)
API usage[edit | edit source]
To list all the disambiguation pages:
To list all the disambiguation page links:
Note that on wikis running in MiserMode (all WMF wikis), both the special page and API interface for DisambiguationPageLinks are limited to a certain number of results (typically 1000–5000).
To see if an individual page is a disambiguation page:
If it is a disambiguation page it will include 'disambiguation' in its pageprops. Note that the disambiguation pageprop, if present, will have its value set to an empty string, so be careful about testing it as a boolean.
Possible future plans[edit | edit source]
- Add an option to color code links to disambiguation pages
- Add an option to hide disambiguation pages from Special:AllPages (bug #7936), Special:PrefixIndex (bug #9319) and Special:WhatLinksHere (bug #7935)
- Consider extending link dialog in wikitext editor with ability to detect disambigs in search results and pull a list of links
- Complete list of bugs for this extension
|This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.|