How do I translate Magento interface? Magento localization tips

Article ID #1075
Revision: 1.7
Last update: 2013-01-20

Magento interface is translated with CSV localization files (installed as extension in Magento Connect Manager) or using buit-in Inline translation tool. To learn how to enable inline translation please refer to How do I enable Magento inline translation feature article. Translation via editing CSV files can be convenient if you are familar with editing CSV files and want to change a lot of strings at once, in a single place. Inline translation can be convenient to apply minor modifications in existing locale.

 

First of all, please make sure you have installed localization package for your locale. To install localization package simply navigate to System > Magento Connect > Magento Connect Manager in Magento backend and install the localization package entering extension key for your locale (see the table below). Check this article for detailed instructions on installing packages via Magento Connect.

 

When Localization package is installed, you can edit existing translation by changing CSV files in app/locale/xx_XX directory (where xx_XX is the language code, for english locale it is app/locale/en_US). You can always use files from English translation as a base.

If there are no localization package for your locale you can create it by simply copying localization directory from English or any other translation.

 

When editing CSV files please be aware of the following:

  • The first message should be written exactly as it appears in English translation (case sensitive with all punctuation), the second message is a translated message
  • The CSV editor should be capable to save file in UTF-8 encoding (Excel is not capable). It is possible to edit CSV files using Notepad, Notepad++, OpenOffice/LibreOffice
  • Some strings contains %s or %d entries, these entries should be kept in the translated string as well

Another way of doing translation, probably more convenient when editing CSV files is not an option is to enable inline translation at System > Configuration > Developer > Inline Translation in Magento Backend. To learn how to enable inline translation please refer to How do I enable Magento inline translation feature article.

 

Magento translation extensions:

Language Magento 1.4.0.0 - 1.4.1.1 extension key Magento 1.5.x.x/1.7.0.2 extension key

Afrikaans (South Africa)

magento-community/Locale_Mage_community_af_ZA community/Locale_Mage_community_af_ZA
Arabic (Egypt) العربية magento-community/Locale_Mage_community_ar_EG community/Locale_Mage_community_ar_EG
Arabic (Kuwait) العربية magento-community/Locale_Mage_community_ar_KW community/Locale_Mage_community_ar_KW
Arabic (Morocco) العربية magento-community/Locale_Mage_community_ar_MA community/Locale_Mage_community_ar_MA
Arabic (Saudi Arabia) العربية magento-community/Locale_Mage_community_ar_SA community/Locale_Mage_community_ar_SA
Bulgarian (Bulgaria) Български magento-community/Locale_Mage_community_bg_BG community/Locale_Mage_community_bg_BG
Bengali (Bangladesh) বাংলা magento-community/Locale_Mage_community_bn_BD community/Locale_Mage_community_bn_BD
Bosnian (Bosnia) Bosanski magento-community/Locale_Mage_community_bs_BA community/Locale_Mage_community_bs_BA
Catalan (Catalonia) Català magento-community/Locale_Mage_community_ca_ES community/Locale_Mage_community_ca_ES
Czech (Czech Republic) Čeština magento-community/Locale_Mage_community_cs_CZ community/Locale_Mage_community_cs_CZ
Welsh (United Kingdom) Cymraeg magento-community/Locale_Mage_community_cy_GB community/Locale_Mage_community_cy_GB
Danish (Denmark) Dansk magento-community/Locale_Mage_community_da_DK community/Locale_Mage_community_da_DK
German (Austria) Deutsch magento-community/Locale_Mage_community_de_AT community/Locale_Mage_community_de_AT
German (Switzerland) Deutsch magento-community/Locale_Mage_community_de_CH community/Locale_Mage_community_de_CH
German (Germany) Deutsch magento-community/Locale_Mage_community_de_DE community/Locale_Mage_community_de_DE
Greek (Greece) Ελληνικά magento-community/Locale_Mage_community_el_GR community/Locale_Mage_community_el_GR
English (Great Britain) magento-community/Locale_Mage_community_en_GB community/Locale_Mage_community_en_GB
English (Australia) magento-community/Locale_Mage_Community_en_AU community/Locale_Mage_Community_en_AU
Spanish (Argentina) Español magento-community/Locale_Mage_community_es_AR community/Locale_Mage_community_es_AR
Spanish (Chile) Español magento-community/Locale_Mage_community_es_CL community/Locale_Mage_community_es_CL
Spanish (Colombia) Español magento-community/Locale_Mage_community_es_CO community/Locale_Mage_community_es_CO
Spanish (Spain) Español magento-community/Locale_Mage_community_es_ES community/Locale_Mage_community_es_ES
Spanish (Mexico) Español magento-community/Locale_Mage_community_es_MX community/Locale_Mage_community_es_MX
Persian (Iran) فارسی magento-community/Locale_Mage_community_fa_IR community/Locale_Mage_community_fa_IR
Filipino (Philippines) Filipino magento-community/Locale_Mage_community_fil_PH community/Locale_Mage_community_fil_PH
Finnish (Finland) Suomi magento-community/Locale_Mage_community_fi_FI community/Locale_Mage_community_fi_FI
French (Canada) Français magento-community/Locale_Mage_community_fr_CA community/Locale_Mage_community_fr_CA
French (France) Français magento-community/Locale_Mage_community_fr_FR community/Locale_Mage_community_fr_FR
Hebrew (Israel) עברית magento-community/Locale_Mage_community_he_IL community/Locale_Mage_community_he_IL
Croatian (Croatia) Hrvatski magento-community/Locale_Mage_community_hr_HR community/Locale_Mage_community_hr_HR
Hungarian (Hungary) Magyar magento-community/Locale_Mage_community_hu_HU community/Locale_Mage_community_hu_HU
Indonesian (Indonesia) Bahasa Indonesia magento-community/Locale_Mage_community_id_ID community/Locale_Mage_community_id_ID
Italian (Switzerland) Italiano magento-community/Locale_Mage_community_it_CH community/Locale_Mage_community_it_CH
Italian (Italy) Italiano magento-community/Locale_Mage_community_it_IT community/Locale_Mage_community_it_IT
Japanese (Japan) 日本語 magento-community/Locale_Mage_community_ja_JP community/Locale_Mage_community_ja_JP
Lithuanian (Lithuania) Lietuvių kalba magento-community/Locale_Mage_community_lt_LT community/Locale_Mage_community_lt_LT
Latvian (Latvia) Latviešu valoda magento-community/Locale_Mage_community_lv_LV community/Locale_Mage_community_lv_LV
Macedonian (Macedonia) Македонски јазик magento-community/Locale_Mage_community_mk_MK community/Locale_Mage_community_mk_MK
Mongolian (Mongolia) Монгол хэл magento-community/Locale_Mage_community_mn_MN community/Locale_Mage_community_mn_MN
Malaysian (Malaysia) Bahasa Melayu magento-community/Locale_Mage_community_ms_MY community/Locale_Mage_community_ms_MY
Norwegian Bokmal (Norway) Bokmål magento-community/Locale_Mage_community_nb_NO community/Locale_Mage_community_nb_NO
Dutch (Netherlands) Nederlands magento-community/Locale_Mage_community_nl_NL community/Locale_Mage_community_nl_NL
Norwegian Nynorsk (Norway) Nynorsk magento-community/Locale_Mage_community_nn_NO community/Locale_Mage_community_nn_NO
Polish (Poland) Polszczyzna magento-community/Locale_Mage_community_pl_PL community/Locale_Mage_community_pl_PL
Portuguese (Brazil) Português magento-community/Locale_Mage_community_pt_BR community/Locale_Mage_community_pt_BR
Portuguese (Portugal) Português magento-community/Locale_Mage_community_pt_PT community/Locale_Mage_community_pt_PT
Romanian (Romania) Română magento-community/Locale_Mage_community_ro_RO community/Locale_Mage_community_ro_RO
Russian (Russia) Русский magento-community/Locale_Mage_community_ru_RU community/Locale_Mage_community_ru_RU
Slovak (Slovakia) Slovenčina magento-community/Locale_Mage_community_sk_SK community/Locale_Mage_community_sk_SK
Slovenian (Slovenia) Slovenščina magento-community/Locale_Mage_community_sl_SI community/Locale_Mage_community_sl_SI
Albanian (Albania) Shqip magento-community/Locale_Mage_community_sq_AL community/Locale_Mage_community_sq_AL
Serbian (Serbia) Српски magento-community/Locale_Mage_community_sr_RS community/Locale_Mage_community_sr_RS
Swedish magento-community/Locale_Mage_community_sv_SE community/Locale_Mage_community_sv_SE
Thai (Thailand) ภาษาไทย magento-community/Locale_Mage_community_th_TH community/Locale_Mage_community_th_TH
Turkish (Turkey) Türkçe magento-community/Locale_Mage_community_tr_TR community/Locale_Mage_community_tr_TR
Ukrainian (Ukraine) Українська мова magento-community/Locale_Mage_community_uk_UA community/Locale_Mage_community_uk_UA
Vietnamese (Vietnam) Tiếng Việt magento-community/Locale_Mage_community_vi_VN community/Locale_Mage_community_vi_VN
Did this article help you solve your issue?


Average rating: 3.79 (38 votes)

completely useless 1 2 3 4 5 most valuable

Tags: ,