MediaWiki master
MediaWiki\User\UserEditTracker Class Reference

Track info about user edit counts and timings. More...

Public Member Functions

 __construct (ActorNormalization $actorNormalization, IConnectionProvider $dbProvider, JobQueueGroup $jobQueueGroup)
 
 clearUserEditCache (UserIdentity $user)
 
 getFirstEditTimestamp (UserIdentity $user, int $flags=IDBAccessObject::READ_NORMAL)
 Get the user's first edit timestamp.
 
 getLatestEditTimestamp (UserIdentity $user, int $flags=IDBAccessObject::READ_NORMAL)
 Get the user's latest edit timestamp.
 
 getUserEditCount (UserIdentity $user)
 Get a user's edit count from the user_editcount field, falling back to initialize.
 
 incrementUserEditCount (UserIdentity $user)
 Schedule a job to increase a user's edit count.
 
 initializeUserEditCount (UserIdentity $user)
 
 preloadUserEditCountCache (array $users)
 Preloads the internal edit count cache for the given users.
 
 setCachedUserEditCount (UserIdentity $user, int $editCount)
 

Detailed Description

Track info about user edit counts and timings.

Since
1.35
Author
DannyS712

Definition at line 25 of file UserEditTracker.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\User\UserEditTracker::__construct ( ActorNormalization $actorNormalization,
IConnectionProvider $dbProvider,
JobQueueGroup $jobQueueGroup )
Parameters
ActorNormalization$actorNormalization
IConnectionProvider$dbProvider
JobQueueGroup$jobQueueGroup

Definition at line 49 of file UserEditTracker.php.

Member Function Documentation

◆ clearUserEditCache()

MediaWiki\User\UserEditTracker::clearUserEditCache ( UserIdentity $user)
Access: internal
For use by User::clearInstanceCache()
Parameters
UserIdentity$user

Definition at line 249 of file UserEditTracker.php.

References MediaWiki\User\UserIdentity\isRegistered().

◆ getFirstEditTimestamp()

MediaWiki\User\UserEditTracker::getFirstEditTimestamp ( UserIdentity $user,
int $flags = IDBAccessObject::READ_NORMAL )

Get the user's first edit timestamp.

Parameters
UserIdentity$user
int$flagsbit field, see IDBAccessObject::READ_XXX
Returns
string|false Timestamp of first edit, or false for non-existent/anonymous user accounts.

Definition at line 195 of file UserEditTracker.php.

◆ getLatestEditTimestamp()

MediaWiki\User\UserEditTracker::getLatestEditTimestamp ( UserIdentity $user,
int $flags = IDBAccessObject::READ_NORMAL )

Get the user's latest edit timestamp.

Parameters
UserIdentity$user
int$flagsbit field, see IDBAccessObject::READ_XXX
Returns
string|false Timestamp of latest edit, or false for non-existent/anonymous user accounts.

Definition at line 207 of file UserEditTracker.php.

◆ getUserEditCount()

MediaWiki\User\UserEditTracker::getUserEditCount ( UserIdentity $user)

Get a user's edit count from the user_editcount field, falling back to initialize.

Parameters
UserIdentity$user
Returns
int|null Null for anonymous users

Definition at line 65 of file UserEditTracker.php.

◆ incrementUserEditCount()

MediaWiki\User\UserEditTracker::incrementUserEditCount ( UserIdentity $user)

Schedule a job to increase a user's edit count.

Since
1.37
Parameters
UserIdentity$user

Definition at line 175 of file UserEditTracker.php.

References MediaWiki\User\UserIdentity\isRegistered().

◆ initializeUserEditCount()

MediaWiki\User\UserEditTracker::initializeUserEditCount ( UserIdentity $user)
Access: internal
For use in UserEditCountUpdate class
Parameters
UserIdentity$user
Returns
int

Definition at line 146 of file UserEditTracker.php.

◆ preloadUserEditCountCache()

MediaWiki\User\UserEditTracker::preloadUserEditCountCache ( array $users)

Preloads the internal edit count cache for the given users.

Use this when calls to self::getUserEditCount() are expected for multiple users, so that the queries can be batched instead of performing one query per user.

Unlike self::getUserEditCount(), this will not try to update the edit counts stored in user_editcount for users for which the count was not previously initialized.

Parameters
UserIdentity[]$users
Since
1.46
Returns
void

Definition at line 107 of file UserEditTracker.php.

References MediaWiki\DAO\WikiAwareEntity\LOCAL.

◆ setCachedUserEditCount()

MediaWiki\User\UserEditTracker::setCachedUserEditCount ( UserIdentity $user,
int $editCount )
Access: internal
For use by User::loadFromRow() and tests
Parameters
UserIdentity$user
int$editCount
Exceptions
InvalidArgumentExceptionIf the user is not registered

Definition at line 264 of file UserEditTracker.php.

References MediaWiki\User\UserIdentity\isRegistered().


The documentation for this class was generated from the following file: