Add support for request flagging

extension.json

@@ -167,6 +167,16 @@
 				"WikiManagerFactory"
 			]
 		},
+		"FlaggedWikis": {
+			"class": "Miraheze\\CreateWiki\\RequestWiki\\Specials\\SpecialFlaggedWikis",
+			"services": [
+				"ConnectionProvider",
+				"CreateWikiDatabaseUtils",
+				"PermissionManager",
+				"UserFactory",
+				"WikiManagerFactory"
+			]
+		},
 		"RequestWiki": {
 			"class": "Miraheze\\CreateWiki\\RequestWiki\\Specials\\SpecialRequestWiki",
 			"services": [

i18n/aliases/en.json

@@ -3,6 +3,9 @@
 		"CreateWiki": [
 			"CreateWiki"
 		],
+		"FlaggedWikis": [
+			"FlaggedWikis"
+		],
 		"RequestWiki": [
 			"RequestWiki"
 		],

i18n/en.json

@@ -33,6 +33,11 @@
 	"createwiki-error-requestcountwarn": "'''WARNING:''' [[User:$2|$2]] has already [[Special:Log/farmer/$2|requested]] $1 wikis.",
 	"createwiki-error-subdomaintaken": "The subdomain you requested is already taken. Please select another subdomain and try again.",
 	"createwiki-extensionname": "CreateWiki",
+	"createwiki-flaggedwikis-label-actor": "Flagged by",
+	"createwiki-flaggedwikis-label-reason": "Flagged reason",
+	"createwiki-flaggedwikis-label-request": "Flagged request",
+	"createwiki-flaggedwikis-label-timestamp": "Flagged at",
+	"createwiki-flaggedwikis-label-wiki": "Flagged wiki",
 	"createwiki-help-agreement": "Failure to follow these policies may lead to your wiki being closed.",
 	"createwiki-help-bio": "Make sure to follow this farm's policy on covering people.",
 	"createwiki-help-category": "The categorization of this wiki will reflect in places such as the global wiki directory.",
@@ -74,6 +79,8 @@
 	"farmer-log-name": "Farmer log",
 	"farmersuppression-log-header": "This is a private log tracking usage of the wiki request suppression function.",
 	"farmersuppression-log-name": "Suppressed wiki requests log",
+	"flaggedwikis": "Flagged wikis",
+	"flaggedwikis-info": "This page allows you to flag wikis and view all wikis that have already been flagged for later review.",
 	"ipb-action-requestwiki": "Requesting wikis",
 	"log-action-filter-farmer": "Type of action:",
 	"log-action-filter-farmer-comment": "New comment on wiki request",

includes/Hooks/Handlers/Installer.php

@@ -35,6 +35,14 @@ public function onLoadExtensionSchemaUpdates( $updater ) {
 			true,
 		] );
 
+		$updater->addExtensionUpdateOnVirtualDomain( [
+			'virtual-createwiki-central',
+			'addTable',
+			'cw_flags',
+			"$dir/cw_flags.sql",
+			true,
+		] );
+
 		$updater->addExtensionUpdateOnVirtualDomain( [
 			'virtual-createwiki',
 			'addTable',

includes/RequestWiki/FlaggedWikisPager.php

@@ -0,0 +1,140 @@
+<?php
+
+namespace Miraheze\CreateWiki\RequestWiki;
+
+use MediaWiki\Context\IContextSource;
+use MediaWiki\Html\Html;
+use MediaWiki\Linker\Linker;
+use MediaWiki\Linker\LinkRenderer;
+use MediaWiki\Pager\TablePager;
+use MediaWiki\SpecialPage\SpecialPage;
+use MediaWiki\User\UserFactory;
+use Miraheze\CreateWiki\Services\WikiManagerFactory;
+use Wikimedia\Rdbms\IConnectionProvider;
+
+class FlaggedWikisPager extends TablePager {
+
+	private LinkRenderer $linkRenderer;
+	private UserFactory $userFactory;
+	private WikiManagerFactory $wikiManagerFactory;
+
+	public function __construct(
+		IContextSource $context,
+		IConnectionProvider $connectionProvider,
+		LinkRenderer $linkRenderer,
+		UserFactory $userFactory,
+		WikiManagerFactory $wikiManagerFactory
+	) {
+		parent::__construct( $context, $linkRenderer );
+
+		$this->mDb = $connectionProvider->getReplicaDatabase( 'virtual-createwiki-central' );
+
+		$this->linkRenderer = $linkRenderer;
+		$this->userFactory = $userFactory;
+		$this->wikiManagerFactory = $wikiManagerFactory;
+	}
+
+	/** @inheritDoc */
+	public function getFieldNames(): array {
+		return [
+			'cw_flag_timestamp' => $this->msg( 'createwiki-flaggedwikis-label-timestamp' )->text(),
+			'cw_id' => $this->msg( 'createwiki-flaggedwikis-label-request' )->text(),
+			'cw_flag_dbname' => $this->msg( 'createwiki-flaggedwikis-label-wiki' )->text(),
+			'cw_flag_actor' => $this->msg( 'createwiki-flaggedwikis-label-actor' )->text(),
+			'cw_flag_reason' => $this->msg( 'createwiki-flaggedwikis-label-reason' )->text(),
+		];
+	}
+
+	/** @inheritDoc */
+	public function formatValue( $name, $value ): string {
+		$row = $this->getCurrentRow();
+
+		switch ( $name ) {
+			case 'cw_flag_timestamp':
+				$formatted = $this->escape( $this->getLanguage()->userTimeAndDate(
+					$row->cw_flag_timestamp, $this->getUser()
+				) );
+				break;
+			case 'cw_id':
+				if ( $row->cw_id > 0 ) {
+					$formatted = $this->linkRenderer->makeLink(
+						SpecialPage::getTitleValueFor( 'RequestWikiQueue', $row->cw_id ),
+						"#{$row->cw_id}"
+					);
+					break;
+				}
+
+				$formatted = '-';
+				break;
+			case 'cw_flag_reason':
+				$formatted = $this->escape( $row->cw_flag_reason );
+				break;
+			case 'cw_flag_actor':
+				$formatted = Linker::userLink(
+					$this->userFactory->newFromActorId( $row->cw_flag_actor )->getId(),
+					$this->userFactory->newFromActorId( $row->cw_flag_actor )->getName()
+				);
+				break;
+			case 'cw_flag_dbname':
+				$wikiManager = $this->wikiManagerFactory->newInstance( $row->cw_flag_dbname );
+				if ( $wikiManager->exists() ) {
+					// TODO: when we require 1.43, use LinkRenderer::makeExternalLink
+					$formatted = Html::element( 'a', [
+						'href' => $wikiManager->getUrl()
+					], $wikiManager->getUrl() );
+					break;
+				}
+
+				$formatted = $this->escape( $row->cw_flag_dbname );
+				break;
+			default:
+				$formatted = $this->escape( "Unable to format {$name}" );
+		}
+
+		return $formatted;
+	}
+
+	/**
+	 * Safely HTML-escapes $value
+	 */
+	private function escape( string $value ): string {
+		return htmlspecialchars( $value, ENT_QUOTES, 'UTF-8', false );
+	}
+
+	/** @inheritDoc */
+	public function getQueryInfo(): array {
+		$dbr = $this->getDatabase();
+
+		$info = [
+			'tables' => [
+				'cw_flags',
+			],
+			'fields' => [
+				'cw_id',
+				'cw_flag_actor',
+				'cw_flag_dbname',
+				'cw_flag_reason',
+				'cw_flag_timestamp',
+			],
+			'conds' => [
+				// TODO: all allowed visibilities
+				$dbr->expr( 'cw_flag_visibility', '=', 0 ),
+				$dbr->expr( 'cw_flag_expiry', '=', 0 )
+					->or( 'cw_flag_expiry', '>', $dbr->timestamp() )
+			],
+			'joins_conds' => [],
+		];
+
+		return $info;
+	}
+
+	/** @inheritDoc */
+	public function getDefaultSort(): string {
+		return 'cw_flag_timestamp';
+	}
+
+	/** @inheritDoc */
+	public function isFieldSortable( $name ): bool {
+		return $name !== 'cw_flag_actor';
+	}
+}

includes/RequestWiki/RequestWikiRequestViewer.php

@@ -353,6 +353,20 @@ public function getFormDescriptor(): array {
 					'default' => $this->wikiRequestManager->isLocked(),
 					'section' => 'handling',
 				],
+				'handle-flag' => [
+					'type' => 'check',
+					'label-message' => 'createwiki-label-flag',
+					'default' => (bool)$this->wikiRequestManager->getFlaggedReason(),
+					'section' => 'handling',
+				],
+				'handle-flag-reason' => [
+					'type' => 'text',
+					'label-message' => 'createwiki-label-flag-reason',
+					'hide-if' => [ '!==', 'handle-flag', '1' ],
+					'default' => $this->wikiRequestManager->getFlaggedReason(),
+					'required' => true,
+					'section' => 'handling',
+				],
 				'handle-changevisibility' => [
 					'type' => 'check',
 					'label-message' => 'revdelete-legend',
@@ -609,6 +623,13 @@ protected function submitForm(
 				}
 			}
 
+			if ( $formData['handle-flag'] ?? false ) {
+				$this->wikiRequestManager->addFlaggedRequest(
+					$formData['handle-flag-reason'],
+					$user
+				);
+			}
+
 			// Handle locking wiki request
 			if ( $this->wikiRequestManager->isLocked() !== (bool)$formData['handle-lock'] ) {
 				$this->wikiRequestManager->setLocked( (bool)$formData['handle-lock'] );