https://github.com/driebit/mod_autotrans
https://github.com/driebit/mod_autotrans
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/driebit/mod_autotrans
- Owner: driebit
- Created: 2019-09-18T08:59:29.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-21T10:35:30.000Z (over 1 year ago)
- Last Synced: 2025-01-28T19:18:35.443Z (over 1 year ago)
- Language: Erlang
- Size: 21.5 KB
- Stars: 0
- Watchers: 8
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Automatic Translations for Zotonic Resources
============================================
When enabled (and configured) this module automatically translates edited
texts in a source language to a destination language.
It uses:
* Microsoft Cognitive Text Translation Services [1]
* Google Cloud Translate API [2]
How does it work?
-----------------
After a resource is updated this module queues a translation task into
the Zotonic task queue.
The translation task checks all texts in the source language for changes.
If a text was changed then it will request a translation at one of the
configured services and replaces the texts in the target language with the
newly translated text.
After the update a notification will be sent, which enabled the
admin edit form to update its fields with the new translation.
If this happens, you will see a growl message which also mentions the
target language.
Configuration
-------------
The following keys need to be configured:
* `mod_autotrans.source_language` The two letter ISO code of the source language
* `mod_autotrans.target_language` The two letter ISO code of the destination language
For Microsoft Cognitive Text Translation Services:
* `mod_autotrans.microsoft_api_secret` One of the API keys from the Translation Services.
Currently this module uses the generic endpoint, so no project endpoint needs to be configured.
For Google Translator:
* `mod_autotrans.google_api_secret` The API Key from the Credentials page on your
Google Cloud console at https://console.cloud.google.com/ The Key must have access
to the Cloud Translation API
Notes
-----
Please note that this module sends your texts to Microsoft and/or Google.
If you are editing sensitive information then it might not be a good idea to use this service.
Also, if you allow user-entered content, then you should add to your Privacy Declaration the use
of these services.
References
----------
- [1] https://docs.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-translate
- [2] https://cloud.google.com/translate/docs/quickstarts