conquer / i18n
The I18n automatic translation extension for the Yii2 framework
Installs: 558
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 4
Forks: 4
Open Issues: 1
Type:yii2-extension
Requires
- conquer/helpers: ~2.0.6
- yiisoft/yii2: >=2.0.4
This package is auto-updated.
Last update: 2022-02-01 12:48:32 UTC
README
Description
This extension makes it possible to automatically translate messages using external services.
##Google With Google Translate, you can dynamically translate text between thousands of language pairs. The Google Translate API lets websites and programs integrate with Google Translate programmatically. Google Translate API is available as a paid service. See the Pricing and FAQ pages for details.
##Yandex The API provides access to the Yandex online machine translation service. It supports more than 40 languages and can translate separate words or complete texts. The API makes it possible to embed Yandex.Translate in a mobile app or web service for end users. Or translate large quantities of text, such as technical documentation.
Installation
The preferred way to install this extension is through composer.
To install, either run
$ php composer.phar require conquer/i18n "*"
or add
"conquer/i18n": "*"
to the require
section of your composer.json
file.
To create database tables run migration command
$ yii migrate --migrationPath=@conquer/i18n/migrations
Usage
You need to configure Module and i18n component
$config = [ 'bootstrap' => ['translate'], 'language' => 'ru', 'modules' => [ 'translate' => 'conquer\i18n\Module' ], 'components' => [ 'i18n' => [ 'class' => 'yii\i18n\I18N', 'translations' => [ '*' => [ 'class' => 'conquer\i18n\MessageSource', 'translator' => [ // 'class'=>'conquer\i18n\translators\GoogleTranslator', // 'apiKey' => 'obtain API key in the google developer console', 'class'=>'conquer\i18n\translators\YandexTranslator', 'apiKey' => '[yandex form](https://tech.yandex.com/keys/get/?service=trnsl)', ], ], ], ], ], ];
Use \Yii::t function to translate messages
<h1><?= \Yii::t('app', 'Congratulations!') ?></h1>
"*" Translation category is used by default for all non-translated messages.
You can configure a separate category for the translation of messages by external translator.
'components' => [ 'i18n' => [ 'class' => 'yii\i18n\I18N', 'translations' => [ 'yandex' => [ 'class' => 'conquer\i18n\MessageSource', 'translator' => [ 'class'=>'conquer\i18n\translators\YandexTranslator', 'apiKey' => '[yandex form](https://tech.yandex.com/keys/get/?service=trnsl)', ], ], ], ], ],
Use \Yii::t function to translate messages in "yandex" category
<h1><?= \Yii::t('yandex', 'Congratulations!') ?></h1>
License
conquer/i18n is released under the MIT License. See the bundled LICENSE.md
for details.