Translate WoodMart with Loco Translate

Use Loco Translate when your language is not included in the predefined WoodMart translations or when you need to change specific translated strings. This article covers translations for the WoodMart theme text domain.

Install Loco Translate

1. Navigate to Dashboard -> Plugins -> Add New Plugin.

2. Search for Loco Translate, click Install Now, and then activate the plugin.

Loco Translate plugin on the WordPress plugin installation page. — Install and activate the Loco Translate plugin.

Create a translation for a new language

Before creating the translation, select the same language through Dashboard -> Settings -> General -> Site Language.

1. Navigate to Dashboard -> Loco Translate -> Themes and select WoodMart.

WoodMart theme selected in Loco Translate. — Select WoodMart from the list of translatable themes.

2. Click New language.

New language link for the WoodMart theme in Loco Translate. — Create a new WoodMart translation.

3. Choose the required WordPress language. Under Choose a location, select Custom. The translation will be stored in wp-content/languages/loco/themes, where WordPress and theme updates will not replace it.

Custom translation location selected for a new WoodMart language. — Save the new translation in the Custom location.

4. Click Start translating. Select or search for an English source string, enter its translation in the lower editor pane, and click Save.

Translation editor in Loco Translate with a WoodMart source string and its translation. — Enter the translation for the selected WoodMart source string.

Customize a predefined translation

If a predefined WoodMart translation is already installed, create a custom copy for the strings you want to override. Do not edit the original system translation because a translation update can replace it.

1. Navigate to Dashboard -> Loco Translate -> Themes -> WoodMart. Find the predefined language and click Copy.

Copy action for an existing WoodMart translation in Loco Translate. — Copy the predefined translation before customizing it.

2. Keep the same language and select the Custom location in wp-content/languages/loco/themes. Under Template options, select Just copy English source strings and keep Use this file as template when running Sync enabled. This creates a small override file while the predefined translation supplies all unchanged strings.

Custom location and template options when copying a WoodMart translation. — Use the Custom location and select Just copy English source strings. The older screenshot shows the alternative Copy target translations option.

3. Click Start translating, search for each string you want to change, enter the replacement translation, and click Save.

Search field and custom translation entered in the Loco Translate editor. — Search for a source string and enter only the translation you want to override.

Note

Keep Loco Translate active so it can load files from the Custom location. Files saved in the System or Author locations may be replaced by WordPress or theme updates.

Synchronize after a theme update

After updating WoodMart and its predefined translations, synchronize your custom file so it includes the latest source strings.

1. Navigate to Dashboard -> Loco Translate -> Themes -> WoodMart and open the custom translation.

2. Click Sync. Review any added, removed, or fuzzy strings, translate the required new strings, and then click Save. Synchronization does not write the changes to the file until you save them.

Sync button in the Loco Translate editor. — Synchronize the custom translation after updating WoodMart.

Strings belonging to WooCommerce or another plugin are not part of the WoodMart theme translation. To change them, select the relevant plugin through Dashboard -> Loco Translate -> Plugins.