mwstake/mediawiki-component-deepl-translator

1.1.5 2025-07-02 06:28 UTC

Requires

• composer/installers: ~1.0|~2
• mwstake/mediawiki-componentloader: ~1

Requires (Dev)

• mediawiki/mediawiki-codesniffer: 45.0.0
• mediawiki/mediawiki-phan-config: 0.14.0
• mediawiki/minus-x: 1.1.3
• php-parallel-lint/php-console-highlighter: 1.0.0
• php-parallel-lint/php-parallel-lint: 1.4.0

GPL-3.0-only

• Hallo Welt! GmbH

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 );
} );