README

• 1.0.x -> MediaWiki 1.43

Use in a MediaWiki extension

Require this component in the composer.json of your extension:

{
	"require": {
		"mwstake/mediawiki-component-deepl-translator": "~1"
	}
}

Configuration

$GLOBALS['mwsgDeeplTranslateServiceAuth'] = 'your-auth-key-here';
$GLOBALS['mwsgDeeplTranslateServiceUrl'] = 'https://api.deepl.com/v2';

// Optional - special cases
$GLOBALS['mwsgDeeplTranslateTranslateUrl'] = $GLOBALS['mwsgDeeplTranslateServiceUrl'] . '/translate';
$GLOBALS['mwsgDeeplTranslateLanguagesUrl'] = $GLOBALS['mwsgDeeplTranslateServiceUrl'] . '/languages';

Usage

Direct service

$translator = \MediaWiki\MediaWikiServices::getInstance()->getService( 'MWStake.DeepLTranslator' );
$translation = $translator->translateText( 'Hello, world!', 'EN', 'DE' );

API

curl -X POST "https://your-wiki/rest.php/mws/v1/deepl/translate" -H "Content-Type: application/json" --data '{"text":"Hello, world!","source_lang":"EN","target_lang":"DE"}'

JS

mws.deepltranslator.translateText( 'Hello, world!', 'EN', 'DE' ).then( function( translation ) {
    console.log( translation );
} );