MediaWiki  1.27.2
UsersPager.php
Go to the documentation of this file.
1 <?php
33 class UsersPager extends AlphabeticPager {
34 
38  protected $userGroupCache;
39 
46  function __construct( IContextSource $context = null, $par = null, $including = null ) {
47  if ( $context ) {
48  $this->setContext( $context );
49  }
50 
51  $request = $this->getRequest();
52  $par = ( $par !== null ) ? $par : '';
53  $parms = explode( '/', $par );
54  $symsForAll = [ '*', 'user' ];
55 
56  if ( $parms[0] != '' &&
57  ( in_array( $par, User::getAllGroups() ) || in_array( $par, $symsForAll ) )
58  ) {
59  $this->requestedGroup = $par;
60  $un = $request->getText( 'username' );
61  } elseif ( count( $parms ) == 2 ) {
62  $this->requestedGroup = $parms[0];
63  $un = $parms[1];
64  } else {
65  $this->requestedGroup = $request->getVal( 'group' );
66  $un = ( $par != '' ) ? $par : $request->getText( 'username' );
67  }
68 
69  if ( in_array( $this->requestedGroup, $symsForAll ) ) {
70  $this->requestedGroup = '';
71  }
72  $this->editsOnly = $request->getBool( 'editsOnly' );
73  $this->creationSort = $request->getBool( 'creationSort' );
74  $this->including = $including;
75  $this->mDefaultDirection = $request->getBool( 'desc' )
78 
79  $this->requestedUser = '';
80 
81  if ( $un != '' ) {
83 
84  if ( !is_null( $username ) ) {
85  $this->requestedUser = $username->getText();
86  }
87  }
88 
89  parent::__construct();
90  }
91 
95  function getIndexField() {
96  return $this->creationSort ? 'user_id' : 'user_name';
97  }
98 
102  function getQueryInfo() {
103  $dbr = wfGetDB( DB_SLAVE );
104  $conds = [];
105 
106  // Don't show hidden names
107  if ( !$this->getUser()->isAllowed( 'hideuser' ) ) {
108  $conds[] = 'ipb_deleted IS NULL OR ipb_deleted = 0';
109  }
110 
111  $options = [];
112 
113  if ( $this->requestedGroup != '' ) {
114  $conds['ug_group'] = $this->requestedGroup;
115  }
116 
117  if ( $this->requestedUser != '' ) {
118  # Sorted either by account creation or name
119  if ( $this->creationSort ) {
120  $conds[] = 'user_id >= ' . intval( User::idFromName( $this->requestedUser ) );
121  } else {
122  $conds[] = 'user_name >= ' . $dbr->addQuotes( $this->requestedUser );
123  }
124  }
125 
126  if ( $this->editsOnly ) {
127  $conds[] = 'user_editcount > 0';
128  }
129 
130  $options['GROUP BY'] = $this->creationSort ? 'user_id' : 'user_name';
131 
132  $query = [
133  'tables' => [ 'user', 'user_groups', 'ipblocks' ],
134  'fields' => [
135  'user_name' => $this->creationSort ? 'MAX(user_name)' : 'user_name',
136  'user_id' => $this->creationSort ? 'user_id' : 'MAX(user_id)',
137  'edits' => 'MAX(user_editcount)',
138  'creation' => 'MIN(user_registration)',
139  'ipb_deleted' => 'MAX(ipb_deleted)' // block/hide status
140  ],
141  'options' => $options,
142  'join_conds' => [
143  'user_groups' => [ 'LEFT JOIN', 'user_id=ug_user' ],
144  'ipblocks' => [
145  'LEFT JOIN', [
146  'user_id=ipb_user',
147  'ipb_auto' => 0
148  ]
149  ],
150  ],
151  'conds' => $conds
152  ];
153 
154  Hooks::run( 'SpecialListusersQueryInfo', [ $this, &$query ] );
155 
156  return $query;
157  }
158 
163  function formatRow( $row ) {
164  if ( $row->user_id == 0 ) { # Bug 16487
165  return '';
166  }
167 
168  $userName = $row->user_name;
169 
170  $ulinks = Linker::userLink( $row->user_id, $userName );
172  $row->user_id,
173  $userName,
174  (int)$row->edits
175  );
176 
177  $lang = $this->getLanguage();
178 
179  $groups = '';
180  $groups_list = self::getGroups( intval( $row->user_id ), $this->userGroupCache );
181 
182  if ( !$this->including && count( $groups_list ) > 0 ) {
183  $list = [];
184  foreach ( $groups_list as $group ) {
185  $list[] = self::buildGroupLink( $group, $userName );
186  }
187  $groups = $lang->commaList( $list );
188  }
189 
190  $item = $lang->specialList( $ulinks, $groups );
191 
192  if ( $row->ipb_deleted ) {
193  $item = "<span class=\"deleted\">$item</span>";
194  }
195 
196  $edits = '';
197  if ( !$this->including && $this->getConfig()->get( 'Edititis' ) ) {
198  $count = $this->msg( 'usereditcount' )->numParams( $row->edits )->escaped();
199  $edits = $this->msg( 'word-separator' )->escaped() . $this->msg( 'brackets', $count )->escaped();
200  }
201 
202  $created = '';
203  # Some rows may be null
204  if ( !$this->including && $row->creation ) {
205  $user = $this->getUser();
206  $d = $lang->userDate( $row->creation, $user );
207  $t = $lang->userTime( $row->creation, $user );
208  $created = $this->msg( 'usercreated', $d, $t, $row->user_name )->escaped();
209  $created = ' ' . $this->msg( 'parentheses' )->rawParams( $created )->escaped();
210  }
211  $blocked = !is_null( $row->ipb_deleted ) ?
212  ' ' . $this->msg( 'listusers-blocked', $userName )->escaped() :
213  '';
214 
215  Hooks::run( 'SpecialListusersFormatRow', [ &$item, $row ] );
216 
217  return Html::rawElement( 'li', [], "{$item}{$edits}{$created}{$blocked}" );
218  }
219 
220  function doBatchLookups() {
221  $batch = new LinkBatch();
222  $userIds = [];
223  # Give some pointers to make user links
224  foreach ( $this->mResult as $row ) {
225  $batch->add( NS_USER, $row->user_name );
226  $batch->add( NS_USER_TALK, $row->user_name );
227  $userIds[] = $row->user_id;
228  }
229 
230  // Lookup groups for all the users
231  $dbr = wfGetDB( DB_SLAVE );
232  $groupRes = $dbr->select(
233  'user_groups',
234  [ 'ug_user', 'ug_group' ],
235  [ 'ug_user' => $userIds ],
236  __METHOD__
237  );
238  $cache = [];
239  $groups = [];
240  foreach ( $groupRes as $row ) {
241  $cache[intval( $row->ug_user )][] = $row->ug_group;
242  $groups[$row->ug_group] = true;
243  }
244  $this->userGroupCache = $cache;
245 
246  // Add page of groups to link batch
247  foreach ( $groups as $group => $unused ) {
248  $groupPage = User::getGroupPage( $group );
249  if ( $groupPage ) {
250  $batch->addObj( $groupPage );
251  }
252  }
253 
254  $batch->execute();
255  $this->mResult->rewind();
256  }
257 
261  function getPageHeader() {
262  list( $self ) = explode( '/', $this->getTitle()->getPrefixedDBkey() );
263 
264  $this->getOutput()->addModules( 'mediawiki.userSuggest' );
265 
266  # Form tag
268  'form',
269  [ 'method' => 'get', 'action' => wfScript(), 'id' => 'mw-listusers-form' ]
270  ) .
271  Xml::fieldset( $this->msg( 'listusers' )->text() ) .
272  Html::hidden( 'title', $self );
273 
274  # Username field (with autocompletion support)
275  $out .= Xml::label( $this->msg( 'listusersfrom' )->text(), 'offset' ) . ' ' .
276  Html::input(
277  'username',
278  $this->requestedUser,
279  'text',
280  [
281  'class' => 'mw-autocomplete-user',
282  'id' => 'offset',
283  'size' => 20,
284  'autofocus' => $this->requestedUser === ''
285  ]
286  ) . ' ';
287 
288  # Group drop-down list
289  $sel = new XmlSelect( 'group', 'group', $this->requestedGroup );
290  $sel->addOption( $this->msg( 'group-all' )->text(), '' );
291  foreach ( $this->getAllGroups() as $group => $groupText ) {
292  $sel->addOption( $groupText, $group );
293  }
294 
295  $out .= Xml::label( $this->msg( 'group' )->text(), 'group' ) . ' ';
296  $out .= $sel->getHTML() . '<br />';
298  $this->msg( 'listusers-editsonly' )->text(),
299  'editsOnly',
300  'editsOnly',
301  $this->editsOnly
302  );
303  $out .= '&#160;';
305  $this->msg( 'listusers-creationsort' )->text(),
306  'creationSort',
307  'creationSort',
308  $this->creationSort
309  );
310  $out .= '&#160;';
312  $this->msg( 'listusers-desc' )->text(),
313  'desc',
314  'desc',
315  $this->mDefaultDirection
316  );
317  $out .= '<br />';
318 
319  Hooks::run( 'SpecialListusersHeaderForm', [ $this, &$out ] );
320 
321  # Submit button and form bottom
322  $out .= Html::hidden( 'limit', $this->mLimit );
323  $out .= Xml::submitButton( $this->msg( 'listusers-submit' )->text() );
324  Hooks::run( 'SpecialListusersHeader', [ $this, &$out ] );
325  $out .= Xml::closeElement( 'fieldset' ) .
326  Xml::closeElement( 'form' );
327 
328  return $out;
329  }
330 
335  function getAllGroups() {
336  $result = [];
337  foreach ( User::getAllGroups() as $group ) {
338  $result[$group] = User::getGroupName( $group );
339  }
340  asort( $result );
341 
342  return $result;
343  }
344 
349  function getDefaultQuery() {
350  $query = parent::getDefaultQuery();
351  if ( $this->requestedGroup != '' ) {
352  $query['group'] = $this->requestedGroup;
353  }
354  if ( $this->requestedUser != '' ) {
355  $query['username'] = $this->requestedUser;
356  }
357  Hooks::run( 'SpecialListusersDefaultQuery', [ $this, &$query ] );
358 
359  return $query;
360  }
361 
369  protected static function getGroups( $uid, $cache = null ) {
370  if ( $cache === null ) {
371  $user = User::newFromId( $uid );
372  $effectiveGroups = $user->getEffectiveGroups();
373  } else {
374  $effectiveGroups = isset( $cache[$uid] ) ? $cache[$uid] : [];
375  }
376  $groups = array_diff( $effectiveGroups, User::getImplicitGroups() );
377 
378  return $groups;
379  }
380 
388  protected static function buildGroupLink( $group, $username ) {
390  $group,
392  );
393  }
394 
395 }
const DIR_DESCENDING
Definition: IndexPager.php:73
setContext(IContextSource $context)
Set the IContextSource object.
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition: deferred.txt:11
Interface for objects which can provide a MediaWiki context on request.
wfGetDB($db, $groups=[], $wiki=false)
Get a Database object.
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output $out
Definition: hooks.txt:762
within a display generated by the Derivative if and wherever such third party notices normally appear The contents of the NOTICE file are for informational purposes only and do not modify the License You may add Your own attribution notices within Derivative Works that You alongside or as an addendum to the NOTICE text from the provided that such additional attribution notices cannot be construed as modifying the License You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for or distribution of Your or for any such Derivative Works as a provided Your and distribution of the Work otherwise complies with the conditions stated in this License Submission of Contributions Unless You explicitly state any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this without any additional terms or conditions Notwithstanding the nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions Trademarks This License does not grant permission to use the trade service or product names of the except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file Disclaimer of Warranty Unless required by applicable law or agreed to in Licensor provides the WITHOUT WARRANTIES OR CONDITIONS OF ANY either express or including
null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
Definition: hooks.txt:1418
getLanguage()
Get the Language object.
This class is used to get a list of user.
Definition: UsersPager.php:33
wfScript($script= 'index')
Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScri...
static getImplicitGroups()
Get a list of implicit groups.
Definition: User.php:4673
static rawElement($element, $attribs=[], $contents= '')
Returns an HTML element in a string.
Definition: Html.php:210
if(!isset($args[0])) $lang
IndexPager with an alphabetic list and a formatted navigation bar.
static hidden($name, $value, array $attribs=[])
Convenience function to produce an input element with type=hidden.
Definition: Html.php:759
Class for generating HTML " element.
Definition: Html.php:676
static idFromName($name, $flags=self::READ_NORMAL)
Get database id given a user name.
Definition: User.php:770
$count
static checkLabel($label, $name, $id, $checked=false, $attribs=[])
Convenience function to build an HTML checkbox with a label.
Definition: Xml.php:420
const NS_USER_TALK
Definition: Defines.php:72
const DIR_ASCENDING
Constants for the $mDefaultDirection field.
Definition: IndexPager.php:72
static getGroups($uid, $cache=null)
Get a list of groups the specified user belongs to.
Definition: UsersPager.php:369
getUser()
Get the User object.
formatRow($row)
Definition: UsersPager.php:163
getOutput()
Get the OutputPage object.