How to Translate a Theme

All of our themes include a language file to make translating to a different language easy. Inside the theme folder /wp-content/themes/themename/languages , you’ll find a language file named themename.pot.

Configure WordPress

Before translating your theme, you’ll need to make sure WordPress is setup correctly with your locale.  Open wp-config.php and modify the line below, or add it if it is missing.  See the complete list of language codes and country codes to find your exact locale.

 * WordPress Localized Language, defaults to English.
 * Change this to localize WordPress.  A corresponding MO file for the chosen
 * language must be installed to wp-content/languages. For example, install
 * to wp-content/languages and set WPLANG to 'de' to enable German
 * language support.
define ('WPLANG', 'nb_NO');

Once this has been done you need to translate the language file in the theme using a plugin.

Installing a Plugin

Now you’re ready to translate your theme. The easiest way to do this is by installing the Codestyling Localization plugin. Install and activate the plugin and go to Tools → Localization (shown in your language), then follow the instructions on how to translate the theme.

Handling Theme Updates

If you update your theme to a new version which has an updated language file, you’ll need to rescan your theme using the plugin and then translate the new strings. Find your theme in Codestyling Localization plugin and click the Rescan link to have the plugin update the pot file.

After you have rescanned your theme, click Edit to translate any new strings the plugin found when rescanning. Remember to generate a new MO file after you have translated your new strings.

Other Resources