Skip to content

Quick Start

This 5-minute guide gets you from installation to your first translated content.

Prerequisites

  • You have installed the module and its dependencies
  • You have Lara API credentials ready
  • You have content types enabled for translation in Drupal

Step 1: Configure Lara Translator (2 minutes)

1.1 Create API Keys

  1. Go to Configuration → System → Keys (/admin/config/system/keys)
  2. Click Add key
  3. Create two keys:
  4. Lara Access Key ID: Type "API Key", paste your key ID
  5. Lara Access Key Secret: Type "API Key", paste your secret

1.2 Create Translator Provider

  1. Go to Configuration → Translation Management → Providers (/admin/config/regional/tmgmt_translator)
  2. Click Add translator
  3. Select Lara Translate and click Save
  4. Configure:
  5. Name: "Lara Translate" (or your preferred name)
  6. Credentials: Select the keys you created
  7. Default style: Choose "Fluid" (recommended for most content)
  8. Click Save

1.3 Verify Configuration

  • The provider should show "Available" status
  • If not, check your API credentials and network connectivity

Step 2: Submit Your First Translation (2 minutes)

2.1 Create a Translation Job

  1. Go to Content (/admin/content)
  2. Find content to translate (or create a test node)
  3. Click the Translate tab
  4. Select target language(s)
  5. Click Request translation

2.2 Choose Lara Translator

  1. In the translation request form, select your Lara Translate provider
  2. Review the job items to be translated
  3. Click Request translation

2.3 Check Job Status

  • The job will be marked as "Submitted"
  • Translation processing happens asynchronously via Symfony Messenger

Step 3: Monitor Translation Progress (1 minute)

3.1 Check Job Status

  1. Go to Configuration → Translation Management → Jobs (/admin/config/regional/tmgmt_job)
  2. Click on your translation job
  3. You'll see:
  4. Job status (Submitted → Active → Completed)
  5. Individual job item statuses
  6. Any error messages

3.2 View Translated Content

Once completed: 1. Go back to your original content 2. Click the Translate tab 3. You'll see the translated versions 4. Review and publish as needed

What Happens Behind the Scenes?

flowchart TD
    A[You submit translation] --> B[Job created]
    B --> C[Items dispatched to Symfony Messenger]
    C --> D[MessageHandler processes items]
    D --> E[Lara API translates content]
    E --> F[Translated content imported]
    F --> G[Job marked completed]

Common Quick Issues

"Provider not available"

  • Check your API credentials in the Keys configuration
  • Verify network access to Lara's API
  • Check Drupal logs for specific error messages

"Translation not processing"

  • Symfony Messenger may need to be configured for your environment
  • Check that the SM module is properly installed
  • See Operations Guide for messenger setup

"Job stuck in submitted state"

Next Steps

Success! 🎉

You've successfully set up TMGMT Lara Translate and submitted your first translation job. The translated content will appear automatically once processing completes.

For more advanced usage and troubleshooting, see the detailed guides in this documentation.