vaersaagod / transmate
Potato, patate, potet, kartoffel. We're not that different, mate!
Requires
- php: ^8.2.0
- craftcms/cms: ^5.9.0
- deeplcom/deepl-php: ^v1.10.1
- openai-php/client: ^v0.10.3
This package is auto-updated.
Last update: 2026-06-23 18:51:45 UTC
README
Potato, patate, potet, kartoffel. We're not that different, mate!
Requirements
This plugin requires Craft CMS 5.0.0 or later, and PHP 8.2 or later.
Price, license and support
The plugin is released under the Craft license and could be subject to license fees. It's made for Værsågod and friends, and no support is given. Submitted issues are resolved if it scratches an itch.
Configuration
translator
Which translator backend to use. Accepts either a single translator handle or a per-site map.
Single translator
Use one translator for every site:
'translator' => 'deepl',
Per-site translators
Map site handles to translator handles. The '*' key is required as the
fallback for any site you don't list explicitly:
'translator' => [ '*' => 'deepl', // every site uses DeepL… 'somali' => 'openai', // …except the Somali site, which uses OpenAI ],
This is useful when your default translator doesn't support a language on one of your sites — for example, DeepL doesn't support Somali, so that site falls back to OpenAI.
How a translator is chosen
A translation always involves two sites: the source and the target. An explicit,
site-specific entry always beats the '*' fallback — in either direction. So
with the config above, translating between a DeepL site and the Somali site uses
OpenAI whether you're going Norwegian → Somali or Somali → Norwegian.
Translation pairs
If both sites in a translation resolve to different explicit translators, the plugin can't decide which to use and throws a configuration error. Resolve this with a pair override — two site handles joined by a colon. Pair keys match bidirectionally, so the order doesn't matter:
'translator' => [ '*' => 'deepl', 'somali' => 'openai', 'icelandic' => 'google', 'somali:icelandic' => 'openai', // used for both Somali → Icelandic and Icelandic → Somali ],
Changelog
See CHANGELOG.MD.
Credits
Brought to you by Værsågod
Icon designed by Freepik from Flaticon.