Mattermost Autotranslation Plugin (Beta)
![HW](https://img.shields.io/github/issues/mattermost/mattermost-plugin-autotranslate/Up%20For%20Grabs?color=dark%20green&label=Help%20Wanted)
Maintainer: @saturninoabril
Autotranslation plugin for Mattermost.
Message autotranslation is powered by Amazon Translate which is a text translation service that uses advanced machine learning technologies to provide high-quality translation on demand. Amazon Translate can translate text between the languages listed in its website.
Feature
- Translate option available at dropdown menu of each regular post.
- Slash commands to change user settings using
/autotranslate
slash command
- Check user info by issuing
/autotranslate info
to see current user setting
- Turn on/off translation by issuing
/autotranslate [on|off]
- Change source language translation by initiating
/autotranslate source [language code]
- Change target language translation by initiating
/autotranslate target [language code]
- Supported Languages and its codes can be found at Amazon Translate website.
Installation
Requires Mattermost 5.22 or higher
- Install the plugin
- Download the latest version of the plugin from the GitHub releases page
- In Mattermost, go to the System Console -> Plugins -> Management
- Upload the plugin
- Spin up Amazon Translate https://aws.amazon.com/translate/
- In Mattermost, go to System Console -> Plugins -> Autotranslate
- Fill in the AWS Access Key ID, Secret Access Key and Region
- Enable the plugin
- Go to System Console -> Plugins -> Management and click "Enable" underneath the Autotranslate plugin
- Test it out
- In Mattermost, run the slash command
/autotranslate on
and see if Translate
option becomes available at dropdown menu of a post.
Developing
This plugin contains both a server and web app portion.
Use make dist
to build distributions of the plugin that you can upload to a Mattermost server.
Use make check-style
to check the style.
Use make localdeploy
to deploy the plugin to your local server. You will need to restart the server to get the changes.