1 files changed, 135 insertions, 0 deletions
diff --git a/www/wiki/extensions/Translate/api/ApiTranslationStash.php b/www/wiki/extensions/Translate/api/ApiTranslationStash.php
new file mode 100644
index 00000000..dad11719
--- /dev/null
+++ b/www/wiki/extensions/Translate/api/ApiTranslationStash.php
@@ -0,0 +1,135 @@
+<?php
+/**
+ * WebAPI module for stashing translations.
+ *
+ * @file
+ * @author Niklas Laxström
+ * @license GPL-2.0-or-later
+ */
+
+/**
+ * WebAPI module for storing translations for users who are in a sandbox.
+ * Access is controlled by hooks in TranslateSandbox class.
+ * @since 2013.06
+ */
+class ApiTranslationStash extends ApiBase {
+	public function execute() {
+		$params = $this->extractRequestParams();
+
+		// The user we are operating on, not necessarly the user making the request
+		$user = $this->getUser();
+
+		if ( isset( $params['username'] ) ) {
+			if ( $this->getUser()->isAllowed( 'translate-sandboxmanage' ) ) {
+				$user = User::newFromName( $params['username'] );
+				if ( !$user ) {
+					$this->dieWithError( [ 'apierror-badparameter', 'username' ], 'invalidparam' );
+				}
+			} else {
+				$this->dieWithError( [ 'apierror-badparameter', 'username' ], 'invalidparam' );
+			}
+		}
+
+		$stash = new TranslationStashStorage( wfGetDB( DB_MASTER ) );
+		$action = $params['subaction'];
+
+		if ( $action === 'add' ) {
+			if ( !isset( $params['title'] ) ) {
+				$this->dieWithError( [ 'apierror-missingparam', 'title' ] );
+			}
+			if ( !isset( $params['translation'] ) ) {
+				$this->dieWithError( [ 'apierror-missingparam', 'translation' ] );
+			}
+
+			// @todo: Return value of Title::newFromText not checked
+			$translation = new StashedTranslation(
+				$user,
+				Title::newFromText( $params['title'] ),
+				$params['translation'],
+				FormatJson::decode( $params['metadata'], true )
+			);
+			$stash->addTranslation( $translation );
+		}
+
+		if ( $action === 'query' ) {
+			$output['translations'] = [];
+
+			$translations = $stash->getTranslations( $user );
+			foreach ( $translations as $translation ) {
+				$output['translations'][] = $this->formatTranslation( $translation );
+			}
+		}
+
+		// If we got this far, nothing has failed
+		$output['result'] = 'ok';
+		$this->getResult()->addValue( null, $this->getModuleName(), $output );
+	}
+
+	protected function formatTranslation( StashedTranslation $translation ) {
+		$title = $translation->getTitle();
+		$handle = new MessageHandle( $title );
+
+		// Prepare for the worst
+		$definition = '';
+		$comparison = '';
+		if ( $handle->isValid() ) {
+			$groupId = MessageIndex::getPrimaryGroupId( $handle );
+			$group = MessageGroups::getGroup( $groupId );
+
+			$key = $handle->getKey();
+
+			$definition = $group->getMessage( $key, $group->getSourceLanguage() );
+			$comparison = $group->getMessage( $key, $handle->getCode() );
+		}
+
+		return [
+			'title' => $title->getPrefixedText(),
+			'definition' => $definition,
+			'translation' => $translation->getValue(),
+			'comparison' => $comparison,
+			'metadata' => $translation->getMetadata(),
+		];
+	}
+
+	public function isWriteMode() {
+		return true;
+	}
+
+	public function needsToken() {
+		return 'csrf';
+	}
+
+	public function getAllowedParams() {
+		return [
+			'subaction' => [
+				ApiBase::PARAM_TYPE => [ 'add', 'query' ],
+				ApiBase::PARAM_REQUIRED => true,
+			],
+			'title' => [
+				ApiBase::PARAM_TYPE => 'string',
+			],
+			'translation' => [
+				ApiBase::PARAM_TYPE => 'string',
+			],
+			'metadata' => [
+				ApiBase::PARAM_TYPE => 'string',
+			],
+			'token' => [
+				ApiBase::PARAM_TYPE => 'string',
+				ApiBase::PARAM_REQUIRED => true,
+			],
+			'username' => [
+				ApiBase::PARAM_TYPE => 'string',
+			],
+		];
+	}
+
+	protected function getExamplesMessages() {
+		return [
+			'action=translationstash&subaction=add&title=MediaWiki:Jan/fi&translation=tammikuu&metadata={}'
+				=> 'apihelp-translationstash-example-1',
+			'action=translationstash&subaction=query'
+				=> 'apihelp-translationstash-example-2',
+		];
+	}
+}