SpecialActiveUsers.php

Go to the documentation of this file.

<?php
use MediaWiki\Cache\LinkBatchFactory;
use MediaWiki\User\UserGroupManager;
use Wikimedia\Rdbms\ILoadBalancer;
 
class SpecialActiveUsers extends SpecialPage {
 
    private $linkBatchFactory;
 
    private $loadBalancer;
 
    private $userGroupManager;
 
    public function __construct(
        LinkBatchFactory $linkBatchFactory,
        ILoadBalancer $loadBalancer,
        UserGroupManager $userGroupManager
    ) {
        parent::__construct( 'Activeusers' );
        $this->linkBatchFactory = $linkBatchFactory;
        $this->loadBalancer = $loadBalancer;
        $this->userGroupManager = $userGroupManager;
    }
 
    public function execute( $par ) {
        $out = $this->getOutput();
 
        $this->setHeaders();
        $this->outputHeader();
 
        $opts = new FormOptions();
 
        $opts->add( 'username', '' );
        $opts->add( 'groups', [] );
        $opts->add( 'excludegroups', [] );
        // Backwards-compatibility with old URLs
        $opts->add( 'hidebots', false, FormOptions::BOOL );
        $opts->add( 'hidesysops', false, FormOptions::BOOL );
 
        $opts->fetchValuesFromRequest( $this->getRequest() );
 
        if ( $par !== null ) {
            $opts->setValue( 'username', $par );
        }
 
        $pager = new ActiveUsersPager(
            $this->getContext(),
            $opts,
            $this->linkBatchFactory,
            $this->getHookContainer(),
            $this->loadBalancer,
            $this->userGroupManager
        );
        $usersBody = $pager->getBody();
 
        $this->buildForm();
 
        if ( $usersBody ) {
            $out->addHTML(
                $pager->getNavigationBar() .
                Html::rawElement( 'ul', [], $usersBody ) .
                $pager->getNavigationBar()
            );
            $out->addModuleStyles( 'mediawiki.interface.helpers.styles' );
        } else {
            $out->addWikiMsg( 'activeusers-noresult' );
        }
    }
 
    protected function buildForm() {
        $groups = $this->userGroupManager->listAllGroups();
 
        $options = [];
        foreach ( $groups as $group ) {
            $msg = htmlspecialchars( UserGroupMembership::getGroupName( $group ) );
            $options[$msg] = $group;
        }
        ksort( $options );
 
        // Backwards-compatibility with old URLs
        $req = $this->getRequest();
        $excludeDefault = [];
        if ( $req->getCheck( 'hidebots' ) ) {
            $excludeDefault[] = 'bot';
        }
        if ( $req->getCheck( 'hidesysops' ) ) {
            $excludeDefault[] = 'sysop';
        }
 
        $formDescriptor = [
            'username' => [
                'type' => 'user',
                'name' => 'username',
                'label-message' => 'activeusers-from',
            ],
            'groups' => [
                'type' => 'multiselect',
                'dropdown' => true,
                'flatlist' => true,
                'name' => 'groups',
                'label-message' => 'activeusers-groups',
                'options' => $options,
            ],
            'excludegroups' => [
                'type' => 'multiselect',
                'dropdown' => true,
                'flatlist' => true,
                'name' => 'excludegroups',
                'label-message' => 'activeusers-excludegroups',
                'options' => $options,
                'default' => $excludeDefault,
            ],
        ];
 
        HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() )
            // For the 'multiselect' field values to be preserved on submit
            ->setFormIdentifier( 'specialactiveusers' )
            ->setIntro( $this->getIntroText() )
            ->setWrapperLegendMsg( 'activeusers' )
            ->setSubmitTextMsg( 'activeusers-submit' )
            // prevent setting subpage and 'username' parameter at the same time
            ->setAction( $this->getPageTitle()->getLocalURL() )
            ->setMethod( 'get' )
            ->prepareForm()
            ->displayForm( false );
    }
 
    protected function getIntroText() {
        $days = $this->getConfig()->get( 'ActiveUserDays' );
 
        $intro = $this->msg( 'activeusers-intro' )->numParams( $days )->parse();
 
        // Mention the level of cache staleness...
        $dbr = $this->loadBalancer->getConnectionRef( ILoadBalancer::DB_REPLICA, 'recentchanges' );
        $rcMax = $dbr->selectField( 'recentchanges', 'MAX(rc_timestamp)', '', __METHOD__ );
        if ( $rcMax ) {
            $cTime = $dbr->selectField( 'querycache_info',
                'qci_timestamp',
                [ 'qci_type' => 'activeusers' ],
                __METHOD__
            );
            if ( $cTime ) {
                $secondsOld = wfTimestamp( TS_UNIX, $rcMax ) - wfTimestamp( TS_UNIX, $cTime );
            } else {
                $rcMin = $dbr->selectField( 'recentchanges', 'MIN(rc_timestamp)', '', __METHOD__ );
                $secondsOld = time() - wfTimestamp( TS_UNIX, $rcMin );
            }
            if ( $secondsOld > 0 ) {
                $intro .= $this->msg( 'cachedspecial-viewing-cached-ttl' )
                    ->durationParams( $secondsOld )->parseAsBlock();
            }
        }
 
        return $intro;
    }
 
    protected function getGroupName() {
        return 'users';
    }
}