https://github.com/wubinworks/magento2-module-translation
A Magento 2 module [1] Adds translation data from [module or theme root]/i18n/Js/[locale].csv to frontend translation dictionary. [2] Enables Module to override Theme, Language Pack and DB translations by creating CSV file in specific location inside the Module.
https://github.com/wubinworks/magento2-module-translation
japanese language-pack localization magento2 magento2-module theme translation
Last synced: 5 months ago
JSON representation
A Magento 2 module [1] Adds translation data from [module or theme root]/i18n/Js/[locale].csv to frontend translation dictionary. [2] Enables Module to override Theme, Language Pack and DB translations by creating CSV file in specific location inside the Module.
- Host: GitHub
- URL: https://github.com/wubinworks/magento2-module-translation
- Owner: wubinworks
- License: osl-3.0
- Created: 2023-09-15T06:19:33.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-11-19T14:52:03.000Z (over 2 years ago)
- Last Synced: 2023-12-19T16:04:16.372Z (over 2 years ago)
- Topics: japanese, language-pack, localization, magento2, magento2-module, theme, translation
- Language: PHP
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING.txt
Awesome Lists containing this project
README
# Story
*(Everything talked here is for `Magento 2.4`. See **Requirements Section**.)*
This module, which provides 2 features, is designed as a dependency for making other modules/themes.
1. During deployment, Magento scans static `.js` and `.html` files and picks up translatable strings from them.\
Then Magento generates a `js-traslation.json` file.\
This file is a dictionary file used for frontend translation,\
For example: ``\
Unfortunately, translatable strings in `.phtml(and .php)` files are not picked up by Magento(for some reasons).\
If `$.mage.__('Some Text')` is in `.phtml` files, it won't be translated.\
This module can force extra data from a separate file(i.e., [module or theme root]/i18n/**Js**/[locale].csv) to go to `js-traslation.json`.
2. Magento loads translation data in the order below:
```
| Module translation: [module root]/i18n/[locale].csv
| Language Pack translation
| Theme translation: [theme root]/i18n/[locale].csv
\|/ Database translation
```
Then these translation data are merged and the merge rule is **"LAST ONE WINS"**, which means Database translation overrides everything else.\
However, In some cases, especially when doing local development to translate very general phrases in specific business field, the Module creator wants to override Language Pack and Theme translations without modifying those third party packages.\
This module adds extra locations for translation files(CSV), so the loading order becomes:
> | Module translation: [module root]/i18n/[locale].csv
>
> | Language Pack translation
>
> | Theme translation: [theme root]/i18n/[locale].csv
>
> | Database translation
>
> | Extra Module translation: [module root]/i18n/**i18n**/[locale].csv
>
>\\|/ Extra Theme translation: [theme root]/i18n/**i18n**/[locale].csv(last-one-wins)
This module works under *Store Emulation*, too.
# Usage and Example
**1. Append(merge) translation into `js-traslation.json`:**\
Create `/i18n/Js/.csv` like a normal translation CSV file, then its content will go to `js-traslation.json`(even the phrase cannot be found as a translatable string in static files).
**2. Override Language Pack or Theme translations:**\
Create [module or theme root]/i18n/**i18n**/[locale].csv like a normal translation CSV file, then it will work.
*Check examples of this module inside the i18n folder.*
`i18n/ja_JP.csv`
```
"###Translate Me!###","翻訳して！"
```
`i18n/i18n/ja_JP.csv`
```
"###Translate Me!###","翻訳してください！(Override)"
```
`i18n/Js/ja_JP.csv`
```
"###This phrase will go to js-translation.json anyway.###","このフレーズは必ずjs-translation.jsonに出現する。"
"###This phrase will be overridden.###","このフレーズはオーバーライドされる"
```
`i18n/i18n/Js/ja_JP.csv`
```
"###This phrase will be overridden.###","このフレーズをオーバーライドした"
```
Output:
```
###Translate Me!### -> 翻訳してください！(Override)
```
Output in `js-translation.json`:
```
###This phrase will go to js-translation.json anyway.### -> このフレーズは必ずjs-translation.jsonに出現する。
###This phrase will be overridden.### -> このフレーズをオーバーライドした
```
# Requirements
**Magento 2.4**
# Installation
**`composer require wubinworks/module-translation`**