SpecialTags.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;

class SpecialTags extends SpecialPage {

    protected $explicitlyDefinedTags;

    protected $softwareDefinedTags;

    protected $softwareActivatedTags;

    function __construct() {
        parent::__construct( 'Tags' );
    }

    function execute( $par ) {
        $this->setHeaders();
        $this->outputHeader();
        $this->addHelpLink( 'Manual:Tags' );

        $request = $this->getRequest();
        switch ( $par ) {
            case 'delete':
                $this->showDeleteTagForm( $request->getVal( 'tag' ) );
                break;
            case 'activate':
                $this->showActivateDeactivateForm( $request->getVal( 'tag' ), true );
                break;
            case 'deactivate':
                $this->showActivateDeactivateForm( $request->getVal( 'tag' ), false );
                break;
            case 'create':
                // fall through, thanks to HTMLForm's logic
            default:
                $this->showTagList();
                break;
        }
    }

    function showTagList() {
        $out = $this->getOutput();
        $out->setPageTitle( $this->msg( 'tags-title' ) );
        $out->wrapWikiMsg( "<div class='mw-tags-intro'>\n$1\n</div>", 'tags-intro' );

        $user = $this->getUser();
        $permissionManager = MediaWikiServices::getInstance()->getPermissionManager();
        $userCanManage = $permissionManager->userHasRight( $user, 'managechangetags' );
        $userCanDelete = $permissionManager->userHasRight( $user, 'deletechangetags' );
        $userCanEditInterface = $permissionManager->userHasRight( $user, 'editinterface' );

        // Show form to create a tag
        if ( $userCanManage ) {
            $fields = [
                'Tag' => [
                    'type' => 'text',
                    'label' => $this->msg( 'tags-create-tag-name' )->plain(),
                    'required' => true,
                ],
                'Reason' => [
                    'type' => 'text',
                    'label' => $this->msg( 'tags-create-reason' )->plain(),
                    'size' => 50,
                ],
                'IgnoreWarnings' => [
                    'type' => 'hidden',
                ],
            ];

            $form = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
            $form->setAction( $this->getPageTitle( 'create' )->getLocalURL() );
            $form->setWrapperLegendMsg( 'tags-create-heading' );
            $form->setHeaderText( $this->msg( 'tags-create-explanation' )->parseAsBlock() );
            $form->setSubmitCallback( [ $this, 'processCreateTagForm' ] );
            $form->setSubmitTextMsg( 'tags-create-submit' );
            $form->show();

            // If processCreateTagForm generated a redirect, there's no point
            // continuing with this, as the user is just going to end up getting sent
            // somewhere else. Additionally, if we keep going here, we end up
            // populating the memcache of tag data (see ChangeTags::listDefinedTags)
            // with out-of-date data from the replica DB, because the replica DB hasn't caught
            // up to the fact that a new tag has been created as part of an implicit,
            // as yet uncommitted transaction on master.
            if ( $out->getRedirect() !== '' ) {
                return;
            }
        }

        // Used to get hitcounts for #doTagRow()
        $tagStats = ChangeTags::tagUsageStatistics();

        // Used in #doTagRow()
        $this->explicitlyDefinedTags = array_fill_keys(
            ChangeTags::listExplicitlyDefinedTags(), true );
        $this->softwareDefinedTags = array_fill_keys(
            ChangeTags::listSoftwareDefinedTags(), true );

        // List all defined tags, even if they were never applied
        $definedTags = array_keys( $this->explicitlyDefinedTags + $this->softwareDefinedTags );

        // Show header only if there exists atleast one tag
        if ( !$tagStats && !$definedTags ) {
            return;
        }

        // Write the headers
        $thead = Xml::tags( 'tr', null, Xml::tags( 'th', null, $this->msg( 'tags-tag' )->parse() ) .
            Xml::tags( 'th', null, $this->msg( 'tags-display-header' )->parse() ) .
            Xml::tags( 'th', null, $this->msg( 'tags-description-header' )->parse() ) .
            Xml::tags( 'th', null, $this->msg( 'tags-source-header' )->parse() ) .
            Xml::tags( 'th', null, $this->msg( 'tags-active-header' )->parse() ) .
            Xml::tags( 'th', null, $this->msg( 'tags-hitcount-header' )->parse() ) .
            ( ( $userCanManage || $userCanDelete ) ?
                Xml::tags( 'th', [ 'class' => 'unsortable' ],
                    $this->msg( 'tags-actions-header' )->parse() ) :
                '' )
        );

        $tbody = '';
        // Used in #doTagRow()
        $this->softwareActivatedTags = array_fill_keys(
            ChangeTags::listSoftwareActivatedTags(), true );

        // Insert tags that have been applied at least once
        foreach ( $tagStats as $tag => $hitcount ) {
            $tbody .= $this->doTagRow( $tag, $hitcount, $userCanManage,
                $userCanDelete, $userCanEditInterface );
        }
        // Insert tags defined somewhere but never applied
        foreach ( $definedTags as $tag ) {
            if ( !isset( $tagStats[$tag] ) ) {
                $tbody .= $this->doTagRow( $tag, 0, $userCanManage, $userCanDelete, $userCanEditInterface );
            }
        }

        $out->addModuleStyles( 'jquery.tablesorter.styles' );
        $out->addModules( 'jquery.tablesorter' );
        $out->addHTML( Xml::tags(
            'table',
            [ 'class' => 'mw-datatable sortable mw-tags-table' ],
            Xml::tags( 'thead', null, $thead ) .
            Xml::tags( 'tbody', null, $tbody )
        ) );
    }

    function doTagRow( $tag, $hitcount, $showManageActions, $showDeleteActions, $showEditLinks ) {
        $newRow = '';
        $newRow .= Xml::tags( 'td', null, Xml::element( 'code', null, $tag ) );

        $linkRenderer = $this->getLinkRenderer();
        $disp = ChangeTags::tagDescription( $tag, $this->getContext() );
        if ( $showEditLinks ) {
            $disp .= ' ';
            $editLink = $linkRenderer->makeLink(
                $this->msg( "tag-$tag" )->inContentLanguage()->getTitle(),
                $this->msg( 'tags-edit' )->text()
            );
            $disp .= $this->msg( 'parentheses' )->rawParams( $editLink )->escaped();
        }
        $newRow .= Xml::tags( 'td', null, $disp );

        $msg = $this->msg( "tag-$tag-description" );
        $desc = !$msg->exists() ? '' : $msg->parse();
        if ( $showEditLinks ) {
            $desc .= ' ';
            $editDescLink = $linkRenderer->makeLink(
                $this->msg( "tag-$tag-description" )->inContentLanguage()->getTitle(),
                $this->msg( 'tags-edit' )->text()
            );
            $desc .= $this->msg( 'parentheses' )->rawParams( $editDescLink )->escaped();
        }
        $newRow .= Xml::tags( 'td', null, $desc );

        $sourceMsgs = [];
        $isSoftware = isset( $this->softwareDefinedTags[$tag] );
        $isExplicit = isset( $this->explicitlyDefinedTags[$tag] );
        if ( $isSoftware ) {
            // TODO: Rename this message
            $sourceMsgs[] = $this->msg( 'tags-source-extension' )->escaped();
        }
        if ( $isExplicit ) {
            $sourceMsgs[] = $this->msg( 'tags-source-manual' )->escaped();
        }
        if ( !$sourceMsgs ) {
            $sourceMsgs[] = $this->msg( 'tags-source-none' )->escaped();
        }
        $newRow .= Xml::tags( 'td', null, implode( Xml::element( 'br' ), $sourceMsgs ) );

        $isActive = $isExplicit || isset( $this->softwareActivatedTags[$tag] );
        $activeMsg = ( $isActive ? 'tags-active-yes' : 'tags-active-no' );
        $newRow .= Xml::tags( 'td', null, $this->msg( $activeMsg )->escaped() );

        $hitcountLabelMsg = $this->msg( 'tags-hitcount' )->numParams( $hitcount );
        if ( $this->getConfig()->get( 'UseTagFilter' ) ) {
            $hitcountLabel = $linkRenderer->makeLink(
                SpecialPage::getTitleFor( 'Recentchanges' ),
                $hitcountLabelMsg->text(),
                [],
                [ 'tagfilter' => $tag ]
            );
        } else {
            $hitcountLabel = $hitcountLabelMsg->escaped();
        }

        // add raw $hitcount for sorting, because tags-hitcount contains numbers and letters
        $newRow .= Xml::tags( 'td', [ 'data-sort-value' => $hitcount ], $hitcountLabel );

        $actionLinks = [];

        if ( $showDeleteActions && ChangeTags::canDeleteTag( $tag )->isOK() ) {
            $actionLinks[] = $linkRenderer->makeKnownLink(
                $this->getPageTitle( 'delete' ),
                $this->msg( 'tags-delete' )->text(),
                [],
                [ 'tag' => $tag ] );
        }

        if ( $showManageActions ) { // we've already checked that the user had the requisite userright
            if ( ChangeTags::canActivateTag( $tag )->isOK() ) {
                $actionLinks[] = $linkRenderer->makeKnownLink(
                    $this->getPageTitle( 'activate' ),
                    $this->msg( 'tags-activate' )->text(),
                    [],
                    [ 'tag' => $tag ] );
            }

            if ( ChangeTags::canDeactivateTag( $tag )->isOK() ) {
                $actionLinks[] = $linkRenderer->makeKnownLink(
                    $this->getPageTitle( 'deactivate' ),
                    $this->msg( 'tags-deactivate' )->text(),
                    [],
                    [ 'tag' => $tag ] );
            }
        }

        if ( $showDeleteActions || $showManageActions ) {
            $newRow .= Xml::tags( 'td', null, $this->getLanguage()->pipeList( $actionLinks ) );
        }

        return Xml::tags( 'tr', null, $newRow ) . "\n";
    }

    public function processCreateTagForm( array $data, HTMLForm $form ) {
        $context = $form->getContext();
        $out = $context->getOutput();

        $tag = trim( strval( $data['Tag'] ) );
        $ignoreWarnings = isset( $data['IgnoreWarnings'] ) && $data['IgnoreWarnings'] === '1';
        $status = ChangeTags::createTagWithChecks( $tag, $data['Reason'],
            $context->getUser(), $ignoreWarnings );

        if ( $status->isGood() ) {
            $out->redirect( $this->getPageTitle()->getLocalURL() );
            return true;
        } elseif ( $status->isOK() ) {
            // we have some warnings, so we show a confirmation form
            $fields = [
                'Tag' => [
                    'type' => 'hidden',
                    'default' => $data['Tag'],
                ],
                'Reason' => [
                    'type' => 'hidden',
                    'default' => $data['Reason'],
                ],
                'IgnoreWarnings' => [
                    'type' => 'hidden',
                    'default' => '1',
                ],
            ];

            // fool HTMLForm into thinking the form hasn't been submitted yet. Otherwise
            // we get into an infinite loop!
            $context->getRequest()->unsetVal( 'wpEditToken' );

            $headerText = $this->msg( 'tags-create-warnings-above', $tag,
                count( $status->getWarningsArray() ) )->parseAsBlock() .
                $out->parseAsInterface( $status->getWikiText() ) .
                $this->msg( 'tags-create-warnings-below' )->parseAsBlock();

            $subform = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
            $subform->setAction( $this->getPageTitle( 'create' )->getLocalURL() );
            $subform->setWrapperLegendMsg( 'tags-create-heading' );
            $subform->setHeaderText( $headerText );
            $subform->setSubmitCallback( [ $this, 'processCreateTagForm' ] );
            $subform->setSubmitTextMsg( 'htmlform-yes' );
            $subform->show();

            $out->addBacklinkSubtitle( $this->getPageTitle() );
            return true;
        } else {
            $out->wrapWikiTextAsInterface( 'error', $status->getWikiText() );
            return false;
        }
    }

    protected function showDeleteTagForm( $tag ) {
        $user = $this->getUser();
        if ( !MediaWikiServices::getInstance()
                ->getPermissionManager()
                ->userHasRight( $user, 'deletechangetags' ) ) {
            throw new PermissionsError( 'deletechangetags' );
        }

        $out = $this->getOutput();
        $out->setPageTitle( $this->msg( 'tags-delete-title' ) );
        $out->addBacklinkSubtitle( $this->getPageTitle() );

        // is the tag actually able to be deleted?
        $canDeleteResult = ChangeTags::canDeleteTag( $tag, $user );
        if ( !$canDeleteResult->isGood() ) {
            $out->wrapWikiTextAsInterface( 'error', $canDeleteResult->getWikiText() );
            if ( !$canDeleteResult->isOK() ) {
                return;
            }
        }

        $preText = $this->msg( 'tags-delete-explanation-initial', $tag )->parseAsBlock();
        $tagUsage = ChangeTags::tagUsageStatistics();
        if ( isset( $tagUsage[$tag] ) && $tagUsage[$tag] > 0 ) {
            $preText .= $this->msg( 'tags-delete-explanation-in-use', $tag,
                $tagUsage[$tag] )->parseAsBlock();
        }
        $preText .= $this->msg( 'tags-delete-explanation-warning', $tag )->parseAsBlock();

        // see if the tag is in use
        $this->softwareActivatedTags = array_fill_keys(
            ChangeTags::listSoftwareActivatedTags(), true );
        if ( isset( $this->softwareActivatedTags[$tag] ) ) {
            $preText .= $this->msg( 'tags-delete-explanation-active', $tag )->parseAsBlock();
        }

        $fields = [];
        $fields['Reason'] = [
            'type' => 'text',
            'label' => $this->msg( 'tags-delete-reason' )->plain(),
            'size' => 50,
        ];
        $fields['HiddenTag'] = [
            'type' => 'hidden',
            'name' => 'tag',
            'default' => $tag,
            'required' => true,
        ];

        $form = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
        $form->setAction( $this->getPageTitle( 'delete' )->getLocalURL() );
        // @phan-suppress-next-line PhanUndeclaredProperty
        $form->tagAction = 'delete'; // custom property on HTMLForm object
        $form->setSubmitCallback( [ $this, 'processTagForm' ] );
        $form->setSubmitTextMsg( 'tags-delete-submit' );
        $form->setSubmitDestructive(); // nasty!
        $form->addPreText( $preText );
        $form->show();
    }

    protected function showActivateDeactivateForm( $tag, $activate ) {
        $actionStr = $activate ? 'activate' : 'deactivate';

        $user = $this->getUser();
        if ( !MediaWikiServices::getInstance()
                ->getPermissionManager()
                ->userHasRight( $user, 'managechangetags' ) ) {
            throw new PermissionsError( 'managechangetags' );
        }

        $out = $this->getOutput();
        // tags-activate-title, tags-deactivate-title
        $out->setPageTitle( $this->msg( "tags-$actionStr-title" ) );
        $out->addBacklinkSubtitle( $this->getPageTitle() );

        // is it possible to do this?
        $func = $activate ? 'canActivateTag' : 'canDeactivateTag';
        $result = ChangeTags::$func( $tag, $user );
        if ( !$result->isGood() ) {
            $out->wrapWikiTextAsInterface( 'error', $result->getWikiText() );
            if ( !$result->isOK() ) {
                return;
            }
        }

        // tags-activate-question, tags-deactivate-question
        $preText = $this->msg( "tags-$actionStr-question", $tag )->parseAsBlock();

        $fields = [];
        // tags-activate-reason, tags-deactivate-reason
        $fields['Reason'] = [
            'type' => 'text',
            'label' => $this->msg( "tags-$actionStr-reason" )->plain(),
            'size' => 50,
        ];
        $fields['HiddenTag'] = [
            'type' => 'hidden',
            'name' => 'tag',
            'default' => $tag,
            'required' => true,
        ];

        $form = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
        $form->setAction( $this->getPageTitle( $actionStr )->getLocalURL() );
        // @phan-suppress-next-line PhanUndeclaredProperty
        $form->tagAction = $actionStr;
        $form->setSubmitCallback( [ $this, 'processTagForm' ] );
        // tags-activate-submit, tags-deactivate-submit
        $form->setSubmitTextMsg( "tags-$actionStr-submit" );
        $form->addPreText( $preText );
        $form->show();
    }

    public function processTagForm( array $data, HTMLForm $form ) {
        $context = $form->getContext();
        $out = $context->getOutput();

        $tag = $data['HiddenTag'];
        $status = call_user_func( [ ChangeTags::class, "{$form->tagAction}TagWithChecks" ],
            $tag, $data['Reason'], $context->getUser(), true );

        if ( $status->isGood() ) {
            $out->redirect( $this->getPageTitle()->getLocalURL() );
            return true;
        } elseif ( $status->isOK() && $form->tagAction === 'delete' ) {
            // deletion succeeded, but hooks raised a warning
            $out->addWikiTextAsInterface( $this->msg( 'tags-delete-warnings-after-delete', $tag,
                count( $status->getWarningsArray() ) )->text() . "\n" .
                $status->getWikitext() );
            $out->addReturnTo( $this->getPageTitle() );
            return true;
        } else {
            $out->wrapWikiTextAsInterface( 'error', $status->getWikitext() );
            return false;
        }
    }

    public function getSubpagesForPrefixSearch() {
        // The subpages does not have an own form, so not listing it at the moment
        return [
            // 'delete',
            // 'activate',
            // 'deactivate',
            // 'create',
        ];
    }

    protected function getGroupName() {
        return 'changes';
    }
}