]> scripts.mit.edu Git - autoinstallsdev/mediawiki.git/blobdiff - includes/specials/SpecialListusers.php
MediaWiki 1.30.2
[autoinstallsdev/mediawiki.git] / includes / specials / SpecialListusers.php
index abc0363a369ebc510a8310354a5b2c97cd293497..dee2968d050a15207ef097204c7178ef2b6af4a3 100644 (file)
@@ -3,7 +3,7 @@
  * Implements Special:Listusers
  *
  * Copyright © 2004 Brion Vibber, lcrocker, Tim Starling,
- * Domas Mituzas, Ashar Voultoiz, Jens Frank, Zhengzhu,
+ * Domas Mituzas, Antoine Musso, Jens Frank, Zhengzhu,
  * 2006 Rob Church <robchur@gmail.com>
  *
  * This program is free software; you can redistribute it and/or modify
  */
 
 /**
- * This class is used to get a list of user. The ones with specials
- * rights (sysop, bureaucrat, developer) will have them displayed
- * next to their names.
- *
  * @ingroup SpecialPage
  */
-class UsersPager extends AlphabeticPager {
-
-       function __construct( $par=null ) {
-               global $wgRequest;
-               $parms = explode( '/', ($par = ( $par !== null ) ? $par : '' ) );
-               $symsForAll = array( '*', 'user' );
-               if ( $parms[0] != '' && ( in_array( $par, User::getAllGroups() ) || in_array( $par, $symsForAll ) ) ) {
-                       $this->requestedGroup = $par;
-                       $un = $wgRequest->getText( 'username' );
-               } else if ( count( $parms ) == 2 ) {
-                       $this->requestedGroup = $parms[0];
-                       $un = $parms[1];
-               } else {
-                       $this->requestedGroup = $wgRequest->getVal( 'group' );
-                       $un = ( $par != '' ) ? $par : $wgRequest->getText( 'username' );
-               }
-               if ( in_array( $this->requestedGroup, $symsForAll ) ) {
-                       $this->requestedGroup = '';
-               }
-               $this->editsOnly = $wgRequest->getBool( 'editsOnly' );
-               $this->creationSort = $wgRequest->getBool( 'creationSort' );
-
-               $this->requestedUser = '';
-               if ( $un != '' ) {
-                       $username = Title::makeTitleSafe( NS_USER, $un );
-                       if( ! is_null( $username ) ) {
-                               $this->requestedUser = $username->getText();
-                       }
-               }
-               parent::__construct();
-       }
-
-
-       function getIndexField() {
-               return $this->creationSort ? 'user_id' : 'user_name';
-       }
-
-       function getQueryInfo() {
-               global $wgUser;
-               $dbr = wfGetDB( DB_SLAVE );
-               $conds = array();
-               // Don't show hidden names
-               if( !$wgUser->isAllowed('hideuser') )
-                       $conds[] = 'ipb_deleted IS NULL';
-               if( $this->requestedGroup != '' ) {
-                       $conds['ug_group'] = $this->requestedGroup;
-                       $useIndex = '';
-               } else {
-                       $useIndex = $dbr->useIndexClause( $this->creationSort ? 'PRIMARY' : 'user_name');
-               }
-               if( $this->requestedUser != '' ) {
-                       # Sorted either by account creation or name
-                       if( $this->creationSort ) {
-                               $conds[] = 'user_id >= ' . intval( User::idFromName( $this->requestedUser ) );
-                       } else {
-                               $conds[] = 'user_name >= ' . $dbr->addQuotes( $this->requestedUser );
-                       }
-               }
-               if( $this->editsOnly ) {
-                       $conds[] = 'user_editcount > 0';
-               }
-
-               list ($user,$user_groups,$ipblocks) = $dbr->tableNamesN('user','user_groups','ipblocks');
+class SpecialListUsers extends IncludableSpecialPage {
 
-               $query = array(
-                       'tables' => " $user $useIndex LEFT JOIN $user_groups ON user_id=ug_user
-                               LEFT JOIN $ipblocks ON user_id=ipb_user AND ipb_deleted=1 AND ipb_auto=0 ",
-                       'fields' => array(
-                               $this->creationSort ? 'MAX(user_name) AS user_name' : 'user_name',
-                               $this->creationSort ? 'user_id' : 'MAX(user_id) AS user_id',
-                               'MAX(user_editcount) AS edits',
-                               'COUNT(ug_group) AS numgroups',
-                               'MAX(ug_group) AS singlegroup', // the usergroup if there is only one
-                               'MIN(user_registration) AS creation',
-                               'MAX(ipb_deleted) AS ipb_deleted' // block/hide status
-                       ),
-                       'options' => array('GROUP BY' => $this->creationSort ? 'user_id' : 'user_name'),
-                       'conds' => $conds
-               );
-
-               wfRunHooks( 'SpecialListusersQueryInfo', array( $this, &$query ) );
-               return $query;
+       public function __construct() {
+               parent::__construct( 'Listusers' );
        }
 
-       function formatRow( $row ) {
-               global $wgLang;
+       /**
+        * Show the special page
+        *
+        * @param string $par (optional) A group to list users from
+        */
+       public function execute( $par ) {
+               $this->setHeaders();
+               $this->outputHeader();
 
-               if ($row->user_id == 0) #Bug 16487
-                       return '';
+               $up = new UsersPager( $this->getContext(), $par, $this->including() );
 
-               $userPage = Title::makeTitle( NS_USER, $row->user_name );
-               $name = $this->getSkin()->link( $userPage, htmlspecialchars( $userPage->getText() ) );
+               # getBody() first to check, if empty
+               $usersbody = $up->getBody();
 
-               $groups_list = self::getGroups( $row->user_id );
-               if( count( $groups_list ) > 0 ) {
-                       $list = array();
-                       foreach( $groups_list as $group )
-                               $list[] = self::buildGroupLink( $group );
-                       $groups = $wgLang->commaList( $list );
-               } else {
-                       $groups = '';
+               $s = '';
+               if ( !$this->including() ) {
+                       $s = $up->getPageHeader();
                }
 
-               $item = wfSpecialList( $name, $groups );
-               if( $row->ipb_deleted ) {
-                       $item = "<span class=\"deleted\">$item</span>";
-               }
-
-               global $wgEdititis;
-               if ( $wgEdititis ) {
-                       $editCount = $wgLang->formatNum( $row->edits );
-                       $edits = ' [' . wfMsgExt( 'usereditcount', array( 'parsemag', 'escape' ), $editCount ) . ']';
+               if ( $usersbody ) {
+                       $s .= $up->getNavigationBar();
+                       $s .= Html::rawElement( 'ul', [], $usersbody );
+                       $s .= $up->getNavigationBar();
                } else {
-                       $edits = '';
-               }
-
-               $created = '';
-               # Some rows may be NULL
-               if( $row->creation ) {
-                       $d = $wgLang->date( wfTimestamp( TS_MW, $row->creation ), true );
-                       $t = $wgLang->time( wfTimestamp( TS_MW, $row->creation ), true );
-                       $created = ' (' . wfMsg( 'usercreated', $d, $t ) . ')';
-                       $created = htmlspecialchars( $created );
-               }
-
-               wfRunHooks( 'SpecialListusersFormatRow', array( &$item, $row ) );
-               return "<li>{$item}{$edits}{$created}</li>";
-       }
-
-       function getBody() {
-               if( !$this->mQueryDone ) {
-                       $this->doQuery();
+                       $s .= $this->msg( 'listusers-noresult' )->parseAsBlock();
                }
-               $this->mResult->rewind();
-               $batch = new LinkBatch;
-               foreach ( $this->mResult as $row ) {
-                       $batch->addObj( Title::makeTitleSafe( NS_USER, $row->user_name ) );
-               }
-               $batch->execute();
-               $this->mResult->rewind();
-               return parent::getBody();
-       }
-
-       function getPageHeader( ) {
-               global $wgScript;
-               $self = $this->getTitle();
-
-               # Form tag
-               $out  = Xml::openElement( 'form', array( 'method' => 'get', 'action' => $wgScript, 'id' => 'mw-listusers-form' ) ) .
-                       Xml::fieldset( wfMsg( 'listusers' ) ) .
-                       Html::hidden( 'title', $self->getPrefixedDbKey() );
-
-               # Username field
-               $out .= Xml::label( wfMsg( 'listusersfrom' ), 'offset' ) . ' ' .
-                       Xml::input( 'username', 20, $this->requestedUser, array( 'id' => 'offset' ) ) . ' ';
-
-               # Group drop-down list
-               $out .= Xml::label( wfMsg( 'group' ), 'group' ) . ' ' .
-                       Xml::openElement('select',  array( 'name' => 'group', 'id' => 'group' ) ) .
-                       Xml::option( wfMsg( 'group-all' ), '' );
-               foreach( $this->getAllGroups() as $group => $groupText )
-                       $out .= Xml::option( $groupText, $group, $group == $this->requestedGroup );
-               $out .= Xml::closeElement( 'select' ) . '<br />';
-               $out .= Xml::checkLabel( wfMsg('listusers-editsonly'), 'editsOnly', 'editsOnly', $this->editsOnly );
-               $out .= '&#160;';
-               $out .= Xml::checkLabel( wfMsg('listusers-creationsort'), 'creationSort', 'creationSort', $this->creationSort );
-               $out .= '<br />';
-
-               wfRunHooks( 'SpecialListusersHeaderForm', array( $this, &$out ) );
-
-               # Submit button and form bottom
-               $out .= Html::hidden( 'limit', $this->mLimit );
-               $out .= Xml::submitButton( wfMsg( 'allpagessubmit' ) );
-               wfRunHooks( 'SpecialListusersHeader', array( $this, &$out ) );
-               $out .= Xml::closeElement( 'fieldset' ) .
-                       Xml::closeElement( 'form' );
-
-               return $out;
-       }
-
-       /**
-        * Get a list of all explicit groups
-        * @return array
-        */
-       function getAllGroups() {
-               $result = array();
-               foreach( User::getAllGroups() as $group ) {
-                       $result[$group] = User::getGroupName( $group );
-               }
-               asort( $result );
-               return $result;
-       }
 
-       /**
-        * Preserve group and username offset parameters when paging
-        * @return array
-        */
-       function getDefaultQuery() {
-               $query = parent::getDefaultQuery();
-               if( $this->requestedGroup != '' )
-                       $query['group'] = $this->requestedGroup;
-               if( $this->requestedUser != '' )
-                       $query['username'] = $this->requestedUser;
-               wfRunHooks( 'SpecialListusersDefaultQuery', array( $this, &$query ) );
-               return $query;
+               $this->getOutput()->addHTML( $s );
        }
 
        /**
-        * Get a list of groups the specified user belongs to
+        * Return an array of subpages that this special page will accept.
         *
-        * @param $uid Integer: user id
-        * @return array
+        * @return string[] subpages
         */
-       protected static function getGroups( $uid ) {
-               $user = User::newFromId( $uid );
-               $groups = array_diff( $user->getEffectiveGroups(), $user->getImplicitGroups() );
-               return $groups;
+       public function getSubpagesForPrefixSearch() {
+               return User::getAllGroups();
        }
 
-       /**
-        * Format a link to a group description page
-        *
-        * @param $group String: group name
-        * @return string
-        */
-       protected static function buildGroupLink( $group ) {
-               static $cache = array();
-               if( !isset( $cache[$group] ) )
-                       $cache[$group] = User::makeGroupLinkHtml( $group, htmlspecialchars( User::getGroupMember( $group ) ) );
-               return $cache[$group];
+       protected function getGroupName() {
+               return 'users';
        }
 }
 
 /**
- * constructor
- * $par string (optional) A group to list users from
+ * Redirect page: Special:ListAdmins --> Special:ListUsers/sysop.
+ *
+ * @ingroup SpecialPage
  */
-function wfSpecialListusers( $par = null ) {
-       global $wgOut;
-
-       $up = new UsersPager($par);
+class SpecialListAdmins extends SpecialRedirectToSpecial {
+       function __construct() {
+               parent::__construct( 'Listadmins', 'Listusers', 'sysop' );
+       }
+}
 
-       # getBody() first to check, if empty
-       $usersbody = $up->getBody();
-       $s = Xml::openElement( 'div', array('class' => 'mw-spcontent') );
-       $s .= $up->getPageHeader();
-       if( $usersbody ) {
-               $s .=   $up->getNavigationBar();
-               $s .=   '<ul>' . $usersbody . '</ul>';
-               $s .=   $up->getNavigationBar() ;
-       } else {
-               $s .=   '<p>' . wfMsgHTML('listusers-noresult') . '</p>';
-       };
-       $s .= Xml::closeElement( 'div' );
-       $wgOut->addHTML( $s );
+/**
+ * Redirect page: Special:ListBots --> Special:ListUsers/bot.
+ *
+ * @ingroup SpecialPage
+ */
+class SpecialListBots extends SpecialRedirectToSpecial {
+       function __construct() {
+               parent::__construct( 'Listbots', 'Listusers', 'bot' );
+       }
 }