Extension talk:RelatedArticles

From MediaWiki.org
Jump to navigation Jump to search

How does this extension determine Related pages?

Any objections to reading web team driving new development in this extension?[edit]

Given this extension is currently unmaintained, the Reading/Web is interesting in take ownership of this and doing additional development inside it to create an API driven "related articles" panel at the bottom of articles. To begin with we will build this in the mobile beta and surface it as a desktop beta feature. I'm personally interesting in allowing editors to correct inaccurate automatic results using the related magic word.

Details and screenshots of the new feature on mobile, which has shown an increased engagment on our app can be found on phabricator. Jdlrobson (talk) 18:14, 24 September 2015 (UTC)

Add extension.json[edit]

Please add this file for using described method.

wfLoadExtension( 'RelatedArticles' );

--UksusoFF (talk) 16:11, 11 June 2016 (UTC)


After installing extension get error:

RelatedArticles/RelatedArticles.class.php: CustomData extension is not properly installed.

But this not described in Installation section. That right?

--UksusoFF (talk) 16:15, 11 June 2016 (UTC)

CirrusSearch not working[edit]

I only see Related Pages when they are specified on the page itself. I have CirrusSearch installed and it works perfectly as the default search for my MediaWiki installation. However, enabling $wgRelatedArticlesUseCirrusSearch seems to have no effect.

Benhinc (talk) 18:11, 27 December 2016 (UTC)

Configuration like in wikipedia[edit]

How to configure like on the wikipedia pages (related articles at the footer)?


Johnywhy (talk) 20:02, 23 April 2018 (UTC)

Permission Error on extensions.json[edit]

MediaWiki 1.30.0 returns error with the version of RelatedArticles that is available for default downnload as of this moment. The dev version of RelatedArticles from the GitHub repo does not have this error anymore. HTH --GravaT (talk) 20:35, 26 March 2018 (UTC)

Request: Relate by Topic-Tag[edit]

Eg, i'd like to create a tag, MyTag, and then relate several pages with {{#related:MyTag}}. Is that possible?

I'm guessing it could be done with a common page that they all point to, where the hub page is called "MyTag". Maybe could be a sub-category page.

We want to tag our articles (topic-tags, not revision-tags). And then display "Related Articles", based on those tags.

This article describes a method using SemanticWiki, https://clkoerner.com/2012/08/28/use-semantic-mediawiki-semantic-forms-to-create-a-folksonomy-for-tagging-related-pages/ but that seems a heavy solution, since we don't need any other SemanticWiki features. Would prefer a simpler method.

Can't use Categories, as we're already using Categories as Categories, for organizing and TOC. We consider Categories and Tags to be different concepts. That Folksonomy article agrees. Eg:

  • Category is Fruit.
  • Title is Oranges.
  • Tags are citrus, segmented, juicy, vitamin C, cold prevention, breakfast


  • Category: Books
  • Title: Cien Años de Soledad
  • Tags: Spanish, surrealism, Colombia, magical realism, Latin American

Tags vs. Categories:

  • Non-hierarchical: We use Category as a hierarchical organizing structure. We want articles to appear in only one Category in TOC, but articles can have multiple tags. Tags are non-hierarchical, and can apply across different Categories.
  • Permissions: We want separate permissions for allowing users to add Tags and Categories to an article.
  • Hidden: Tags should be hidden from Extension:CategoryTree. Tags should not be listed in any Special page, Transclude, or MagicWord that lists Categories.

Need Help on Additional Steps Guide[edit]

Hi, I've downloaded and install in extension folder with wfloadextension at locasettings.php, and the version page is showing the extension. And how do I actually show related articles in all pages as I thought the steps of using this extension is just steps mentioned above? Trying around and added the $wgRelatedArticlesFooterWhitelistedSkins = ['vector'] on localsettings.php but couldn't show related articles with the thumbnail on any pages. Thanks a lot for the help.

How to set number of displaced Related Articles?[edit]

E.g. we want 5 article link blocks instead of default 3. --Zoglun (talk) 06:48, 30 December 2018 (UTC)

A: You can add the following line to your LocalSettings.php - $wgRelatedArticlesCardLimit= 5; -- 14:00, 8 January 2019 (UTC)

The source code to handle this is incorrect: includes/Hooks.php --> onResourceLoaderGetConfigVars The correct source code is the following:

	public static function onResourceLoaderGetConfigVars( &$vars ) {
		$config = MediaWikiServices::getInstance()->getConfigFactory()
			->makeConfig( 'RelatedArticles' );
		$vars['wgRelatedArticlesLoggingBucketSize'] =
			$config->get( 'RelatedArticlesLoggingBucketSize' );
			= $config->get( 'RelatedArticlesEnabledBucketSize' );
			= $config->get( 'RelatedArticlesCardLimit' );

		$limit = $vars['wgRelatedArticlesCardLimit'];
		if ( $limit < 1 || $limit > 20 ) {
			throw new \RuntimeException(
				'The value of wgRelatedArticlesCardLimit is not valid. It should be between 1 and 20.'
		return true;