PHPackages                             mutation/translate - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. mutation/translate

ActiveCraft-plugin[Localization & i18n](/categories/localization)

mutation/translate
==================

Translate messages in the control panel

4.2.2(3mo ago)1261.2k↓20.5%11[5 issues](https://github.com/MutationDigitale/craft3-translate/issues)[5 PRs](https://github.com/MutationDigitale/craft3-translate/pulls)proprietaryPHPPHP ^8.2CI passing

Since Jan 10Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/MutationDigitale/craft3-translate)[ Packagist](https://packagist.org/packages/mutation/translate)[ RSS](/packages/mutation-translate/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (133)Used By (0)

Translations admin plugin for Craft CMS
=======================================

[](#translations-admin-plugin-for-craft-cms)

This plugins adds a control panel interface for your clients to edit your static translations for each language side by side.

[![Screenshot](./img/translate-plugin-screenhot.jpg)](./img/translate-plugin-screenhot.jpg)

Features
--------

[](#features)

- Add, edit or delete translations in the Control Panel with each language side by side.
- Choose a category, filter by missing translations, search by keywords and sort by key/date.
- Export all or a subset of your translations to a CSV file and import it back after translators worked on it.
- Translations will be kept inside your database instead of PHP files for a better workflow.
- Optionally, missing translations are automatically added to the database when a page is visited.
- Ability to parse your twig templates or migrate from your existing PHP translations (and export it back to PHP files).
- GraphQL support to query your translations.

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.0.0 or later.

Installation
------------

[](#installation)

Install the plugin via the **Plugin Store** or by command line:

```
composer require mutation/translate
php craft install/plugin translations-admin

```

You can now edit your translations in the control panel `/admin/translations-admin`.

Permissions
-----------

[](#permissions)

You have special permissions for the Translations admin plugin:

- Save translations
- Add translations
- Delete translations
- Update translations
- Export translations
- Import translations
- Use translations utilities
- Change translations settings

Settings
--------

[](#settings)

You can either go the **settings page** or create a file `translations-admin.php` in your `config` directory.

- **Plugin Name**: How the plugin should be named in the CP
- **Source Language**: By default, the plugin uses the primary site for the source language, but you can override it with this setting.
- **Categories**: Choose the source message categories you want to have in your database and control panel.
- **Add missing translations**: Controls whether missing translations are automatically added to the database when a page is visited.
- **Add missing translations for site request only**: Controls whether missing translations are only added when the request is from the site.
- **Excluded Messages**: Messages that should not be added to the database, identified by the start of the string (basic matching, no regex — see example).

Config file example:

```