Skip Navigation
May 17, 2021

Woodmart’s integration with WPML allows you to build fully functional multilingual eCommerce websites. This guide teaches you how to translate the different elements of the site you built with WoodMart and WPML. 


Getting started

To follow along with this tutorial, make sure that you install and activate WoodMart theme along with the WPML core plugins which include WPML Multilingual CMS, WPML String Translation, and WPML Translation Management. 

Check out WPML’s getting started guide to learn how to set up and configure WPML on your site.

For a better translation experience, we recommend that you activate the WPML’s Advanced Translation Editor. To do this, go to the WPMLSettings page. Under the How to translate posts and pages section, check the “Use WPML’s Advanced Translation Editor” option.

Enabling the Advanced Translation Editor

WPML translation tools

We recommend using WPML’s Advanced Translation Editor as it offers affordable automatic translation, a glossary, spell checker, and more!

Besides translating your site content yourself, you can also:

Translating pages

WoodMart theme is bundled with Elementor and WPBakery Page Builder and offers prebuilt demos for both. WPML is fully compatible with both these page builders along with the WordPress Block Editor (Gutenberg).

WPML allows you to translate the pages and posts content yourself, assign the translation jobs to one of your users assigned as translators, or send the content to be translated by a professional translation service. 

To manage the translation of your site you can use WPML’s Translation Management. Simply navigate to the WPML Translation Management page to send content for translation. The first time you visit the Translation Management page, WPML will walk you through a quick setup wizard where you choose who will translate your site and select your preferred translation editor.

Sending content for translation

You can also translate the page by clicking the plus icon in the language meta-box on the post or page editing screen.

Translating the page by clicking the plus icon in the WPML Language box

On the Advanced Translation Editor page, click the Translate automatically button to get an instant translation. Review the translation to make sure that it is human-readable then click the green checkmark button to save it. Finally, click on the Complete button to publish the translated page.

Adding automatic translation and publishing the translated page

Naturally, you can translate posts and project items in a similar fashion.

Translating headers

WoodMart header builder allows you to add different elements to the header such as menus, HTML/Text, search fields, and categories. Translating different groups of elements requires following different translation workflows. 

WoodMart default language header

Translating header Text/HTML, Information box, and Button elements

  1. Go to WPMLString Translation. From the In domain dropdown menu, choose the header text domain. In our example, the header text domain name is “admin_texts_whb_header_528910”.
Selecting the header text domain on the String Translation screen

You will notice that when you select this domain, only the Text/HTML, information box, and button elements are listed. Other header elements are listed under different domains. We will cover their translation workflow later in this guide.

Please note that the number part in your header text domain may be different as it represents the header ID on your website. You can get your header ID by navigating to the header editing page. You can see the header ID in the URL. 

Finding the header ID
  1. To avoid breaking the element structure that you are translating, we recommend using WPML’s Advanced Translation Editor (ATE) as it allows visual translation without having to edit HTML.

Select the header strings that you want to translate. Then, under the Translate selected strings section, choose the language(s) that you want to translate your elements into and click on the Add to translation basket button.

Adding header strings to the translation basket
  1. Assign the translation job to yourself or a local translator by navigating to WPMLTranslation Management. Click the Translation Basket tab then click the Send all items for translation button.
Sending header strings for translation
  1. Go to WPMLTranslations and click the Take and translate button. This takes you to the Advanced Translation Editor screen.
Navigating to the ATE screen to translate the strings
  1. Translate the strings then click on the Complete button to publish the translation.
Translating the strings using ATE

With that, you learned how to translate the Text/HTML, Information box, and Button elements.

Translating header menus

You can easily add standard WordPress menus to your header. Visit our dedicated page to learn how to translate menus.

Translating other header elements

You can translate other header element texts such as the search field placeholder text and “My Account” by following the steps below:

  1. Navigate to WPMLString Translation. In the search for field, type in the header text that you want to translate and click the Search button.
  2. Click on the plus icon. Then, add the translation.
Translating other header element texts using the String Translation screen

This is how the translated header looks like on the front-end:

Secondary language header on the front-end

Translating HTML Blocks

With WoodMart theme, you can create custom HTML blocks that you can embed in different places in your website such as headers and footers, using shortcodes or widgets. 

Translating HTML Blocks is very similar to translating posts and pages. Navigate to HTML BlocksAll Items, then click on the plus icon under the language you want to translate your HTML block into. This takes you to the Advanced Translation Editor screen where you can translate the HTML block text.

Translating HTML Blocks

 Translating sliders

WoodMart comes with its own custom slider. Translating slides is similar to translating posts and pages. To translate WoodMart slides follow the steps below:

  1. Go to SlidesAll Items. Then click the Edit link of the slide that you want to translate.
Navigating to the slide editing page
  1. Click on the plus icon corresponding to the language you want to translate your slide into. This takes you to the Advanced Translation Editor screen where you can translate the slide text.
Clicking the plus icon to translate the slide

WoodMart theme is also bundled with the Revolution Slider plugin. Check out our detailed guide that explains the process of translating Revolution Slider slides.

Translating categories and tags 

You can translate categories and tags assigned to a specific post or portfolio pages while translating them using the WPML translation editor screen.

Furthermore, you can translate categories and tags on the WPMLTaxonomy Translation page. In the example below, we walk you through the process of translating project categories. You can follow the same steps to translate post categories and tags.

  1. Select the Project Categories from the drop-down menu and a list of categories will appear.
  2. Click the plus icon for translating a category of the respective language.
Navigating to the Taxonomy translation screen
  1. Fill in the translation and click the Save button.
Translating taxonomies

Translating texts from WoodMart theme, plugins, and other places

Besides content coming from posts and pages on your site, there are usually some texts coming from other places. The most common examples are themes and plugins. To learn how to translate these texts, visit WPML’s documentation page about translating strings.

Translating WooComerce elements using WCML

To translate everything that WooCommerce offers, download the WooCommerce Multilingual plugin (WCML) from your WPML account. 

Visit our dedicated WCML documentation to learn how to set up a multilingual store and translate your products, categories, variations, shipping classes, and more.

Translating menus

With WPML, you can easily synchronize your language menus. For more information, check out WPML’s guide on translating menus.

Getting help

In case you need help translating your site built using WoodMart theme and WPML, visit WPML’s support forum