45 private $mUser =
null;
66 parent::__construct( $mainModule, $moduleName );
67 $this->userGroupManager = $userGroupManager;
68 $this->watchedItemStore = $watchedItemStore;
71 $this->watchlistExpiryEnabled = $this->
getConfig()->get( MainConfigNames::WatchlistExpiry );
72 $this->watchlistMaxDuration =
73 $this->
getConfig()->get( MainConfigNames::WatchlistExpiryMaxDuration );
74 $this->watchlistManager = $watchlistManager;
75 $this->userOptionsLookup = $userOptionsLookup;
83 if ( !$this->
getAuthority()->isAllowed(
'userrights' ) ) {
84 $block = $pUser->getBlock( IDBAccessObject::READ_LATEST );
85 if ( $block && $block->isSitewide() ) {
93 $expiry = (array)
$params[
'expiry'];
97 } elseif ( count( $expiry ) !== count( $add ) ) {
98 if ( count( $expiry ) === 1 ) {
99 $expiry = array_fill( 0, count( $add ), $expiry[0] );
102 'apierror-toofewexpiries',
111 foreach ( $expiry as $index => $expiryValue ) {
112 $group = $add[$index];
113 $groupExpiries[$group] = SpecialUserRights::expiryToTimestamp( $expiryValue );
115 if ( $groupExpiries[$group] ===
false ) {
120 if ( $groupExpiries[$group] && $groupExpiries[$group] <
wfTimestampNow() ) {
125 $user = $this->getUrUser(
$params );
130 if ( $tags !==
null ) {
132 if ( !$ableToTag->isOK() ) {
140 $r[
'user'] = $user->getName();
141 $r[
'userid'] = $user->getId( $user->getWikiId() );
142 [ $r[
'added'], $r[
'removed'] ] = $form->doSaveUserGroups(
144 $user, $add, (array)
$params[
'remove'],
145 $params[
'reason'], (array)$tags, $groupExpiries
149 $watchuser =
$params[
'watchuser'];
150 $userPage = Title::makeTitle(
NS_USER, $user->getName() );
151 if ( $watchuser && $user->getWikiId() === UserIdentity::LOCAL ) {
152 $this->
setWatch(
'watch', $userPage, $this->
getUser(),
null, $watchlistExpiry );
155 $watchlistExpiry =
null;
157 $r[
'watchuser'] = $watchuser;
158 if ( $watchlistExpiry !==
null ) {
160 $this->watchedItemStore,
167 ApiResult::setIndexedTagName( $r[
'added'],
'group' );
168 ApiResult::setIndexedTagName( $r[
'removed'],
'group' );
176 private function getUrUser( array
$params ) {
177 if ( $this->mUser !==
null ) {
187 $status = $form->fetchUser( $user );
188 if ( !$status->isOK() ) {
192 $this->mUser = $status->value;
194 return $status->value;
206 $allGroups = $this->userGroupManager->listAllGroups();
214 ParamValidator::PARAM_TYPE =>
'user',
215 UserDef::PARAM_ALLOWED_USER_TYPES => [
'name',
'id' ],
218 ParamValidator::PARAM_TYPE =>
'integer',
219 ParamValidator::PARAM_DEPRECATED =>
true,
222 ParamValidator::PARAM_TYPE => $allGroups,
223 ParamValidator::PARAM_ISMULTI => true
226 ParamValidator::PARAM_ISMULTI =>
true,
227 ParamValidator::PARAM_ALLOW_DUPLICATES =>
true,
228 ParamValidator::PARAM_DEFAULT =>
'infinite',
231 ParamValidator::PARAM_TYPE => $allGroups,
232 ParamValidator::PARAM_ISMULTI => true
235 ParamValidator::PARAM_DEFAULT =>
''
242 ParamValidator::PARAM_TYPE =>
'tags',
243 ParamValidator::PARAM_ISMULTI => true
245 'watchuser' =>
false,
251 if ( $this->watchlistExpiryEnabled ) {
253 'watchlistexpiry' => [
254 ParamValidator::PARAM_TYPE =>
'expiry',
255 ExpiryDef::PARAM_MAX => $this->watchlistMaxDuration,
256 ExpiryDef::PARAM_USE_MAX =>
true,
269 return $this->getUrUser(
$params )->getName();
274 'action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC'
275 =>
'apihelp-userrights-example-user',
276 'action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC'
277 =>
'apihelp-userrights-example-userid',
278 'action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC'
279 =>
'apihelp-userrights-example-expiry',
284 return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:User_group_membership';
getExpiryFromParams(array $params)
Get formatted expiry from the given parameters, or null if no expiry was provided.
setWatch(string $watch, Title $title, User $user, ?string $userOption=null, ?string $expiry=null)
Set a watch (or unwatch) based the based on a watchlist parameter.
getWatchlistExpiry(WatchedItemStoreInterface $store, Title $title, UserIdentity $user)
Get existing expiry from the database.
wfTimestampNow()
Convenience function; returns MediaWiki timestamp for the present time.
wfEscapeWikiText( $input)
Escapes the given text so that it may be output using addWikiText() without any linking,...
array $params
The job parameters.
This abstract class implements many basic API functions, and is the base of all API classes.
dieWithError( $msg, $code=null, $data=null, $httpCode=0)
Abort execution with an error.
const PARAM_HELP_MSG_APPEND
((string|array|Message)[]) Specify additional i18n messages to append to the normal message for this ...
requireOnlyOneParameter( $params,... $required)
Die if 0 or more than one of a certain set of parameters is set and not false.
getResult()
Get the result object.
extractRequestParams( $options=[])
Using getAllowedParams(), this function makes an array of the values provided by the user,...
const GET_VALUES_FOR_HELP
getAllowedParams() flag: When this is set, the result could take longer to generate,...
getModuleName()
Get the name of the module being executed by this instance.
dieStatus(StatusValue $status)
Throw an ApiUsageException based on the Status object.
dieBlocked(Block $block)
Throw an ApiUsageException, which will (if uncaught) call the main module's error handler and die wit...
This is the main API class, used for both external and internal processing.
getHelpUrls()
Return links to more detailed help pages about the module.
getAllowedParams( $flags=0)
execute()
Evaluates the parameters, performs the requested query, and sets up the result.
mustBePosted()
Indicates whether this module must be called with a POST request.
__construct(ApiMain $mainModule, $moduleName, UserGroupManager $userGroupManager, WatchedItemStoreInterface $watchedItemStore, WatchlistManager $watchlistManager, UserOptionsLookup $userOptionsLookup)
needsToken()
Returns the token type this module requires in order to execute.
isWriteMode()
Indicates whether this module requires write mode.
getExamplesMessages()
Returns usage examples for this module.
getWebUITokenSalt(array $params)
Fetch the salt used in the Web UI corresponding to this module.
getContext()
Get the base IContextSource object.
A class containing constants representing the names of configuration variables.
trait ApiWatchlistTrait
An ApiWatchlistTrait adds class properties and convenience methods for APIs that allow you to watch a...