tmgmt_modernmt

ModernMT Translator Integration for TMGMT

Overview

The tmgmt_modernmt module seamlessly integrates the
ModernMT machine translation service with the
Translation Management Tool (TMGMT) in Drupal.

It provides high-quality, AI-powered translations directly within your Drupal site, ensuring accurate,
adaptive, and context-aware multilingual content management.

Features

• 🌍 ModernMT API Integration – Connects to ModernMT via a secure API key using the
  Key module.
• 🏆 AI-Powered Translations – Provides adaptive and context-aware machine translation.
• 🔄 Seamless TMGMT Compatibility – Fully integrates with TMGMT for streamlined workflows.
• 🎯 Domain Customization – Allows domain-specific translation settings per language.
• 🔐 Secure API Key Management – Uses the Key module to store API credentials securely.

Requirements

• Drupal 10.x, 11.x
• Translation Management Tool (TMGMT)
• Key module
• ModernMT API Key (requires a ModernMT account)

Installation & Configuration

Installation

1. Download the module via Composer:
   

   composer require drupal/tmgmt_modernmt

2. Enable the module:
   

   drush en tmgmt_modernmt

3. Ensure the required modules are enabled:
   

   drush en tmgmt key

API Key Setup

1. Navigate to Configuration > System > Key (/admin/config/system/keys).
2. Create a new key and enter your ModernMT API credentials.
3. Save the configuration.

Translator Configuration

1. Go to Translation > Translators (/admin/tmgmt/translators).
2. Add or edit a translator and select ModernMT as the plugin.
3. Choose the ModernMT API Key you configured earlier.

Domain Customization (Optional)

Configure domain-specific translations per language under the translator settings.

Usage

1. Navigate to Translation > Jobs (/admin/tmgmt/jobs).
2. Select the content to translate and choose the ModernMT translator.
3. Submit the translation job and let ModernMT handle the rest!

Developer Notes

Configuration Schema

• Uses Drupal's structured configuration schema.
• API key selection is managed with the key_select element type.
• Domain settings can be customized per language.

Extensibility

• Built using Drupal’s plugin and service architecture.
• Easily extendable via custom plugins and overrides.

Troubleshooting

Error: "Invalid API Key"

• Ensure the API key is correctly configured in the Key module.
• Verify that your API key has sufficient permissions.

Translation Errors

• Check language mappings to confirm ModernMT supports your selected source and target languages.
• Verify that your ModernMT subscription is active.

Similar Projects

• tmgmt_google – Uses Google Translate instead of ModernMT.
• tmgmt_deepl – Integrates DeepL for premium translations.
• Why ModernMT? It offers adaptive AI translation that improves with usage and allows domain-specific tuning.

Support

• 📖 ModernMT API Documentation
• 📖 Drupal TMGMT Documentation
• 🛠 Issue Queue on Drupal.org

License

This module is open-source and licensed under the GNU General Public License v2 or later.

Why Use tmgmt_modernmt?

If you’re managing multilingual content in Drupal, this module is a powerful and secure solution
that brings AI-driven, adaptive machine translation to your workflow. Try it today!