Skip to main content

Quickstart: Bureau Works Drupal Connector (TMGMT Provider)

Updated over a week ago

Last Updated: November, 2025

Maintained By: Bureau Works Engineering & Product

Compatibility: Drupal 10.5+, PHP 8.3+, Drupal 11

Dependency: TMGMT 8.x-1.15+

Overview

The Bureau Works Drupal Connector is a TMGMT provider plugin. It lets Drupal users request translations, track progress, and fetch completed translations from Bureau Works directly inside Drupal.

Enterprise note: Some subscribers require explicit maintenance, compatibility, and DevOps-aligned installation assurances. Those are addressed in the Enterprise Appendix linked at the bottom.


Package

Step 1 — Install TMGMT

Download and install the Translation Management Tool module:

Enable it via:

Extend → Translation options → Install


Step 2 — Install the Bureau Works Plugin

Install using the same method as TMGMT:

  • If installing by URL, use the TMGMT URL above.

  • If installing by upload, upload the Bureau Works .tar.gz package provided by Bureau Works.​


​Enable it via:

Extend → search “Bureau” → check “Bureau Works” → Install

This installs and enables the provider module.​


Step 3 — Configure Bureau Works as a Provider

Navigate to:

Translation → Providers

  • Click Add provider to create a new one
    or

  • Click Edit next to an existing Bureau Works provider.

Set:

  • Provider label/description

  • Provider Plugin: Bureau Works

Bureau Works Provider Settings

Field

What to enter

API Endpoint

Your Bureau Works URL (ex: demo.bureauworks.com or production)

Access Key

BW → Profile → Security → Generate

Secret Key

Secret paired with that Access Key

Org Unit UUID

Org Unit where Drupal projects will be created (projects inherit its workflow/TM/glossaries/users/automation rules)


Requesting Translation

  1. Go to: Translation → Sources

  2. Sources are Drupal nodes (pages, posts, etc.).

  3. Select:

    • the nodes you want translated

    • target languages

  4. Click Request Translation

  5. Fill in the project fields

  6. Click Submit to provider and continue

A project is created automatically in Bureau Works.


Translating in Bureau Works

  • Requested projects appear in the Bureau Works dashboard.

  • Work Units created from Drupal are visible in the BW project.

  • Translators work in Bureau Works Editor as usual.


(Full BW project-management docs are separate.)


Fetching Completed Translations

After translation is finished in BW and the project is marked Delivered:

  1. Go to: Translation → Jobs

  2. Click Manage on the job

  3. Click Fetch Translations

  4. Click View to preview in Drupal Editor

Need enterprise assurances?

Did this answer your question?