Extension:RelatedArticles

The RelatedArticles extension adds a parser function to your wikitext that allows associating related articles with your article. It shows related pages as a list of articles and their descriptions at the bottom of a page on desktop and mobile. The extension is also smart enough to get the list of related articles using the morelike feature of CirrusSearch.



Usage
Once installed Related articles will be determined algorithmically based on Cirrus Search if available with no additional steps. Alternatively, you can disable this functionality ($wgRelatedArticlesUseCirrusSearch) and manually add related articles like so:

Prerequisites
If EventLogging is installed, the RelatedPages feature can be configured to log events. It is not required.

If PageImages is installed, Related Articles will include the page's selected image (if any). Otherwise, a placeholder image will be used instead. This extension is not required.

Depending on the configuration of  (see below), a small description of each page can be fetched, provided by one of those extensions, which aren't required. Description won't be provided if the extension isn't available.

Configuration
The following configuration options apply:
 * Related articles will be shown at the bottom of the skin. Note that the page must be in the Main namespace, and being ed (as opposed to  ed for example), and not be a disambiguation or a diff page, and the skin name (e.g.  ) that's being used is in the array   (see below).
 * If EventLogging is installed, set the event logging sampling rate   using a number between 0 and 1. The schema used for logging is  RelatedArticles.
 * Use morelike feature of CirrusSearch by setting  to  . If CirrusSearch is not available fallback to using the related articles marked in wikitext.
 * Use only CirrusSearch's morelike feature by setting  to   ignoring the related articles marked in wikitext.
 * List of skin names (e.g. 'minerva', 'vector') where related articles will be shown in the footer. For example, on a wiki with Monobook, Vector and Minerva installed will result in the widget showing on Vector only.
 * A small description of the page will be displayed below the title of the page, depending on the value of :
 * : Requires Wikibase Client, from the central wikibase repository.
 * : Requires Extension:TextExtracts, fetched from the prop=extracts api.
 * : Requires Extension:Description2 (or any other extension that sets the  page property).

RelatedPages
The Related Pages feature is implemented in this extension. More info about its development can be found on phabricator.

On Wikimedia Projects
Related pages is enabled on the Minerva and Timeless skins of all Wikivoyage projects and Wikipedia projects for example English and Hebrew Wikipedia.

Feedback

 * Create a task in Wikimedia's issue tracker under the "RelatedArticles" project.
 * Check the list of existing RelatedArticles tasks