mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-11-24 16:04:35 +00:00
c1c3c7b672
There are about 200 of such generic "array" type hints in this code base, the majority in @param tags. I started with what I found most relevant: @var and @return tags. I might continue working on this later, but wanted to stop for now to keep this patch moderately small. Change-Id: Iff0d9590a794ae0f885466ef6bb336b0b42a6cd3
114 lines
2.9 KiB
PHP
114 lines
2.9 KiB
PHP
<?php
|
|
|
|
class ApiEchoArticleReminder extends ApiBase {
|
|
|
|
public function execute() {
|
|
$this->getMain()->setCacheMode( 'private' );
|
|
$user = $this->getUser();
|
|
if ( $user->isAnon() ) {
|
|
$this->dieWithError( 'apierror-mustbeloggedin-generic', 'login-required' );
|
|
}
|
|
|
|
$params = $this->extractRequestParams();
|
|
$result = [];
|
|
$userTimestamp = new MWTimestamp( $params['timestamp'] );
|
|
$nowTimestamp = new MWTimestamp();
|
|
// We need $params['timestamp'] to be a future timestamp:
|
|
// $userTimestamp < $nowTimestamp = invert 0
|
|
// $userTimestamp > $nowTimestamp = invert 1
|
|
if ( $userTimestamp->diff( $nowTimestamp )->invert === 0 ) {
|
|
$this->dieWithError( [ 'apierror-badparameter', 'timestamp' ], 'timestamp-not-in-future', null, 400 );
|
|
}
|
|
|
|
$eventCreation = EchoEvent::create( [
|
|
'type' => 'article-reminder',
|
|
'agent' => $user,
|
|
'title' => $this->getTitleFromTitleOrPageId( $params ),
|
|
'extra' => [
|
|
'notifyAgent' => true,
|
|
'comment' => $params['comment'],
|
|
],
|
|
] );
|
|
|
|
if ( !$eventCreation ) {
|
|
$this->dieWithError( 'apierror-echo-event-creation-failed', null, null, 500 );
|
|
}
|
|
|
|
/* Temp - removing the delay just for now:
|
|
$job = new JobSpecification(
|
|
'articleReminder',
|
|
[
|
|
'userId' => $user->getId(),
|
|
'timestamp' => $params['timestamp'],
|
|
'comment' => $params['comment'],
|
|
],
|
|
[ 'removeDuplicates' => true ],
|
|
Title::newFromID( $params['pageid'] )
|
|
);
|
|
JobQueueGroup::singleton()->push( $job );*/
|
|
$result += [
|
|
'result' => 'success'
|
|
];
|
|
$this->getResult()->addValue( 'query', $this->getModuleName(), $result );
|
|
}
|
|
|
|
public function getAllowedParams() {
|
|
return [
|
|
'pageid' => [
|
|
ApiBase::PARAM_TYPE => 'integer',
|
|
],
|
|
'title' => [
|
|
ApiBase::PARAM_TYPE => 'string',
|
|
],
|
|
'comment' => [
|
|
ApiBase::PARAM_TYPE => 'string',
|
|
],
|
|
'timestamp' => [
|
|
ApiBase::PARAM_REQUIRED => true,
|
|
ApiBase::PARAM_TYPE => 'timestamp',
|
|
],
|
|
'token' => [
|
|
ApiBase::PARAM_REQUIRED => true,
|
|
],
|
|
];
|
|
}
|
|
|
|
public function needsToken() {
|
|
return 'csrf';
|
|
}
|
|
|
|
public function getTokenSalt() {
|
|
return '';
|
|
}
|
|
|
|
public function mustBePosted() {
|
|
return true;
|
|
}
|
|
|
|
public function isWriteMode() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @see ApiBase::getExamplesMessages()
|
|
* @return string[]
|
|
*/
|
|
protected function getExamplesMessages() {
|
|
$todayDate = new DateTime();
|
|
$oneDay = new DateInterval( 'P1D' );
|
|
$tomorrowDate = $todayDate->add( $oneDay );
|
|
$tomorrowDateTimestamp = new MWTimestamp( $tomorrowDate );
|
|
$tomorrowTimestampStr = $tomorrowDateTimestamp->getTimestamp( TS_ISO_8601 );
|
|
return [
|
|
"action=echoarticlereminder&pageid=1×tamp=$tomorrowTimestampStr&comment=example"
|
|
=> 'apihelp-echoarticlereminder-example-1',
|
|
"action=echoarticlereminder&title=Main_Page×tamp=$tomorrowTimestampStr"
|
|
=> 'apihelp-echoarticlereminder-example-2',
|
|
];
|
|
}
|
|
|
|
public function getHelpUrls() {
|
|
return 'https://www.mediawiki.org/wiki/Echo_(Notifications)/API';
|
|
}
|
|
}
|