Translating with the Poedit Software

Last Updated on

Theme translation is the process of translating texts from one language into another. Since Ken does not provide files in languages other than English, many users look for ways to translate their theme into their own language. There are a lot of ways to translate a theme but this article will explain how to translate with the Poedit software.

Contrary to other translation methods using plugins, this method requires the Poedit software, a handy computer software that is used for the translation of language files.

In this article


Changing the Default Language

To set the default language of WordPress:

1
From the WordPress left menu, go to Settings > General.
2
Change the Site Language field to your target language.
3
Click on Save Changes.

Installing the Poedit Software

To install the Poedit software:

1
Go to the official Poedit website.
2
The Poedit software is available for different platforms such as Windows, MacOS, Unix / Linux. Click on the Download button that fits with your operating system. The download will start automatically.
3
Select “I agree with these terms” and click on Next. Run the setup and finish the installation.

Finding and Configuring the Translation File

To find the translation file of your website:

1
Install a child theme.
x
Note: If you are not sure how to install a child theme, read the Installing the theme and child theme article.
2
Go to your-website-index/wp-content/themes/ken and copy and paste the /languages folder into the your-website-index/wp-content/themes/ken-child folder. So your new language file will be your-website-index/wp-content/themes/ken-child/languages

Translating the Theme

To translate the theme:

1
Open the Poedit software.
2
Open up the PO file that you copied into your child theme under the languages folder by going to the Files > Open menu. Alternatively, you can use the Control + O shortcut keys for Windows and Command + O for Mac.
3
Go to Files > Save As to name it according to your target language and click on Save.

For example, in case of you want to create a translation file for Spanish (Argentina), name your file as es-AR . The language file extension (.po) will be added automatically.

Here is the language code list for your translation file:

Code Name
afAfrikaans
af-ZAAfrikaans (South Africa)
arArabic
ar-AEArabic (U.A.E.)
ar-BHArabic (Bahrain)
ar-DZArabic (Algeria)
ar-EGArabic (Egypt)
ar-IQArabic (Iraq)
ar-JOArabic (Jordan)
ar-KWArabic (Kuwait)
ar-LBArabic (Lebanon)
ar-LYArabic (Libya)
ar-MAArabic (Morocco)
ar-OMArabic (Oman)
ar-QAArabic (Qatar)
ar-SAArabic (Saudi Arabia)
ar-SYArabic (Syria)
ar-TNArabic (Tunisia)
ar-YEArabic (Yemen)
azAzeri (Latin)
az-AZAzeri (Latin) (Azerbaijan)
az-AZAzeri (Cyrillic) (Azerbaijan)
beBelarusian
be-BYBelarusian (Belarus)
bgBulgarian
bg-BGBulgarian (Bulgaria)
bs-BABosnian (Bosnia and Herzegovina)
caCatalan
ca-ESCatalan (Spain)
csCzech
cs-CZCzech (Czech Republic)
cyWelsh
cy-GBWelsh (United Kingdom)
daDanish
da-DKDanish (Denmark)
deGerman
de-ATGerman (Austria)
de-CHGerman (Switzerland)
de-DEGerman (Germany)
de-LIGerman (Liechtenstein)
de-LUGerman (Luxembourg)
dvDivehi
dv-MVDivehi (Maldives)
elGreek
el-GRGreek (Greece)
enEnglish
en-AUEnglish (Australia)
en-BZEnglish (Belize)
en-CAEnglish (Canada)
en-CBEnglish (Caribbean)
en-GBEnglish (United Kingdom)
en-IEEnglish (Ireland)
en-JMEnglish (Jamaica)
en-NZEnglish (New Zealand)
en-PHEnglish (Republic of the Philippines)
en-TTEnglish (Trinidad and Tobago)
en-USEnglish (United States)
en-ZAEnglish (South Africa)
en-ZWEnglish (Zimbabwe)
eoEsperanto
esSpanish
es-ARSpanish (Argentina)
es-BOSpanish (Bolivia)
es-CLSpanish (Chile)
es-COSpanish (Colombia)
es-CRSpanish (Costa Rica)
es-DOSpanish (Dominican Republic)
es-ECSpanish (Ecuador)
es-ESSpanish (Castilian)
es-ESSpanish (Spain)
es-GTSpanish (Guatemala)
es-HNSpanish (Honduras)
es-MXSpanish (Mexico)
es-NISpanish (Nicaragua)
es-PASpanish (Panama)
es-PESpanish (Peru)
es-PRSpanish (Puerto Rico)
es-PYSpanish (Paraguay)
es-SVSpanish (El Salvador)
es-UYSpanish (Uruguay)
es-VESpanish (Venezuela)
etEstonian
et-EEEstonian (Estonia)
euBasque
eu-ESBasque (Spain)
faFarsi
fa-IRFarsi (Iran)
fiFinnish
fi-FIFinnish (Finland)
foFaroese
fo-FOFaroese (Faroe Islands)
frFrench
fr-BEFrench (Belgium)
fr-CAFrench (Canada)
fr-CHFrench (Switzerland)
fr-FRFrench (France)
fr-LUFrench (Luxembourg)
fr-MCFrench (Principality of Monaco)
glGalician
gl-ESGalician (Spain)
guGujarati
gu-INGujarati (India)
heHebrew
he-ILHebrew (Israel)
hiHindi
hi-INHindi (India)
hrCroatian
hr-BACroatian (Bosnia and Herzegovina)
hr-HRCroatian (Croatia)
huHungarian
hu-HUHungarian (Hungary)
hyArmenian
hy-AMArmenian (Armenia)
idIndonesian
id-IDIndonesian (Indonesia)
isIcelandic
is-ISIcelandic (Iceland)
itItalian
it-CHItalian (Switzerland)
it-ITItalian (Italy)
jaJapanese
ja-JPJapanese (Japan)
kaGeorgian
ka-GEGeorgian (Georgia)
kkKazakh
kk-KZKazakh (Kazakhstan)
knKannada
kn-INKannada (India)
koKorean
ko-KRKorean (Korea)
kokKonkani
kok-INKonkani (India)
kyKyrgyz
ky-KGKyrgyz (Kyrgyzstan)
ltLithuanian
lt-LTLithuanian (Lithuania)
lvLatvian
lv-LVLatvian (Latvia)
miMaori
mi-NZMaori (New Zealand)
mkFYRO Macedonian
mk-MKFYRO Macedonian (Former Yugoslav Republic of Macedonia)
mnMongolian
mn-MNMongolian (Mongolia)
mrMarathi
mr-INMarathi (India)
msMalay
ms-BNMalay (Brunei Darussalam)
ms-MYMalay (Malaysia)
mtMaltese
mt-MTMaltese (Malta)
nbNorwegian (Bokmå)
nb-NONorwegian (Bokmå) (Norway)
nlDutch
nl-BEDutch (Belgium)
nl-NLDutch (Netherlands)
nn-NONorwegian (Nynorsk) (Norway)
nsNorthern Sotho
ns-ZANorthern Sotho (South Africa)
paPunjabi
pa-INPunjabi (India)
plPolish
pl-PLPolish (Poland)
psPashto
ps-ARPashto (Afghanistan)
ptPortuguese
pt-BRPortuguese (Brazil)
pt-PTPortuguese (Portugal)
quQuechua
qu-BOQuechua (Bolivia)
qu-ECQuechua (Ecuador)
qu-PEQuechua (Peru)
roRomanian
ro-RORomanian (Romania)
ruRussian
ru-RURussian (Russia)
saSanskrit
sa-INSanskrit (India)
seSami (Northern)
se-FISami (Northern) (Finland)
se-FISami (Skolt) (Finland)
se-FISami (Inari) (Finland)
se-NOSami (Northern) (Norway)
se-NOSami (Lule) (Norway)
se-NOSami (Southern) (Norway)
se-SESami (Northern) (Sweden)
se-SESami (Lule) (Sweden)
se-SESami (Southern) (Sweden)
skSlovak
sk-SKSlovak (Slovakia)
slSlovenian
sl-SISlovenian (Slovenia)
sqAlbanian
sq-ALAlbanian (Albania)
sr-BASerbian (Latin) (Bosnia and Herzegovina)
sr-BASerbian (Cyrillic) (Bosnia and Herzegovina)
sr-SPSerbian (Latin) (Serbia and Montenegro)
sr-SPSerbian (Cyrillic) (Serbia and Montenegro)
svSwedish
sv-FISwedish (Finland)
sv-SESwedish (Sweden)
swSwahili
sw-KESwahili (Kenya)
syrSyriac
syr-SYSyriac (Syria)
taTamil
ta-INTamil (India)
teTelugu
te-INTelugu (India)
thThai
th-THThai (Thailand)
tlTagalog
tl-PHTagalog (Philippines)
tnTswana
tn-ZATswana (South Africa)
trTurkish
tr-TRTurkish (Turkey)
ttTatar
tt-RUTatar (Russia)
tsTsonga
ukUkrainian
uk-UAUkrainian (Ukraine)
urUrdu
ur-PKUrdu (Islamic Republic of Pakistan)
uzUzbek (Latin)
uz-UZUzbek (Latin) (Uzbekistan)
uz-UZUzbek (Cyrillic) (Uzbekistan)
viVietnamese
vi-VNVietnamese (Viet Nam)
xhXhosa
xh-ZAXhosa (South Africa)
zhChinese
zh-CNChinese (S)
zh-HKChinese (Hong Kong)
zh-MOChinese (Macau)
zh-SGChinese (Singapore)
zh-TWChinese (T)
zuZulu
zu-ZAZulu (South Africa)

4
Select the line that you want to translate. Alternatively, find the text by going to Edit > Find or use the Control + F shortcut keys for Windows and Command + F for Mac.

5
Write the translated text below the field.
6
 Go to Files > Save.

Uploading the Translation Files

To move your translated files into your website language folder:

1
Access your website index via the (S)FTP software by entering your (S)FTP login credentials. If your website is on a localhost, skip this step.
2
Go to your-website-index/wp-content/themes/ken-child/languages folder and paste your translated files that have the .PO and .MO extensions. Click Yes to override the existing language files if necessary.
Was this helpful?
Previous Article:
Next Article:

Can't find what you're looking for?

Open New Ticket