Add $wgContribScoreIgnoreMinorEdits, bug fixes

A comprehensive list of changes made in this commit is provided in the
README for this fork.

.eslintrc.json

@@ -1,7 +1,7 @@
 {
 	"root": true,
 	"extends": [
-		"wikimedia/client-es5",
+		"wikimedia/client",
 		"wikimedia/jquery",
 		"wikimedia/mediawiki"
 	]

ContributionScores.alias.php

@@ -268,12 +268,17 @@ $specialPageAliases['uk'] = [
 	'ContributionScores' => [ 'Очки_внеску', 'Очки_вклада' ],
 ];
 
-/** Simplified Chinese (中文（简体）‎) */
+/** Chinese (中文) */
+$specialPageAliases['zh'] = [
+	'ContributionScores' => [ 'ContributionScores' ],
+];
+
+/** Simplified Chinese (中文（简体）) */
 $specialPageAliases['zh-hans'] = [
 	'ContributionScores' => [ '贡献得分' ],
 ];
 
-/** Traditional Chinese (中文（繁體）‎) */
+/** Traditional Chinese (中文（繁體）) */
 $specialPageAliases['zh-hant'] = [
 	'ContributionScores' => [ '貢獻分數' ],
 ];

README

@@ -1,2 +1,28 @@
 The Contribution Scores extension polls the wiki database to locate contributors with the highest contribution volume.
 The extension is intended to add a fun metric for contributors to see how much they are helping out.
+
+--- TEAR HERE ---
+
+This is a modified version of Extension:Contribution Scores, the original source
+code for which can be found here: https://www.mediawiki.org/wiki/Extension:Contribution_Scores
+The rest of this document discussed changes made to this copy of the extension.
+
+This fork developed by Eunakria the config option $wgContribScoreIgnoreMinorEdits,
+which is mutually exclusive with $wgContribScoreUseRoughEditCount.
+
+In addition to providing the aforementioned bug fixes, this fork also fixes two
+other unwanted behaviors exhibited by the original extension:
+
+1. When $wgContribScoreUseRoughEditCount was enabled, the extension would query
+   the user_editcount field of the user table but not actually join on the user
+   table, in the parser function {{#cscore}}. This was presumably never noticed
+   since this parser function is not frequently used.
+
+2. On some databases, there was a potential for integer underflow when
+   subtracting unsigned values in both the parser function and contribution
+   score data. This could occur if $wgContribScoreUseRoughEditCount was enabled
+   and edits went uncounted in user_editcount, and was resolved by clamping the
+   right-hand side preimage of subtraction.
+
+There are probably more bugs I don't know about, both in the original upstream
+code *and* my code! In other words, caveat emptor.

composer.json

@@ -1,9 +1,9 @@
 {
 	"require-dev": {
-		"mediawiki/mediawiki-codesniffer": "40.0.1",
-		"mediawiki/minus-x": "1.1.1",
+		"mediawiki/mediawiki-codesniffer": "51.0.0",
+		"mediawiki/minus-x": "2.0.1",
 		"php-parallel-lint/php-console-highlighter": "1.0.0",
-		"php-parallel-lint/php-parallel-lint": "1.3.2"
+		"php-parallel-lint/php-parallel-lint": "1.4.0"
 	},
 	"scripts": {
 		"fix": [
@@ -16,5 +16,10 @@
 			"minus-x check ."
 		],
 		"phpcs": "phpcs -sp --cache"
+	},
+	"config": {
+		"allow-plugins": {
+			"dealerdirect/phpcodesniffer-composer-installer": true
+		}
 	}
 }

extension.json

@@ -1,12 +1,12 @@
 {
 	"name": "ContributionScores",
-	"author": "Tim Laqua",
-	"url": "https://www.mediawiki.org/wiki/Extension:Contribution_Scores",
+	"author": "Tim Laqua (modified by Eunakria)",
+	"url": "https://git.eunakria.com/Eunakria/mediawiki-extensions-ContributionScores",
 	"descriptionmsg": "contributionscores-desc",
 	"version": "1.26.1",
 	"type": "specialpage",
 	"requires": {
-		"MediaWiki": ">= 1.34.0"
+		"MediaWiki": ">= 1.40.0"
 	},
 	"SpecialPages": {
 		"ContributionScores": "ContributionScores"
@@ -53,7 +53,11 @@
 		},
 		"ContribScoreUseRoughEditCount": {
 			"value": false,
-			"description": "Set to true to use the rough number of edits in user table, for performance issue."
+			"description": "Set to true to use the rough number of edits in user table, for performance issue. Mutually exclusive with $ContribScoreIgnoreMinorEdits; this option will be disabled if the other is enabled."
+		},
+		"ContribScoreIgnoreMinorEdits": {
+			"value": false,
+			"description": "Set to true to ignore minor edits. Mutually exclusive with $wgContribScoreUseRoughEditCount; if this is enabled, the other option will be disabled."
 		},
 		"ContribScoreCacheTTL": {
 			"value": 30,

package.json

@@ -5,9 +5,9 @@
 		"test": "grunt test"
 	},
 	"devDependencies": {
-		"eslint-config-wikimedia": "0.22.1",
-		"grunt": "1.5.3",
-		"grunt-banana-checker": "0.10.0",
-		"grunt-eslint": "24.0.0"
+		"eslint-config-wikimedia": "0.32.4",
+		"grunt": "1.6.2",
+		"grunt-banana-checker": "0.13.0",
+		"grunt-eslint": "24.3.0"
 	}
 }

src/ContributionScores.php

@@ -3,7 +3,10 @@
  * \brief Contains code for the ContributionScores Class (extends SpecialPage).
  */
 
+use MediaWiki\Html\Html;
+use MediaWiki\Linker\Linker;
 use MediaWiki\MediaWikiServices;
+use MediaWiki\User\ActorMigration;
 
 /// Special page class for the Contribution Scores extension
 /**
@@ -13,6 +16,7 @@ use MediaWiki\MediaWikiServices;
  *
  * @ingroup Extensions
  * @author Tim Laqua <t.laqua@gmail.com>
+ * @author Eunakria <eunakria@gmail.com>
  */
 class ContributionScores extends IncludableSpecialPage {
 	const CONTRIBUTIONSCORES_MAXINCLUDELIMIT = 50;
@@ -25,49 +29,105 @@ class ContributionScores extends IncludableSpecialPage {
 		$parser->setFunctionHook( 'cscore', [ self::class, 'efContributionScoresRender' ] );
 	}
 
+	/**
+	 * See extension.json; this function returns whether or not to use the
+	 * "rough edit count" (user_editcount, stored in the user table). Since
+	 * ignoring minor edits is mutually exclusive with this and takes priority,
+	 * we check here.
+	 */
+	private static function shouldUseRoughEditCount(): bool {
+		global $wgContribScoreIgnoreMinorEdits, $wgContribScoreUseRoughEditCount;
+		return $wgContribScoreUseRoughEditCount && !$wgContribScoreIgnoreMinorEdits;
+	}
+
 	public static function efContributionScoresRender( $parser, $usertext, $metric = 'score' ) {
-		global $wgContribScoreDisableCache, $wgContribScoreUseRoughEditCount;
+		global $wgContribScoreDisableCache, $wgContribScoreIgnoreMinorEdits;
 
 		if ( $wgContribScoreDisableCache ) {
 			$parser->getOutput()->updateCacheExpiry( 0 );
 		}
 
 		$user = User::newFromName( $usertext );
-		$dbr = wfGetDB( DB_REPLICA );
+		$loadBalancer = MediaWikiServices::getInstance()->getDBLoadBalancer();
+		$dbr = $loadBalancer->getConnection( DB_REPLICA );
 
 		if ( $user instanceof User && $user->isRegistered() ) {
 			global $wgLang;
-			$revVar = $wgContribScoreUseRoughEditCount ? 'user_editcount' : 'COUNT(rev_id)';
+			$revVar = self::shouldUseRoughEditCount() ? 'user_editcount' : 'COUNT(rev_id)';
 
 			$revWhere = ActorMigration::newMigration()->getWhere( $dbr, 'rev_user', $user );
+			$revConds = (array)$revWhere['conds'];
+			if ( $wgContribScoreIgnoreMinorEdits ) {
+				$revConds['rev_minor_edit'] = 0;
+			}
+
+			# HACK: The original ContributionScores doesn't actually join on
+			# user despite querying on user... again not our fault, but
+			# definitely our problem. What a mess...
+			$revTables = array_merge([ 'revision' ], $revWhere['tables']);
+			$revJoins = $revWhere['joins'];
+			if ( self::shouldUseRoughEditCount() && !in_array( 'user', $revTables ) ) {
+				# Not familiar enough with MediaWiki to know if this is the
+				# right way to do things, but it seems like it. The
+				# ActorMigration class is deprecated and I think I'm supposed
+				# to just join on the bare names?
+				$revTables[] = 'actor';
+				$revTables[] = 'user';
+				$revJoins['actor'] = [ 'JOIN', 'rev_actor = actor_id' ];
+				$revJoins['user'] = [ 'JOIN', 'actor_user = user_id' ];
+			}
+
+			# HACK: This is not our fault (this bug exists in the original
+			# ContributionScores as well!) but in cases where the rough edit
+			# count underestimates the number of revisions, on MariaDB the
+			# unsigned subtraction can underflow, which will throw an error.
+			# So we have to clamp the subtraction rhs.
+			#
+			# Confused by buildLeast's API? Yeah, me too. It eventually
+			# dispatches to buildSuperlative, which looks like this:
+			# https://doc.wikimedia.org/mediawiki-core/master/php/SQLPlatform_8php_source.html#l00127
+			# The way to smuggle in an existing expression is by passing it as
+			# an array element with a non-integer key to the $fields argument,
+			# which is what we do here.
+			#
+			# Of course the use of buildLeast is necessitated by the fact that
+			# MariaDB and Postgres call it "LEAST", but SQLite calls it "MIN"
+			# (a more intuitive name, but the same as the aggregate function).
+			#
+			$clampedRhsSql = $dbr->buildLeast (
+				/* $fields: */ [ 'lhs' => $revVar, 'rhs' => 'COUNT(DISTINCT rev_page)' ],
+				/* $values: */ []
+			);
+			$wikiRankSql = "COUNT(DISTINCT rev_page) + SQRT($revVar-$clampedRhsSql) * 2";
+
 			if ( $metric == 'score' ) {
 				$row = $dbr->selectRow(
-					[ 'revision' ] + $revWhere['tables'],
-					[ 'wiki_rank' => "COUNT(DISTINCT rev_page)+SQRT($revVar-COUNT(DISTINCT rev_page))*2" ],
-					$revWhere['conds'],
+					$revTables,
+					[ 'wiki_rank' => $wikiRankSql ],
+					$revConds,
 					__METHOD__,
 					[],
-					$revWhere['joins']
+					$revJoins
 				);
 				$output = $wgLang->formatNum( round( $row->wiki_rank, 0 ) );
 			} elseif ( $metric == 'changes' ) {
 				$row = $dbr->selectRow(
-					[ 'revision' ] + $revWhere['tables'],
+					$revTables,
 					[ 'rev_count' => $revVar ],
-					$revWhere['conds'],
+					$revConds,
 					__METHOD__,
 					[],
-					$revWhere['joins']
+					$revJoins
 				);
 				$output = $wgLang->formatNum( $row->rev_count );
 			} elseif ( $metric == 'pages' ) {
 				$row = $dbr->selectRow(
-					[ 'revision' ] + $revWhere['tables'],
+					$revTables,
 					[ 'page_count' => 'COUNT(DISTINCT rev_page)' ],
-					$revWhere['conds'],
+					$revConds,
 					__METHOD__,
 					[],
-					$revWhere['joins']
+					$revJoins
 				);
 				$output = $wgLang->formatNum( $row->page_count );
 			} else {
@@ -76,7 +136,7 @@ class ContributionScores extends IncludableSpecialPage {
 		} else {
 			$output = wfMessage( 'contributionscores-invalidusername' )->text();
 		}
-		return $parser->insertStripItem( $output, $parser->mStripState );
+		return $parser->insertStripItem( $output, $parser->getStripState() );
 	}
 
 	/**
@@ -88,9 +148,10 @@ class ContributionScores extends IncludableSpecialPage {
 	 */
 	public static function getContributionScoreData( $days, $limit ) {
 		global $wgContribScoreIgnoreBots, $wgContribScoreIgnoreBlockedUsers, $wgContribScoreIgnoreUsernames,
-			$wgContribScoreUseRoughEditCount;
+			$wgContribScoreIgnoreMinorEdits;
 
-		$dbr = wfGetDB( DB_REPLICA );
+		$loadBalancer = MediaWikiServices::getInstance()->getDBLoadBalancer();
+		$dbr = $loadBalancer->getConnection( DB_REPLICA );
 
 		$revQuery = ActorMigration::newMigration()->getJoin( 'rev_user' );
 		$revQuery['tables'] = array_merge( [ 'revision' ], $revQuery['tables'] );
@@ -100,6 +161,10 @@ class ContributionScores extends IncludableSpecialPage {
 
 		$sqlWhere = [];
 
+		if ( $wgContribScoreIgnoreMinorEdits ) {
+			$sqlWhere[] = 'rev_minor_edit = 0';
+		}
+
 		if ( $days > 0 ) {
 			$date = time() - ( 60 * 60 * 24 * $days );
 			$sqlWhere[] = 'rev_timestamp > ' . $dbr->addQuotes( $dbr->timestamp( $date ) );
@@ -109,7 +174,7 @@ class ContributionScores extends IncludableSpecialPage {
 			'rev_user'   => $revUser,
 			'page_count' => 'COUNT(DISTINCT rev_page)'
 		];
-		if ( $wgContribScoreUseRoughEditCount ) {
+		if ( self::shouldUseRoughEditCount() ) {
 			$revQuery['tables'][] = 'user';
 			$revQuery['joins']['user'] = [ 'LEFT JOIN', [ "$revUser != 0", "user_id = $revUser" ] ];
 			$sqlVars['rev_count'] = 'user_editcount';
@@ -119,7 +184,21 @@ class ContributionScores extends IncludableSpecialPage {
 
 		if ( $wgContribScoreIgnoreBlockedUsers ) {
 			$sqlWhere[] = "{$revUser} NOT IN " .
-				$dbr->buildSelectSubquery( 'ipblocks', 'ipb_user', 'ipb_user <> 0', __METHOD__ );
+				$dbr->buildSelectSubquery(
+					[
+						'block',
+						'block_target'
+					],
+					'bt_user',
+					'bt_user <> 0',
+					__METHOD__,
+					[],
+					[
+						'block_target' => [ 'JOIN', [
+							'bl_target=bt_id'
+						] ]
+					]
+				);
 		}
 
 		if ( $wgContribScoreIgnoreBots ) {
@@ -167,6 +246,14 @@ class ContributionScores extends IncludableSpecialPage {
 			$revQuery['joins']
 		);
 
+		# HACK: See previous comment on the use of buildLeast. Not our fault,
+		# but still our problem...
+		$clampedRhsSql = $dbr->buildLeast(
+			/* $fields: */ [ 'rev_count', 'page_count' ],
+			/* $values: */ []
+		);
+		$wikiRankSql = "page_count+SQRT(rev_count-$clampedRhsSql)*2";
+
 		$sqlMostPagesOrRevs = $dbr->unionQueries( [ $sqlMostPages, $sqlMostRevs ], false );
 		$res = $dbr->select(
 			[
@@ -179,13 +266,12 @@ class ContributionScores extends IncludableSpecialPage {
 				'user_real_name',
 				'page_count',
 				'rev_count',
-				'wiki_rank' => 'page_count+SQRT(rev_count-page_count)*2',
+				'wiki_rank' => $wikiRankSql,
 			],
 			[],
 			__METHOD__,
 			[
 				'ORDER BY' => 'wiki_rank DESC',
-				'GROUP BY' => 'user_name',
 				'LIMIT' => $limit,
 			],
 			[
@@ -361,7 +447,7 @@ class ContributionScores extends IncludableSpecialPage {
 			$reportTitle = $this->msg( 'contributionscores-allrevisions' )->text();
 		}
 		$reportTitle .= ' ' . $this->msg( 'contributionscores-top' )->numParams( $limit )->text();
-		$title = Xml::element( 'h4',
+		$title = Html::element( 'h4',
 				[ 'class' => 'contributionscores-title' ],
 				$reportTitle
 			) . "\n";
@@ -391,14 +477,14 @@ class ContributionScores extends IncludableSpecialPage {
 		$out->addWikiMsg( 'contributionscores-info' );
 
 		foreach ( $wgContribScoreReports as $scoreReport ) {
-			list( $days, $revs ) = $scoreReport;
+			[ $days, $revs ] = $scoreReport;
 			if ( $days > 0 ) {
 				$reportTitle = $this->msg( 'contributionscores-days' )->numParams( $days )->text();
 			} else {
 				$reportTitle = $this->msg( 'contributionscores-allrevisions' )->text();
 			}
 			$reportTitle .= ' ' . $this->msg( 'contributionscores-top' )->numParams( $revs )->text();
-			$title = Xml::element( 'h2',
+			$title = Html::element( 'h2',
 					[ 'class' => 'contributionscores-title' ],
 					$reportTitle
 				) . "\n";