26 protected static $right =
'translate-messagereview';
28 private $revisionLookup;
30 private $titleFormatter;
32 private $loadBalancer;
36 public function __construct(
39 RevisionLookup $revisionLookup,
40 TitleFormatter $titleFormatter,
41 ILoadBalancer $loadBalancer,
44 parent::__construct( $main, $moduleName );
45 $this->revisionLookup = $revisionLookup;
46 $this->titleFormatter = $titleFormatter;
47 $this->loadBalancer = $loadBalancer;
48 $this->hookRunner = $hookRunner;
51 public function execute() {
52 $this->checkUserRightsAny( self::$right );
54 $params = $this->extractRequestParams();
56 $revRecord = $this->revisionLookup->getRevisionById( $params[
'revision'] );
58 $this->dieWithError( [
'apierror-nosuchrevid', $params[
'revision'] ],
'invalidrevision' );
61 $status = $this->getReviewBlockers( $this->getUser(), $revRecord );
62 if ( !$status->isGood() ) {
63 if ( $status->hasMessage(
'blocked' ) ) {
64 $this->dieBlocked( $this->getUser()->getBlock() );
66 $this->dieStatus( $status );
70 $ok = $this->doReview( $this->getUser(), $revRecord );
72 $this->addWarning(
'apiwarn-translate-alreadyreviewedbyyou' );
75 $prefixedText = $this->titleFormatter->getPrefixedText( $revRecord->getPageAsLinkTarget() );
76 $output = [
'review' => [
77 'title' => $prefixedText,
78 'pageid' => $revRecord->getPageId(),
79 'revision' => $revRecord->getId()
82 $this->getResult()->addValue(
null, $this->getModuleName(), $output );
89 private function doReview( User $user, RevisionRecord $revRecord ):
bool {
90 $dbw = $this->loadBalancer->getConnection( DB_PRIMARY );
91 $table =
'translate_reviews';
93 'trr_user' => $user->getId(),
94 'trr_page' => $revRecord->getPageId(),
95 'trr_revision' => $revRecord->getId(),
97 $options = [
'IGNORE' ];
98 $dbw->insert( $table, $row, __METHOD__, $options );
100 if ( !$dbw->affectedRows() ) {
104 $title = $revRecord->getPageAsLinkTarget();
106 $entry =
new ManualLogEntry(
'translationreview',
'message' );
107 $entry->setPerformer( $user );
108 $entry->setTarget( $title );
109 $entry->setParameters( [
110 '4::revision' => $revRecord->getId(),
113 $logid = $entry->insert();
114 $entry->publish( $logid );
117 $this->hookRunner->onTranslateEventTranslationReview( $handle );
126 private function getReviewBlockers( User $user, RevisionRecord $revRecord ): Status {
127 if ( !$user->isAllowed( self::$right ) ) {
128 return Status::newFatal(
'apierror-permissiondenied-generic' );
131 if ( $user->getBlock() ) {
132 return Status::newFatal(
'blocked' );
135 $title = $revRecord->getPageAsLinkTarget();
137 if ( !$handle->isValid() ) {
138 return Status::newFatal(
'apierror-translate-unknownmessage' );
141 if ( $user->equals( $revRecord->getUser() ) ) {
142 return Status::newFatal(
'apierror-translate-owntranslation' );
145 if ( $handle->isFuzzy() ) {
146 return Status::newFatal(
'apierror-translate-fuzzymessage' );
149 return Status::newGood();
152 public function isWriteMode():
bool {
156 public function needsToken():
string {
160 protected function getAllowedParams(): array {
163 ParamValidator::PARAM_TYPE =>
'integer',
164 ParamValidator::PARAM_REQUIRED =>
true,
167 ParamValidator::PARAM_TYPE =>
'string',
168 ParamValidator::PARAM_REQUIRED =>
true,
173 protected function getExamplesMessages(): array {
175 'action=translationreview&revision=1&token=foo'
176 =>
'apihelp-translationreview-example-1',