How to create a language package for Magento 2

December 4, 2015 - Fire development, Magento 2

Magento 2 Development

Creating a language package in Magento 2 requires the following steps:

Table of contents

1

Run i18n:collect-phrases5 to collect all phrases you are going to translate:

For instance:

./magento i18n:collect-phrases -o "<path to Magento>/app/i18n/df/ru_ru/dictionary.csv" -m "<path to Magento>"

1	./magento i18n:collect-phrases -o "<path to Magento>/app/i18n/df/ru_ru/dictionary.csv" -m "<path to Magento>"

2

Create an extension for your language package.

2.1

Create a composer.json file.

A core example:

magento/magento2/blob/2.0.0/app/i18n/magento/de_de/composer.json

{
   "name": "magento/language-de_de",
   "description": "German (Germany) language",
   "version": "100.0.2",
   "license": [
       "OSL-3.0",
       "AFL-3.0"
   ],
   "require": {
       "magento/framework": "100.0.*"
   },
   "type": "magento2-language",
   "autoload": {
       "files": [
           "registration.php"
       ]
   }
}

{

"name": "magento/language-de_de",

"description": "German (Germany) language",

"version": "100.0.2",

"license": [

"OSL-3.0",

"AFL-3.0"

"require": {

"magento/framework": "100.0.*"

"type": "magento2-language",

"autoload": {

"files": [

"registration.php"

]

}

The example

{
"name": "dfl/ru"
,"type": "magento2-language"
,"description": "Russian language"
,"homepage": "https://mage2.pro"
,"license": "proprietary"
,"authors": [{
"name": "Dmitry Fedyuk",
"email": "admin@mage2.pro",
"homepage": "https://mage2.pro/users/dmitry_fedyuk",
"role": "Developer"
}] 
,"extra": {"map": [["*", "df/ru_ru"]]}
}

{

"name": "dfl/ru"

,"type": "magento2-language"

,"description": "Russian language"

,"homepage": "https://mage2.pro"

,"license": "proprietary"

,"authors": [{

"name": "Dmitry Fedyuk",

"email": "admin@mage2.pro",

"homepage": "https://mage2.pro/users/dmitry_fedyuk",

"role": "Developer"

}]

,"extra": {"map": [["*", "df/ru_ru"]]}

}

2.2

Now, you should create a language.xml file.

magento/magento2/blob/2.0.0/app/i18n/magento/de_de/language.xml

<?xml version="1.0"?>
<!--
/**
* Copyright © 2015 Magento. All rights reserved.
* See COPYING.txt for license details.
*/
-->
<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
   <code>de_DE</code>
   <vendor>magento</vendor>
   <package>de_de</package>
</language>

<?xml version="1.0"?>

<!--

/**

* See COPYING.txt for license details.

-->

<vendor>magento</vendor>

</language>

The example

<?xml version='1.0'?>
<language xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='urn:magento:framework:App/Language/package.xsd'>
<code>ru_RU</code>
<vendor>df</vendor>
<package>ru_ru</package>
</language>

<?xml version='1.0'?>

</language>

2.3

Now, it’s time to make a registration.php file.

magento/magento2/blob/2.0.0/app/i18n/magento/de_de/registration.php

<?php
/**
* Copyright © 2015 Magento. All rights reserved.
* See COPYING.txt for license details.
*/

\Magento\Framework\Component\ComponentRegistrar::register(
   \Magento\Framework\Component\ComponentRegistrar::LANGUAGE,
   'magento_de_de',
   __DIR__
);