includes/api/ApiQueryUserInfo.php

   1 <?php
   2 /**
   3  * Copyright © 2007 Yuri Astrakhan "<Firstname><Lastname>@gmail.com"
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  */
  22
  23 use MediaWiki\MediaWikiServices;
  24
  25 /**
  26  * Query module to get information about the currently logged-in user
  27  *
  28  * @ingroup API
  29  */
  30 class ApiQueryUserInfo extends ApiQueryBase {
  31
  32         const WL_UNREAD_LIMIT = 1000;
  33
  34         private $params = [];
  35         private $prop = [];
  36
  37         public function __construct( ApiQuery $query, $moduleName ) {
  38                 parent::__construct( $query, $moduleName, 'ui' );
  39         }
  40
  41         public function execute() {
  42                 $this->params = $this->extractRequestParams();
  43                 $result = $this->getResult();
  44
  45                 if ( !is_null( $this->params['prop'] ) ) {
  46                         $this->prop = array_flip( $this->params['prop'] );
  47                 }
  48
  49                 $r = $this->getCurrentUserInfo();
  50                 $result->addValue( 'query', $this->getModuleName(), $r );
  51         }
  52
  53         /**
  54          * Get basic info about a given block
  55          * @param Block $block
  56          * @return array Array containing several keys:
  57          *  - blockid - ID of the block
  58          *  - blockedby - username of the blocker
  59          *  - blockedbyid - user ID of the blocker
  60          *  - blockreason - reason provided for the block
  61          *  - blockedtimestamp - timestamp for when the block was placed/modified
  62          *  - blockexpiry - expiry time of the block
  63          *  - systemblocktype - system block type, if any
  64          */
  65         public static function getBlockInfo( Block $block ) {
  66                 $vals = [];
  67                 $vals['blockid'] = $block->getId();
  68                 $vals['blockedby'] = $block->getByName();
  69                 $vals['blockedbyid'] = $block->getBy();
  70                 $vals['blockreason'] = $block->mReason;
  71                 $vals['blockedtimestamp'] = wfTimestamp( TS_ISO_8601, $block->mTimestamp );
  72                 $vals['blockexpiry'] = ApiResult::formatExpiry( $block->getExpiry(), 'infinite' );
  73                 $vals['blockpartial'] = !$block->isSitewide();
  74                 if ( $block->getSystemBlockType() !== null ) {
  75                         $vals['systemblocktype'] = $block->getSystemBlockType();
  76                 }
  77                 return $vals;
  78         }
  79
  80         /**
  81          * Get central user info
  82          * @param Config $config
  83          * @param User $user
  84          * @param string|null $attachedWiki
  85          * @return array Central user info
  86          *  - centralids: Array mapping non-local Central ID provider names to IDs
  87          *  - attachedlocal: Array mapping Central ID provider names to booleans
  88          *    indicating whether the local user is attached.
  89          *  - attachedwiki: Array mapping Central ID provider names to booleans
  90          *    indicating whether the user is attached to $attachedWiki.
  91          */
  92         public static function getCentralUserInfo( Config $config, User $user, $attachedWiki = null ) {
  93                 $providerIds = array_keys( $config->get( 'CentralIdLookupProviders' ) );
  94
  95                 $ret = [
  96                         'centralids' => [],
  97                         'attachedlocal' => [],
  98                 ];
  99                 ApiResult::setArrayType( $ret['centralids'], 'assoc' );
 100                 ApiResult::setArrayType( $ret['attachedlocal'], 'assoc' );
 101                 if ( $attachedWiki ) {
 102                         $ret['attachedwiki'] = [];
 103                         ApiResult::setArrayType( $ret['attachedwiki'], 'assoc' );
 104                 }
 105
 106                 $name = $user->getName();
 107                 foreach ( $providerIds as $providerId ) {
 108                         $provider = CentralIdLookup::factory( $providerId );
 109                         $ret['centralids'][$providerId] = $provider->centralIdFromName( $name );
 110                         $ret['attachedlocal'][$providerId] = $provider->isAttached( $user );
 111                         if ( $attachedWiki ) {
 112                                 $ret['attachedwiki'][$providerId] = $provider->isAttached( $user, $attachedWiki );
 113                         }
 114                 }
 115
 116                 return $ret;
 117         }
 118
 119         protected function getCurrentUserInfo() {
 120                 $user = $this->getUser();
 121                 $vals = [];
 122                 $vals['id'] = (int)$user->getId();
 123                 $vals['name'] = $user->getName();
 124
 125                 if ( $user->isAnon() ) {
 126                         $vals['anon'] = true;
 127                 }
 128
 129                 if ( isset( $this->prop['blockinfo'] ) && $user->isBlocked() ) {
 130                         $vals = array_merge( $vals, self::getBlockInfo( $user->getBlock() ) );
 131                 }
 132
 133                 if ( isset( $this->prop['hasmsg'] ) ) {
 134                         $vals['messages'] = $user->getNewtalk();
 135                 }
 136
 137                 if ( isset( $this->prop['groups'] ) ) {
 138                         $vals['groups'] = $user->getEffectiveGroups();
 139                         ApiResult::setArrayType( $vals['groups'], 'array' ); // even if empty
 140                         ApiResult::setIndexedTagName( $vals['groups'], 'g' ); // even if empty
 141                 }
 142
 143                 if ( isset( $this->prop['groupmemberships'] ) ) {
 144                         $ugms = $user->getGroupMemberships();
 145                         $vals['groupmemberships'] = [];
 146                         foreach ( $ugms as $group => $ugm ) {
 147                                 $vals['groupmemberships'][] = [
 148                                         'group' => $group,
 149                                         'expiry' => ApiResult::formatExpiry( $ugm->getExpiry() ),
 150                                 ];
 151                         }
 152                         ApiResult::setArrayType( $vals['groupmemberships'], 'array' ); // even if empty
 153                         ApiResult::setIndexedTagName( $vals['groupmemberships'], 'groupmembership' ); // even if empty
 154                 }
 155
 156                 if ( isset( $this->prop['implicitgroups'] ) ) {
 157                         $vals['implicitgroups'] = $user->getAutomaticGroups();
 158                         ApiResult::setArrayType( $vals['implicitgroups'], 'array' ); // even if empty
 159                         ApiResult::setIndexedTagName( $vals['implicitgroups'], 'g' ); // even if empty
 160                 }
 161
 162                 if ( isset( $this->prop['rights'] ) ) {
 163                         // User::getRights() may return duplicate values, strip them
 164                         $vals['rights'] = array_values( array_unique( $user->getRights() ) );
 165                         ApiResult::setArrayType( $vals['rights'], 'array' ); // even if empty
 166                         ApiResult::setIndexedTagName( $vals['rights'], 'r' ); // even if empty
 167                 }
 168
 169                 if ( isset( $this->prop['changeablegroups'] ) ) {
 170                         $vals['changeablegroups'] = $user->changeableGroups();
 171                         ApiResult::setIndexedTagName( $vals['changeablegroups']['add'], 'g' );
 172                         ApiResult::setIndexedTagName( $vals['changeablegroups']['remove'], 'g' );
 173                         ApiResult::setIndexedTagName( $vals['changeablegroups']['add-self'], 'g' );
 174                         ApiResult::setIndexedTagName( $vals['changeablegroups']['remove-self'], 'g' );
 175                 }
 176
 177                 if ( isset( $this->prop['options'] ) ) {
 178                         $vals['options'] = $user->getOptions();
 179                         $vals['options'][ApiResult::META_BC_BOOLS] = array_keys( $vals['options'] );
 180                 }
 181
 182                 if ( isset( $this->prop['preferencestoken'] ) &&
 183                         !$this->lacksSameOriginSecurity() &&
 184                         $user->isAllowed( 'editmyoptions' )
 185                 ) {
 186                         $vals['preferencestoken'] = $user->getEditToken( '', $this->getMain()->getRequest() );
 187                 }
 188
 189                 if ( isset( $this->prop['editcount'] ) ) {
 190                         // use intval to prevent null if a non-logged-in user calls
 191                         // api.php?format=jsonfm&action=query&meta=userinfo&uiprop=editcount
 192                         $vals['editcount'] = (int)$user->getEditCount();
 193                 }
 194
 195                 if ( isset( $this->prop['ratelimits'] ) ) {
 196                         $vals['ratelimits'] = $this->getRateLimits();
 197                 }
 198
 199                 if ( isset( $this->prop['realname'] ) &&
 200                         !in_array( 'realname', $this->getConfig()->get( 'HiddenPrefs' ) )
 201                 ) {
 202                         $vals['realname'] = $user->getRealName();
 203                 }
 204
 205                 if ( $user->isAllowed( 'viewmyprivateinfo' ) ) {
 206                         if ( isset( $this->prop['email'] ) ) {
 207                                 $vals['email'] = $user->getEmail();
 208                                 $auth = $user->getEmailAuthenticationTimestamp();
 209                                 if ( !is_null( $auth ) ) {
 210                                         $vals['emailauthenticated'] = wfTimestamp( TS_ISO_8601, $auth );
 211                                 }
 212                         }
 213                 }
 214
 215                 if ( isset( $this->prop['registrationdate'] ) ) {
 216                         $regDate = $user->getRegistration();
 217                         if ( $regDate !== false ) {
 218                                 $vals['registrationdate'] = wfTimestamp( TS_ISO_8601, $regDate );
 219                         }
 220                 }
 221
 222                 if ( isset( $this->prop['acceptlang'] ) ) {
 223                         $langs = $this->getRequest()->getAcceptLang();
 224                         $acceptLang = [];
 225                         foreach ( $langs as $lang => $val ) {
 226                                 $r = [ 'q' => $val ];
 227                                 ApiResult::setContentValue( $r, 'code', $lang );
 228                                 $acceptLang[] = $r;
 229                         }
 230                         ApiResult::setIndexedTagName( $acceptLang, 'lang' );
 231                         $vals['acceptlang'] = $acceptLang;
 232                 }
 233
 234                 if ( isset( $this->prop['unreadcount'] ) ) {
 235                         $store = MediaWikiServices::getInstance()->getWatchedItemStore();
 236                         $unreadNotifications = $store->countUnreadNotifications(
 237                                 $user,
 238                                 self::WL_UNREAD_LIMIT
 239                         );
 240
 241                         if ( $unreadNotifications === true ) {
 242                                 $vals['unreadcount'] = self::WL_UNREAD_LIMIT . '+';
 243                         } else {
 244                                 $vals['unreadcount'] = $unreadNotifications;
 245                         }
 246                 }
 247
 248                 if ( isset( $this->prop['centralids'] ) ) {
 249                         $vals += self::getCentralUserInfo(
 250                                 $this->getConfig(), $this->getUser(), $this->params['attachedwiki']
 251                         );
 252                 }
 253
 254                 if ( isset( $this->prop['latestcontrib'] ) ) {
 255                         $ts = $this->getLatestContributionTime();
 256                         if ( $ts !== null ) {
 257                                 $vals['latestcontrib'] = $ts;
 258                         }
 259                 }
 260
 261                 return $vals;
 262         }
 263
 264         protected function getRateLimits() {
 265                 $retval = [
 266                         ApiResult::META_TYPE => 'assoc',
 267                 ];
 268
 269                 $user = $this->getUser();
 270                 if ( !$user->isPingLimitable() ) {
 271                         return $retval; // No limits
 272                 }
 273
 274                 // Find out which categories we belong to
 275                 $categories = [];
 276                 if ( $user->isAnon() ) {
 277                         $categories[] = 'anon';
 278                 } else {
 279                         $categories[] = 'user';
 280                 }
 281                 if ( $user->isNewbie() ) {
 282                         $categories[] = 'ip';
 283                         $categories[] = 'subnet';
 284                         if ( !$user->isAnon() ) {
 285                                 $categories[] = 'newbie';
 286                         }
 287                 }
 288                 $categories = array_merge( $categories, $user->getGroups() );
 289
 290                 // Now get the actual limits
 291                 foreach ( $this->getConfig()->get( 'RateLimits' ) as $action => $limits ) {
 292                         foreach ( $categories as $cat ) {
 293                                 if ( isset( $limits[$cat] ) && !is_null( $limits[$cat] ) ) {
 294                                         $retval[$action][$cat]['hits'] = (int)$limits[$cat][0];
 295                                         $retval[$action][$cat]['seconds'] = (int)$limits[$cat][1];
 296                                 }
 297                         }
 298                 }
 299
 300                 return $retval;
 301         }
 302
 303         /**
 304          * @return string|null ISO 8601 timestamp of current user's last contribution or null if none
 305          */
 306         protected function getLatestContributionTime() {
 307                 global $wgActorTableSchemaMigrationStage;
 308
 309                 $user = $this->getUser();
 310                 $dbr = $this->getDB();
 311
 312                 if ( $wgActorTableSchemaMigrationStage & SCHEMA_COMPAT_READ_NEW ) {
 313                         if ( $user->getActorId() === null ) {
 314                                 return null;
 315                         }
 316                         $res = $dbr->selectField( 'revision_actor_temp',
 317                                 'MAX(revactor_timestamp)',
 318                                 [ 'revactor_actor' => $user->getActorId() ],
 319                                 __METHOD__
 320                         );
 321                 } else {
 322                         if ( $user->isLoggedIn() ) {
 323                                 $conds = [ 'rev_user' => $user->getId() ];
 324                         } else {
 325                                 $conds = [ 'rev_user_text' => $user->getName() ];
 326                         }
 327                         $res = $dbr->selectField( 'revision',
 328                                 'MAX(rev_timestamp)',
 329                                 $conds,
 330                                 __METHOD__
 331                         );
 332                 }
 333
 334                 return $res ? wfTimestamp( TS_ISO_8601, $res ) : null;
 335         }
 336
 337         public function getAllowedParams() {
 338                 return [
 339                         'prop' => [
 340                                 ApiBase::PARAM_ISMULTI => true,
 341                                 ApiBase::PARAM_TYPE => [
 342                                         'blockinfo',
 343                                         'hasmsg',
 344                                         'groups',
 345                                         'groupmemberships',
 346                                         'implicitgroups',
 347                                         'rights',
 348                                         'changeablegroups',
 349                                         'options',
 350                                         'editcount',
 351                                         'ratelimits',
 352                                         'email',
 353                                         'realname',
 354                                         'acceptlang',
 355                                         'registrationdate',
 356                                         'unreadcount',
 357                                         'centralids',
 358                                         'preferencestoken',
 359                                         'latestcontrib',
 360                                 ],
 361                                 ApiBase::PARAM_HELP_MSG_PER_VALUE => [
 362                                         'unreadcount' => [
 363                                                 'apihelp-query+userinfo-paramvalue-prop-unreadcount',
 364                                                 self::WL_UNREAD_LIMIT - 1,
 365                                                 self::WL_UNREAD_LIMIT . '+',
 366                                         ],
 367                                 ],
 368                                 ApiBase::PARAM_DEPRECATED_VALUES => [
 369                                         'preferencestoken' => [
 370                                                 'apiwarn-deprecation-withreplacement',
 371                                                 $this->getModulePrefix() . "prop=preferencestoken",
 372                                                 'action=query&meta=tokens',
 373                                         ]
 374                                 ],
 375                         ],
 376                         'attachedwiki' => null,
 377                 ];
 378         }
 379
 380         protected function getExamplesMessages() {
 381                 return [
 382                         'action=query&meta=userinfo'
 383                                 => 'apihelp-query+userinfo-example-simple',
 384                         'action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg'
 385                                 => 'apihelp-query+userinfo-example-data',
 386                 ];
 387         }
 388
 389         public function getHelpUrls() {
 390                 return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Userinfo';
 391         }
 392 }