Jump to content

Extension:RelatedArticles

From mediawiki.org
MediaWiki extensions manual
RelatedArticles
Release status: stable
Implementation Parser function , API
Description Adds a link to related pages on the footer
Author(s) Reading Web Team
Latest version 3.1.0 (SemVer) (Continuous updates)
MediaWiki 1.25+
PHP 5.4+
Database changes No
License GNU General Public License 2.0 or later
Download
CHANGELOG
Help Help:Extension:RelatedArticles
  • $wgRelatedArticlesDescriptionSource
  • $wgRelatedArticlesFooterAllowedSkins
  • $wgRelatedArticlesOnlyUseCirrusSearch
  • $wgRelatedArticlesCardLimit
  • $wgRelatedArticlesUseCirrusSearchApiUrl
  • $wgRelatedArticlesUseCirrusSearch
Quarterly downloads 56 (Ranked 90th)
Translate the RelatedArticles extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

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 .

Related Articles on the Vector skin.
Related Articles on the Minerva skin.

Installation

[edit]
  • Download and move the extracted RelatedArticles folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RelatedArticles
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'RelatedArticles' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

If you use something other than w/api.php for your API, and related pages is not showing, check for any bad requests in your browser network tab. If necessary, the API used to obtain related articles is configurable with $wgRelatedArticlesUseCirrusSearchApiUrl

Requirements for additional features

[edit]

RelatedArticles can optionally provide additional features if the extensions below are installed:

  • If PageImages is installed, Related Articles will include the page's selected image (if any). Otherwise, a placeholder image will be used instead.
  • If EventLogging is installed, the RelatedPages feature can be configured to log events. See below for configuration manual.
  • Depending on the configuration of $wgRelatedArticlesDescriptionSource, a small description of each page can be fetched. See the configuration manual below for required extensions. Descriptions won't be provided if the specified extension isn't installed.

Usage

[edit]

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

{{#related:Test with read more}}
{{#related:Another test page}}

Configuration

[edit]
  • Related articles will be shown at the bottom of the skin. Note that the page must be in the Main namespace, and being viewed (as opposed to edited for example), and not be a disambiguation or a diff page, and the skin name (e.g. minerva) that's being used is in the array $wgRelatedArticlesFooterAllowedSkins (see below).

The following configuration options apply:

  • If EventLogging is installed, set the event logging sampling rate $wgRelatedArticlesLoggingSamplingRate using a number between 0 and 1. The schema used for logging is RelatedArticles .
  • Use morelike feature of CirrusSearch by setting $wgRelatedArticlesUseCirrusSearch to true. If CirrusSearch is not available fallback to using the related articles marked in wikitext.
  • Use only CirrusSearch's morelike feature by setting $wgRelatedArticlesOnlyUseCirrusSearch to true ignoring the related articles marked in wikitext.
  • $wgRelatedArticlesFooterAllowedSkins 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, $wgRelatedArticlesFooterAllowedSkins = ['vector'] will result in the widget showing on Vector only. The skin names have to all be in lowercase, e.g. 'vector' not 'Vector', even if the skin directory is 'Vector'. In versions prior to 1.37.0-wmf.3, this is named $wgRelatedArticlesFooterWhitelistedSkins.
  • A small description of the page will be displayed below the title of the page, depending on the value of $wgRelatedArticlesDescriptionSource:

For development

[edit]

For development the following configuration is recommended:

$wgRelatedArticlesUseCirrusSearchApiUrl = 'https://en.wikipedia.org/w/api.php';
$wgRelatedArticlesUseCirrusSearch = true;
$wgRelatedArticlesFooterAllowedSkins = [ 'vector-2022', 'vector', 'minerva', 'timeless' ];
$wgRelatedArticlesDescriptionSource = 'wikidata';

RelatedPages

[edit]

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

On Wikimedia Projects

[edit]

Related pages is enabled on:

  • All Wikipedias, when using Minerva and Timeless skins (except dewiki where they disabled it on Timeless skin), and for hewiki and htwiki, Vector
  • All Wikivoyages, when using Minerva, Timeless and Vector
  • eswikinews, frwikinews and zhwikinews, for all skins

Feedback

[edit]

Help

[edit]