![No UI](https://img.shields.io/static/v1?label=UI&message=none&color=inactive) The "MS Azure Autotranslator" plugin automatically translates nodes (on creation, move and metadata update) and assets (on metadata update and add to node) within the defined scope. Warning: to prevent the translation of a lot of assets or nodes that were already translated, only the moved node is translated (if in scope) and not its children or the assets in it. You can either trigger changes for the fields that should be translated, or run the auto translator task (important: set the scope(s) accordingly, everything in any scope will be translated (again)). [MINITOC] ## Properties To be configured in {home}/appserver/conf/custom.properties. See [here](https://docs.brix.ch/celum_extensions/auto_translator) for the configuration in general and the compatibility matrix. ##### autoTranslator.translationService > type: String, **required: yes**, default: - Set this to "microsoft". ##### autoTranslator.microsoft.url > type: String, required: yes (if the microsoft service was selected), default: - The URL to the microsoft translation service, e.g. `https://api.cognitive.microsofttranslator.com/translate?api-version=3.0`. ##### autoTranslator.microsoft.subscriptionKey > type: String, required: yes (if the microsoft service was selected), default: - The subscription key delivered by Microsoft (see [Installation](#installation)). ##### autoTranslator.microsoft.region > type: String, required: yes (if the microsoft service was selected and not global url is used), default: - The region in which the translation subscription was created. ## Installation 1. Create a Microsoft Azure account and sign in 2. Switch to the portal 3. Go to "all resources" 4. Click "add" 5. Enter "Translator Text" in the search box and then select from the results 6. Select "create" to define the details for the subscription 7. From the Pricing tier list, select the pricing tier that best fits your needs (up to 2.5M characters/month are free) 8. Fill out the descriptive fields and click "create" to finish the subscription 9. Go to "all resources" and open the subscription just created 10. Click on "keys" and copy one of the keys into your properties file: `autoTranslator.microsoft.subscriptionKey` ## Links * [How to sign up for the Translator Text API](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/translator-text-how-to-signup) * [Quickstart: Translate text with Java](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/quickstart-java-translate) * [Text API 3.0: Translate](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-translate?tabs=curl) * [Microsoft Azure](https://azure.microsoft.com/en-us/)