TitleBlacklistHooks.php

Go to the documentation of this file.

<?php
class TitleBlacklistHooks {
 
    public static function onUserCan( $title, $user, $action, &$result ) {
        # Some places check createpage, while others check create.
        # As it stands, upload does createpage, but normalize both
        # to the same action, to stop future similar bugs.
        if ( $action === 'createpage' || $action === 'createtalk' ) {
            $action = 'create';
        }
        if ( $action == 'create' || $action == 'edit' || $action == 'upload' ) {
            $blacklisted = TitleBlacklist::singleton()->userCannot( $title, $user, $action );
            if ( $blacklisted instanceof TitleBlacklistEntry ) {
                $errmsg = $blacklisted->getErrorMessage( 'edit' );
                $params = [
                    $blacklisted->getRaw(),
                    $title->getFullText()
                ];
                ApiResult::setIndexedTagName( $params, 'param' );
                $result = ApiMessage::create(
                    wfMessage(
                        $errmsg,
                        htmlspecialchars( $blacklisted->getRaw() ),
                        $title->getFullText()
                    ),
                    'titleblacklist-forbidden',
                    [
                        'message' => [
                            'key' => $errmsg,
                            'params' => $params,
                        ],
                        'line' => $blacklisted->getRaw(),
                        // As $errmsg usually represents a non-default message here, and ApiBase
                        // uses ->inLanguage( 'en' )->useDatabase( false ) for all messages, it will
                        // never result in useful 'info' text in the API. Try this, extra data seems
                        // to override the default.
                        'info' => 'TitleBlacklist prevents this title from being created',
                    ]
                );
                return false;
            }
        }
        return true;
    }
 
    public static function onDisplayBlacklistOverrideNotice( Title $title, $oldid, array &$notices ) {
        if ( !RequestContext::getMain()->getUser()->isAllowed( 'tboverride' ) ) {
            return;
        }
 
        $blacklisted = TitleBlacklist::singleton()->isBlacklisted(
            $title,
            $title->exists() ? 'edit' : 'create'
        );
        if ( !$blacklisted ) {
            return;
        }
 
        $params = $blacklisted->getParams();
        if ( isset( $params['autoconfirmed'] ) ) {
            return;
        }
 
        $msg = wfMessage( 'titleblacklist-warning' );
        $notices['titleblacklist'] = $msg->plaintextParams( $blacklisted->getRaw() )
            ->parseAsBlock();
    }
 
    public static function onMovePageCheckPermissions(
        Title $oldTitle, Title $newTitle, User $user, $reason, Status $status
    ) {
        $titleBlacklist = TitleBlacklist::singleton();
        $blacklisted = $titleBlacklist->userCannot( $newTitle, $user, 'move' );
        if ( !$blacklisted ) {
            $blacklisted = $titleBlacklist->userCannot( $oldTitle, $user, 'edit' );
        }
        if ( $blacklisted instanceof TitleBlacklistEntry ) {
            $status->fatal( ApiMessage::create( [
                $blacklisted->getErrorMessage( 'move' ),
                $blacklisted->getRaw(),
                $oldTitle->getFullText(),
                $newTitle->getFullText()
            ] ) );
            return false;
        }
 
        return true;
    }
 
    public static function testUserName(
        $userName, User $creatingUser, $override = true, $log = false
    ) {
        $title = Title::makeTitleSafe( NS_USER, $userName );
        $blacklisted = TitleBlacklist::singleton()->userCannot( $title, $creatingUser,
            'new-account', $override );
        if ( $blacklisted instanceof TitleBlacklistEntry ) {
            if ( $log ) {
                self::logFilterHitUsername( $creatingUser, $title, $blacklisted->getRaw() );
            }
            $message = $blacklisted->getErrorMessage( 'new-account' );
            $params = [
                $blacklisted->getRaw(),
                $userName,
            ];
            ApiResult::setIndexedTagName( $params, 'param' );
            return StatusValue::newFatal( ApiMessage::create(
                [ $message, $blacklisted->getRaw(), $userName ],
                'titleblacklist-forbidden',
                [
                    'message' => [
                        'key' => $message,
                        'params' => $params,
                    ],
                    'line' => $blacklisted->getRaw(),
                    // The text of the message probably isn't useful API info, so do this instead
                    'info' => 'TitleBlacklist prevents this username from being created',
                ]
            ) );
        }
        return StatusValue::newGood();
    }
 
    public static function onValidateBlacklist( $editor, $text, $section, &$error ) {
        $title = $editor->getTitle();
 
        if ( $title->getNamespace() == NS_MEDIAWIKI && $title->getDBkey() == 'Titleblacklist' ) {
            $blackList = TitleBlacklist::singleton();
            $bl = TitleBlacklist::parseBlacklist( $text, 'page' );
            $ok = $blackList->validate( $bl );
            if ( $ok === [] ) {
                return;
            }
 
            $errmsg = wfMessage( 'titleblacklist-invalid' )->numParams( count( $ok ) )->text();
            $errlines = '* <code>' .
                implode( "</code>\n* <code>", array_map( 'wfEscapeWikiText', $ok ) ) .
                '</code>';
            $error = Html::openElement( 'div', [ 'class' => 'errorbox' ] ) .
                $errmsg .
                "\n" .
                $errlines .
                Html::closeElement( 'div' ) . "\n" .
                Html::element( 'br', [ 'clear' => 'all' ] ) . "\n";
 
            // $error will be displayed by the edit class
        }
    }
 
    public static function onClearBlacklist(
        WikiPage $wikiPage, &$user, $content, $summary, $isminor, $iswatch, $section
    ) {
        $title = $wikiPage->getTitle();
        if ( $title->getNamespace() === NS_MEDIAWIKI && $title->getDBkey() == 'Titleblacklist' ) {
            TitleBlacklist::singleton()->invalidate();
        }
    }
 
    public static function logFilterHitUsername( $user, $title, $entry ) {
        global $wgTitleBlacklistLogHits;
        if ( $wgTitleBlacklistLogHits ) {
            $logEntry = new ManualLogEntry( 'titleblacklist', 'hit-username' );
            $logEntry->setPerformer( $user );
            $logEntry->setTarget( $title );
            $logEntry->setParameters( [
                '4::entry' => $entry,
            ] );
            $logid = $logEntry->insert();
            $logEntry->publish( $logid );
        }
    }
 
    public static function onScribuntoExternalLibraries( $engine, array &$extraLibraries ) {
        if ( $engine == 'lua' ) {
            $extraLibraries['mw.ext.TitleBlacklist'] = 'Scribunto_LuaTitleBlacklistLibrary';
        }
    }
}