SpecialNewpages.php

Go to the documentation of this file.

<?php
use MediaWiki\Cache\LinkBatchFactory;
use MediaWiki\CommentFormatter\CommentFormatter;
use MediaWiki\CommentStore\CommentStore;
use MediaWiki\Content\IContentHandlerFactory;
use MediaWiki\Feed\FeedItem;
use MediaWiki\Html\FormOptions;
use MediaWiki\Html\Html;
use MediaWiki\Linker\Linker;
use MediaWiki\MainConfigNames;
use MediaWiki\Permissions\GroupPermissionsLookup;
use MediaWiki\Revision\MutableRevisionRecord;
use MediaWiki\Revision\RevisionLookup;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentityValue;
use MediaWiki\User\UserOptionsLookup;
use Wikimedia\Rdbms\ILoadBalancer;
 
class SpecialNewpages extends IncludableSpecialPage {
    protected $opts;
    protected $customFilters;
 
    protected $showNavigation = false;
 
    private $linkBatchFactory;
 
    private $commentStore;
 
    private $contentHandlerFactory;
 
    private $groupPermissionsLookup;
 
    private $loadBalancer;
 
    private $revisionLookup;
 
    private $namespaceInfo;
 
    private $userOptionsLookup;
 
    private $commentFormatter;
 
    public function __construct(
        LinkBatchFactory $linkBatchFactory,
        CommentStore $commentStore,
        IContentHandlerFactory $contentHandlerFactory,
        GroupPermissionsLookup $groupPermissionsLookup,
        ILoadBalancer $loadBalancer,
        RevisionLookup $revisionLookup,
        NamespaceInfo $namespaceInfo,
        UserOptionsLookup $userOptionsLookup,
        CommentFormatter $commentFormatter
    ) {
        parent::__construct( 'Newpages' );
        $this->linkBatchFactory = $linkBatchFactory;
        $this->commentStore = $commentStore;
        $this->contentHandlerFactory = $contentHandlerFactory;
        $this->groupPermissionsLookup = $groupPermissionsLookup;
        $this->loadBalancer = $loadBalancer;
        $this->revisionLookup = $revisionLookup;
        $this->namespaceInfo = $namespaceInfo;
        $this->userOptionsLookup = $userOptionsLookup;
        $this->commentFormatter = $commentFormatter;
    }
 
    protected function setup( $par ) {
        $opts = new FormOptions();
        $this->opts = $opts; // bind
        $opts->add( 'hideliu', false );
        $opts->add(
            'hidepatrolled',
            $this->userOptionsLookup->getBoolOption( $this->getUser(), 'newpageshidepatrolled' )
        );
        $opts->add( 'hidebots', false );
        $opts->add( 'hideredirs', true );
        $opts->add(
            'limit',
            $this->userOptionsLookup->getIntOption( $this->getUser(), 'rclimit' )
        );
        $opts->add( 'offset', '' );
        $opts->add( 'namespace', '0' );
        $opts->add( 'username', '' );
        $opts->add( 'feed', '' );
        $opts->add( 'tagfilter', '' );
        $opts->add( 'invert', false );
        $opts->add( 'associated', false );
        $opts->add( 'size-mode', 'max' );
        $opts->add( 'size', 0 );
 
        $this->customFilters = [];
        $this->getHookRunner()->onSpecialNewPagesFilters( $this, $this->customFilters );
        // @phan-suppress-next-line PhanEmptyForeach False positive
        foreach ( $this->customFilters as $key => $params ) {
            $opts->add( $key, $params['default'] );
        }
 
        $opts->fetchValuesFromRequest( $this->getRequest() );
        if ( $par ) {
            $this->parseParams( $par );
        }
 
        $opts->validateIntBounds( 'limit', 0, 5000 );
    }
 
    protected function parseParams( $par ) {
        $bits = preg_split( '/\s*,\s*/', trim( $par ) );
        foreach ( $bits as $bit ) {
            if ( $bit === 'shownav' ) {
                $this->showNavigation = true;
            }
            if ( $bit === 'hideliu' ) {
                $this->opts->setValue( 'hideliu', true );
            }
            if ( $bit === 'hidepatrolled' ) {
                $this->opts->setValue( 'hidepatrolled', true );
            }
            if ( $bit === 'hidebots' ) {
                $this->opts->setValue( 'hidebots', true );
            }
            if ( $bit === 'showredirs' ) {
                $this->opts->setValue( 'hideredirs', false );
            }
            if ( is_numeric( $bit ) ) {
                $this->opts->setValue( 'limit', intval( $bit ) );
            }
 
            $m = [];
            if ( preg_match( '/^limit=(\d+)$/', $bit, $m ) ) {
                $this->opts->setValue( 'limit', intval( $m[1] ) );
            }
            // PG offsets not just digits!
            if ( preg_match( '/^offset=([^=]+)$/', $bit, $m ) ) {
                $this->opts->setValue( 'offset', intval( $m[1] ) );
            }
            if ( preg_match( '/^username=(.*)$/', $bit, $m ) ) {
                $this->opts->setValue( 'username', $m[1] );
            }
            if ( preg_match( '/^namespace=(.*)$/', $bit, $m ) ) {
                $ns = $this->getLanguage()->getNsIndex( $m[1] );
                if ( $ns !== false ) {
                    $this->opts->setValue( 'namespace', $ns );
                }
            }
        }
    }
 
    public function execute( $par ) {
        $out = $this->getOutput();
 
        $this->setHeaders();
        $this->outputHeader();
 
        $this->showNavigation = !$this->including(); // Maybe changed in setup
        $this->setup( $par );
 
        $this->addHelpLink( 'Help:New pages' );
 
        if ( !$this->including() ) {
            // Settings
            $this->form();
 
            $feedType = $this->opts->getValue( 'feed' );
            if ( $feedType ) {
                $this->feed( $feedType );
 
                return;
            }
 
            $allValues = $this->opts->getAllValues();
            unset( $allValues['feed'] );
            $out->setFeedAppendQuery( wfArrayToCgi( $allValues ) );
        }
 
        $pager = $this->getNewPagesPager();
        $pager->mLimit = $this->opts->getValue( 'limit' );
        $pager->mOffset = $this->opts->getValue( 'offset' );
 
        if ( $pager->getNumRows() ) {
            $navigation = '';
            if ( $this->showNavigation ) {
                $navigation = $pager->getNavigationBar();
            }
            $out->addHTML( $navigation . $pager->getBody() . $navigation );
            // Add styles for change tags
            $out->addModuleStyles( 'mediawiki.interface.helpers.styles' );
        } else {
            $out->addWikiMsg( 'specialpage-empty' );
        }
    }
 
    protected function filterLinks() {
        // show/hide links
        $showhide = [ $this->msg( 'show' )->escaped(), $this->msg( 'hide' )->escaped() ];
 
        // Option value -> message mapping
        $filters = [
            'hideliu' => 'newpages-showhide-registered',
            'hidepatrolled' => 'newpages-showhide-patrolled',
            'hidebots' => 'newpages-showhide-bots',
            'hideredirs' => 'newpages-showhide-redirect'
        ];
        foreach ( $this->customFilters as $key => $params ) {
            $filters[$key] = $params['msg'];
        }
 
        // Disable some if needed
        if ( !$this->canAnonymousUsersCreatePages() ) {
            unset( $filters['hideliu'] );
        }
        if ( !$this->getUser()->useNPPatrol() ) {
            unset( $filters['hidepatrolled'] );
        }
 
        $links = [];
        $changed = $this->opts->getChangedValues();
        unset( $changed['offset'] ); // Reset offset if query type changes
 
        // wfArrayToCgi(), called from LinkRenderer/Title, will not output null and false values
        // to the URL, which would omit some options (T158504). Fix it by explicitly setting them
        // to 0 or 1.
        // Also do this only for boolean options, not eg. namespace or tagfilter
        foreach ( $changed as $key => $value ) {
            if ( array_key_exists( $key, $filters ) ) {
                $changed[$key] = $changed[$key] ? '1' : '0';
            }
        }
 
        $self = $this->getPageTitle();
        $linkRenderer = $this->getLinkRenderer();
        foreach ( $filters as $key => $msg ) {
            $onoff = 1 - $this->opts->getValue( $key );
            $link = $linkRenderer->makeLink(
                $self,
                new HtmlArmor( $showhide[$onoff] ),
                [],
                [ $key => $onoff ] + $changed
            );
            $links[$key] = $this->msg( $msg )->rawParams( $link )->escaped();
        }
 
        return $this->getLanguage()->pipeList( $links );
    }
 
    protected function form() {
        $out = $this->getOutput();
 
        // Consume values
        $this->opts->consumeValue( 'offset' ); // don't carry offset, DWIW
        $namespace = $this->opts->consumeValue( 'namespace' );
        $username = $this->opts->consumeValue( 'username' );
        $tagFilterVal = $this->opts->consumeValue( 'tagfilter' );
        $nsinvert = $this->opts->consumeValue( 'invert' );
        $nsassociated = $this->opts->consumeValue( 'associated' );
 
        $size = $this->opts->consumeValue( 'size' );
        $max = $this->opts->consumeValue( 'size-mode' ) === 'max';
 
        // Check username input validity
        $ut = Title::makeTitleSafe( NS_USER, $username );
        $userText = $ut ? $ut->getText() : '';
 
        $formDescriptor = [
            'namespace' => [
                'type' => 'namespaceselect',
                'name' => 'namespace',
                'label-message' => 'namespace',
                'default' => $namespace,
            ],
            'nsinvert' => [
                'type' => 'check',
                'name' => 'invert',
                'label-message' => 'invert',
                'default' => $nsinvert,
                'tooltip' => 'invert',
            ],
            'nsassociated' => [
                'type' => 'check',
                'name' => 'associated',
                'label-message' => 'namespace_association',
                'default' => $nsassociated,
                'tooltip' => 'namespace_association',
            ],
            'tagFilter' => [
                'type' => 'tagfilter',
                'name' => 'tagfilter',
                'label-message' => 'tag-filter',
                'default' => $tagFilterVal,
            ],
            'username' => [
                'type' => 'user',
                'name' => 'username',
                'label-message' => 'newpages-username',
                'default' => $userText,
                'id' => 'mw-np-username',
                'size' => 30,
            ],
            'size' => [
                'type' => 'sizefilter',
                'name' => 'size',
                'default' => ( $max ? -1 : 1 ) * $size,
            ],
        ];
 
        $htmlForm = HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() );
 
        // Store query values in hidden fields so that form submission doesn't lose them
        foreach ( $this->opts->getUnconsumedValues() as $key => $value ) {
            $htmlForm->addHiddenField( $key, $value );
        }
 
        $htmlForm
            ->setMethod( 'get' )
            ->setFormIdentifier( 'newpagesform' )
            // The form should be visible on each request (inclusive requests with submitted forms), so
            // return always false here.
            ->setSubmitCallback(
                static function () {
                    return false;
                }
            )
            ->setSubmitTextMsg( 'newpages-submit' )
            ->setWrapperLegendMsg( 'newpages' )
            ->addFooterHtml( Html::rawElement(
                'div',
                [],
                $this->filterLinks()
            ) )
            ->show();
        $out->addModuleStyles( 'mediawiki.special' );
    }
 
    protected function revisionFromRcResult( stdClass $result, Title $title ): RevisionRecord {
        $revRecord = new MutableRevisionRecord( $title );
        $revRecord->setComment(
            $this->commentStore->getComment( 'rc_comment', $result )
        );
        $revRecord->setVisibility( (int)$result->rc_deleted );
 
        $user = new UserIdentityValue(
            (int)$result->rc_user,
            $result->rc_user_text
        );
        $revRecord->setUser( $user );
 
        return $revRecord;
    }
 
    public function formatRow( $result ) {
        $title = Title::newFromRow( $result );
 
        // Revision deletion works on revisions,
        // so cast our recent change row to a revision row.
        $revRecord = $this->revisionFromRcResult( $result, $title );
 
        $classes = [];
        $attribs = [ 'data-mw-revid' => $result->rev_id ];
 
        $lang = $this->getLanguage();
        $dm = $lang->getDirMark();
 
        $spanTime = Html::element( 'span', [ 'class' => 'mw-newpages-time' ],
            $lang->userTimeAndDate( $result->rc_timestamp, $this->getUser() )
        );
        $linkRenderer = $this->getLinkRenderer();
        $time = $linkRenderer->makeKnownLink(
            $title,
            new HtmlArmor( $spanTime ),
            [],
            [ 'oldid' => $result->rc_this_oldid ]
        );
 
        $query = $title->isRedirect() ? [ 'redirect' => 'no' ] : [];
 
        $plink = $linkRenderer->makeKnownLink(
            $title,
            null,
            [ 'class' => 'mw-newpages-pagename' ],
            $query
        );
        $linkArr = [];
        $linkArr[] = $linkRenderer->makeKnownLink(
            $title,
            $this->msg( 'hist' )->text(),
            [ 'class' => 'mw-newpages-history' ],
            [ 'action' => 'history' ]
        );
        if ( $this->contentHandlerFactory->getContentHandler( $title->getContentModel() )
            ->supportsDirectEditing()
        ) {
            $linkArr[] = $linkRenderer->makeKnownLink(
                $title,
                $this->msg( 'editlink' )->text(),
                [ 'class' => 'mw-newpages-edit' ],
                [ 'action' => 'edit' ]
            );
        }
        $links = $this->msg( 'parentheses' )->rawParams( $this->getLanguage()
            ->pipeList( $linkArr ) )->escaped();
 
        $length = Html::rawElement(
            'span',
            [ 'class' => 'mw-newpages-length' ],
            $this->msg( 'brackets' )->rawParams(
                $this->msg( 'nbytes' )->numParams( $result->length )->escaped()
            )->escaped()
        );
 
        $ulink = Linker::revUserTools( $revRecord );
        $comment = $this->commentFormatter->formatRevision( $revRecord, $this->getAuthority() );
 
        if ( $this->patrollable( $result ) ) {
            $classes[] = 'not-patrolled';
        }
 
        # Add a class for zero byte pages
        if ( $result->length == 0 ) {
            $classes[] = 'mw-newpages-zero-byte-page';
        }
 
        # Tags, if any.
        if ( isset( $result->ts_tags ) ) {
            [ $tagDisplay, $newClasses ] = ChangeTags::formatSummaryRow(
                $result->ts_tags,
                'newpages',
                $this->getContext()
            );
            $classes = array_merge( $classes, $newClasses );
        } else {
            $tagDisplay = '';
        }
 
        # Display the old title if the namespace/title has been changed
        $oldTitleText = '';
        $oldTitle = Title::makeTitle( $result->rc_namespace, $result->rc_title );
 
        if ( !$title->equals( $oldTitle ) ) {
            $oldTitleText = $oldTitle->getPrefixedText();
            $oldTitleText = Html::rawElement(
                'span',
                [ 'class' => 'mw-newpages-oldtitle' ],
                $this->msg( 'rc-old-title' )->params( $oldTitleText )->escaped()
            );
        }
 
        $ret = "{$time} {$dm}{$plink} {$links} {$dm}{$length} {$dm}{$ulink} {$comment} "
            . "{$tagDisplay} {$oldTitleText}";
 
        // Let extensions add data
        $this->getHookRunner()->onNewPagesLineEnding(
            $this, $ret, $result, $classes, $attribs );
        $attribs = array_filter( $attribs,
            [ Sanitizer::class, 'isReservedDataAttribute' ],
            ARRAY_FILTER_USE_KEY
        );
 
        if ( $classes ) {
            $attribs['class'] = $classes;
        }
 
        return Html::rawElement( 'li', $attribs, $ret ) . "\n";
    }
 
    private function getNewPagesPager() {
        return new NewPagesPager(
            $this,
            $this->groupPermissionsLookup,
            $this->getHookContainer(),
            $this->linkBatchFactory,
            $this->loadBalancer,
            $this->namespaceInfo,
            $this->opts
        );
    }
 
    protected function patrollable( $result ) {
        return ( $this->getUser()->useNPPatrol() && !$result->rc_patrolled );
    }
 
    protected function feed( $type ) {
        if ( !$this->getConfig()->get( MainConfigNames::Feed ) ) {
            $this->getOutput()->addWikiMsg( 'feed-unavailable' );
 
            return;
        }
 
        $feedClasses = $this->getConfig()->get( MainConfigNames::FeedClasses );
        if ( !isset( $feedClasses[$type] ) ) {
            $this->getOutput()->addWikiMsg( 'feed-invalid' );
 
            return;
        }
 
        $feed = new $feedClasses[$type](
            $this->feedTitle(),
            $this->msg( 'tagline' )->text(),
            $this->getPageTitle()->getFullURL()
        );
 
        $pager = $this->getNewPagesPager();
        $limit = $this->opts->getValue( 'limit' );
        $pager->mLimit = min( $limit, $this->getConfig()->get( MainConfigNames::FeedLimit ) );
 
        $feed->outHeader();
        if ( $pager->getNumRows() > 0 ) {
            foreach ( $pager->mResult as $row ) {
                $feed->outItem( $this->feedItem( $row ) );
            }
        }
        $feed->outFooter();
    }
 
    protected function feedTitle() {
        $desc = $this->getDescription();
        $code = $this->getConfig()->get( MainConfigNames::LanguageCode );
        $sitename = $this->getConfig()->get( MainConfigNames::Sitename );
 
        return "$sitename - $desc [$code]";
    }
 
    protected function feedItem( $row ) {
        $title = Title::makeTitle( intval( $row->rc_namespace ), $row->rc_title );
        if ( $title ) {
            $date = $row->rc_timestamp;
            $comments = $title->getTalkPage()->getFullURL();
 
            return new FeedItem(
                $title->getPrefixedText(),
                $this->feedItemDesc( $row ),
                $title->getFullURL(),
                $date,
                $this->feedItemAuthor( $row ),
                $comments
            );
        } else {
            return null;
        }
    }
 
    protected function feedItemAuthor( $row ) {
        return $row->rc_user_text ?? '';
    }
 
    protected function feedItemDesc( $row ) {
        $revisionRecord = $this->revisionLookup->getRevisionById( $row->rev_id );
        if ( !$revisionRecord ) {
            return '';
        }
 
        $content = $revisionRecord->getContent( SlotRecord::MAIN );
        if ( $content === null ) {
            return '';
        }
 
        // XXX: include content model/type in feed item?
        $revUser = $revisionRecord->getUser();
        $revUserText = $revUser ? $revUser->getName() : '';
        $revComment = $revisionRecord->getComment();
        $revCommentText = $revComment ? $revComment->text : '';
        return '<p>' . htmlspecialchars( $revUserText ) .
            $this->msg( 'colon-separator' )->inContentLanguage()->escaped() .
            htmlspecialchars( FeedItem::stripComment( $revCommentText ) ) .
            "</p>\n<hr />\n<div>" .
            nl2br( htmlspecialchars( $content->serialize() ) ) . "</div>";
    }
 
    private function canAnonymousUsersCreatePages() {
        return $this->groupPermissionsLookup->groupHasPermission( '*', 'createpage' ) ||
            $this->groupPermissionsLookup->groupHasPermission( '*', 'createtalk' );
    }
 
    protected function getGroupName() {
        return 'changes';
    }
 
    protected function getCacheTTL() {
        return 60 * 5;
    }
}