PHPackages                             blackbird/translation-dictionaries-generator - 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. blackbird/translation-dictionaries-generator

ActiveMagento2-module

blackbird/translation-dictionaries-generator
============================================

1.0.7(9mo ago)513.0k↓46.3%4MITPHP

Since Jan 22Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/blackbird-agency/magento-2-translation-dictionaries-generator)[ Packagist](https://packagist.org/packages/blackbird/translation-dictionaries-generator)[ RSS](/packages/blackbird-translation-dictionaries-generator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (2)Versions (10)Used By (0)

Translation Dictionaries Generator
==================================

[](#translation-dictionaries-generator)

[![Latest Stable Version](https://camo.githubusercontent.com/026c8be017f43a367293f705011d856c4b00d70f952affb58dc3b45d6f1989ac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c61636b626972642f7472616e736c6174696f6e2d64696374696f6e61726965732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/blackbird/translation-dictionaries-generator)[![License: MIT](https://camo.githubusercontent.com/98e5917b0c9160bfe66d0ae4ec5ab51d5f4e846a48114b8002f131a9d2e8d80a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f626c61636b626972642d6167656e63792f6d6167656e746f2d322d7472616e736c6174696f6e2d64696374696f6e61726965732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](./LICENSE)

This module allows you to generate translation dictionaries. For each language on your website get the CSV file with default text and existing translations. Your translator can complete missing translations and modify existing ones using the generated CSV files. Once they are completed with all the translations you only need to import them in the i18n folder of your Magento 2.

Setup
-----

[](#setup)

### Get the package

[](#get-the-package)

**Composer Package:**

```
composer require blackbird/translation-dictionaries-generator

```

**Zip Package:**

Unzip the package in app/code/Blackbird/TranslationDictionariesGenerator, from the root of your Magento instance.

### Install the module

[](#install-the-module)

Go to your Magento root directory and run the following magento command:

```
php bin/magento setup:upgrade

```

**If you are in production mode, do not forget to recompile and redeploy the static resources, or use the `--keep-generated` option.**

### Administrators

[](#administrators)

First, you can exclude all modules that you don't want to be translated (ie: Back office modules) to reduce the number of translations. In order to exclude modules go to **Stores** > **Configuration** > **Blackbird Extensions** > **Translation Dictionaries Generator**. Here you have a multiselect field with all the module selected for exclusion.

### Command

[](#command)

To start the translation dictionaries generation you have to run this command:

```
php bin/magento blackbird:translation:export

```

**Warning:** without parameters it will export all languages available on your website

You will find dictionaries files in the following folder: $ROOT\_MAGENTO/var/translation\_export.

#### Parameters

[](#parameters)

- `-l` or `--locale_code` allow you to define which language(s) to export like this:

```
php bin/magento blackbird:translation:export --locale_code=fr_FR,en_US

```

- `-i` or `--input` allow you to use an input CSV file containing all Magento's strings. It will generate a new file with the existing translations for each language for the given strings.

```
php bin/magento blackbird:translation:export -i /home/blackbird/phrases.csv

```

- You can combine both options:

```
php bin/magento blackbird:translation:export -i /home/blackbird/phrases.csv -l fr_FR,en_US

```

### Possible error

[](#possible-error)

Our module uses a feature of Magento to collect all translatable strings of your website like the native command `i18n:collect-phrases`

This feature can generate an error if it finds an empty translatable string (like `__('')`):

```
In Phrase.php line 90:

  Missed phrase

```

To handle this error there are 2 possibilities:

- Your IDE can search that easily
- Use `grep` command in your Magento root folder:

```
grep -rnw . -e "__('')"

```

As soon as you have identified the empty translatable string you can give it a value or comment on it. **But be careful** to rollback after the export (use it in local for more security)

Support
-------

[](#support)

- If you have any issue with this code, feel free to [open an issue](https://github.com/blackbird-agency/magento-2-translation-dictionaries-generator/issues/new).
- If you want to contribute to this project, feel free to [create a pull request](https://github.com/blackbird-agency/magento-2-translation-dictionaries-generator/compare).

Contact
-------

[](#contact)

For further information, contact us:

- by email:
- or by form: [https://black.bird.eu/en/contacts/](https://black.bird.eu/contacts/)

Authors
-------

[](#authors)

- **Kevin Weyhaupt** - *Maintainer* - [It's me!](https://github.com/kevin-blackbird)
- **Blackbird Team** - *Contributor* - [They're awesome!](https://github.com/blackbird-agency)

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

***That's all folks!***

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance58

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~239 days

Recently: every ~417 days

Total

8

Last Release

270d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12445118?v=4)[anthony-blackbird](/maintainers/anthony-blackbird)[@anthony-blackbird](https://github.com/anthony-blackbird)

---

Top Contributors

[![kevin-blackbird](https://avatars.githubusercontent.com/u/37531549?v=4)](https://github.com/kevin-blackbird "kevin-blackbird (6 commits)")[![bruno-blackbird](https://avatars.githubusercontent.com/u/77049160?v=4)](https://github.com/bruno-blackbird "bruno-blackbird (5 commits)")[![anthony-blackbird](https://avatars.githubusercontent.com/u/12445118?v=4)](https://github.com/anthony-blackbird "anthony-blackbird (2 commits)")[![ubermanu](https://avatars.githubusercontent.com/u/1533514?v=4)](https://github.com/ubermanu "ubermanu (1 commits)")

### Embed Badge

![Health badge](/badges/blackbird-translation-dictionaries-generator/health.svg)

```
[![Health](https://phpackages.com/badges/blackbird-translation-dictionaries-generator/health.svg)](https://phpackages.com/packages/blackbird-translation-dictionaries-generator)
```

###  Alternatives

[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[vpietri/adm-quickdevbar

QuickDevBar is a developer toolbar for magento 2

577348.6k](/packages/vpietri-adm-quickdevbar)[msp/devtools

222629.1k2](/packages/msp-devtools)[msp/cmsimportexport

76510.8k](/packages/msp-cmsimportexport)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)