This page covers WoodMart stores built with Elementor and with the block editor. Most of it applies to both. The parts that differ are in their own sections near the end.
Before You Start
- Activate WooCommerce Multilingual. It is WPML's add-on for WooCommerce stores. It translates your products and gives each language its own cart and checkout pages. Read about WooCommerce Multilingual.
- Make WoodMart's layouts translatable. Go to WPMLSettingsPost Types Translation and set Layouts to Translatable. Layouts are the designs you make with WoodMart's layouts builder, such as your product page, shop page and cart.
- Translate each layout into every active language. Translate Everything does this for you. If you send from the Translation Dashboard, include every language.
With Translate Everything On: What WPML Translates for You
If you use PTC and your site is on Translate Everything, WPML translates this content for you. You do not need to send or review it.
- Pages, posts and products, with their product tabs.
- HTML blocks: the reusable blocks WoodMart uses in footers and other places.
- Layouts, once you have made them translatable.
- Popups and floating blocks.
- Slides of WoodMart's sliders.
- Portfolio items and blog posts.
- The Theme Settings texts: the copyright line, the cookies notice, the promo popup, the age verification and the header banner.
- Your header and its texts. Your translated pages show the same header as the original. There is nothing you need to do for it.
You set it up in the Translate Everything Automatically box at the top of WPMLTranslations.
Read how to translate everything automatically.
What You Translate Once Yourself
A few texts are not in Translate Everything's queue. You translate them once:
- Text widgets in your footer. Translate them in the Strings tab of WPMLTranslations.
- Your child theme's own texts. Scan the child theme once, then translate its texts in the Strings tab. See Translating WoodMart's Theme Settings and Child Theme Texts.
- Your menus. Translate Everything does not create translated menus. Create them once in the Menus tab of WPMLTranslations. See Translating WoodMart Menus and Mega Menus.
With Translate Everything Off: Send from the Translation Dashboard
You choose what to translate and when.
- Open the Translation Dashboard. Go to WPMLTranslations. WoodMart's content is in its own sections: Pages, Products, HTML Blocks, Layouts, Popups and Slides. Theme Settings and header texts are in Other texts (Strings).
- Select the items. Check the box next to each one.
- Choose automatic translation. Under Translate your content, choose Translate automatically for each language.
- Choose Publish without review. Under What would you like to do when WPML finishes translating your content automatically?, choose Publish without review (Recommended). Translations from PTC are ready to publish, so they go live as soon as they are done.
- Send it. Click Translate content.
The translations complete in minutes and are live. You can look at your translated pages to see for yourself.
Read more about the Translation Dashboard.
Translating WoodMart's Theme Settings and Child Theme Texts
- Find the Theme Settings texts. In WPMLTranslations, open Other texts (Strings) and filter by the domain
admin_texts_xts-woodmart-options. Send them as above. - One set of settings for the whole site. Theme Settings has one set of options for all languages. You translate its texts as strings. You do not rebuild them per language.
- Saving in another admin language is safe. If you save Theme Settings while the WordPress admin is in another language, your original values stay as they are.
- Your child theme's own texts. Scan the child theme in WPMLSettingsCompatibility, in the Theme and plugins localization section. Then translate its texts in the Strings tab of WPMLTranslations.
If your child theme has its own wpml-config.xml file, the file that tells WPML what to translate, WPML does not read it. WPML uses its own WoodMart configuration instead. Ask WPML support to add what your child theme needs. Your child theme's texts still translate after the scan.
Read more about translating strings.
Translating the WoodMart Header
If your site is on Translate Everything, your header is already translated. The steps below are for sending it from the Translation Dashboard.
WoodMart's header builder saves each header's texts as strings. WPML lists them by the header's id, not by its name. So you start with the id.
- Find your header's id. Open the header in WoodMart's header builder. The id is in the page's URL, for example
header_153799. - Open its texts. Go to WPMLTranslations, open Other texts (Strings) and filter by the domain that ends with the same id, for example
admin_texts_whb_header_153799. - Send them. Check the texts, such as the text element and the categories title. Send them as above, with Translate automatically and Publish without review.
- After you edit a header text, its translation shows as needing an update. Send it again.
- The language switcher element in the header works in every language.
- The header's info box. Its title, subtitle and button text are translated with the header's other texts.
- One header in every language. Your translated pages show the same header as the original.
Translating the WoodMart Footer
- HTML block columns in the footer are translated with your other HTML blocks, by Translate Everything or from the HTML Blocks section of the Translation Dashboard.
- Text widgets in the footer are strings. Translate them in the Strings tab, or send them from Other texts (Strings) in the Translation Dashboard.
Translating WoodMart Menus and Mega Menus
- Create each translated menu once. Go to the Menus tab of WPMLTranslations and sync your menus. Translate Everything does not create translated menus for you.
- Mega menu dropdowns come along. After the menu sync, a translated menu item keeps its mega menu dropdown.
- The dropdown's HTML block is translated with your other HTML blocks.
- On Elementor sites: category and brand links in the dropdown lead to the translated pages. WoodMart's Mega Menu widget works too.
Read more about translating menus.
Translating WoodMart Layouts
- Make them translatable first. Set Layouts to Translatable, as in Before You Start.
- Then they translate like your other content. Translate Everything translates them. Without it, send them from the Layouts section of the Translation Dashboard.
- Category conditions follow the translation. When you send layouts from the Translation Dashboard, a layout set to show on a product category also shows on that category's translated products.
- Later condition changes follow too. If you change a condition on the original layout later, send the layout again. The translated layout gets the new condition.
- Translate each layout into every active language.
WoodMart Product Pages in Other Languages
- WoodMart page options. When you translate a page or a product, the translation gets the original's WoodMart options: the page title switched off, the open categories menu, the sidebar position, and the prefooter switched off.
- Later option changes follow too. If you change one of these options on the original and save it, the translation gets the new value.
- These work in every language: product tabs, color swatches, frequently bought together, linked variations, and the mark that shows a reviewer bought the product.
- Custom labels and size guides. Send them from the Translation Dashboard, like your products. The translated product shows its translated label and size guide.
- The NEW badge. If you give a product WoodMart's permanent New label, the translated product shows the badge too, on its product page and in product category listings.
- Variation galleries. With WoodMart's default variation gallery setting, the translated product shows a gallery for each variation when you send it from the Translation Dashboard.
- Products with many variations. When you send a variable product from the Translation Dashboard, the translated product shows every variation, with each attribute term in the visitor's language. Prices and SKUs match the original's.
- Product videos. The video gallery comes with the translated product. To show a different uploaded video file in a language, set it on the translated product.
- Reviews and comments. Product reviews show in every language. Blog post comments show in the language they were written in.
- Variation galleries saved the older way. WoodMart saves variation galleries in one of two ways. Galleries saved the older way are translated too when you send products from the Translation Dashboard.
Shop, Cart and Checkout in a WoodMart Store
- Categories. A category's extra description is translated.
- Categories with the same slug in each language. If a translated category keeps the original's slug, its category page still opens in the visitor's language, with that language's layout.
- The default product category follows each language. This is the category WooCommerce gives a product that has no category of its own.
- Cart and checkout pages. WooCommerce Multilingual maps them to each language, with no rebuild. Their links lead to the translated pages.
- The free shipping bar message is translated.
- Checkout labels you renamed. If you rename a field's label in WoodMart's checkout fields manager, the new label is a string. Send it from Other texts (Strings) in the Translation Dashboard. The translated checkout shows it translated.
- Free gifts. With Translate Everything, the gift product's name is translated in the cart.
- On Elementor sites: WoodMart does not print its free gifts table on a cart page built with a cart layout, in any language. This is how the theme works.
WoodMart Wishlist and Compare Pages
- The wishlist and compare pages are translated, with Translate Everything, from the Translation Dashboard and when you build them by hand.
- The header's wishlist and compare links lead to the translated pages when you send from the Translation Dashboard.
- The compare list. On the translated pages, visitors add products to the compare list, remove them and empty the list, the same way as in the original. The list shows each product in the visitor's language.
WoodMart with Elementor
- Elementor Pro header and footer. An Elementor Pro header or footer in WoodMart's header location is translated, with Translate Everything or from the Translation Dashboard. Read how to translate an Elementor website with WPML.
- The page's header setting. The WoodMart header setting of a page is copied to the translated page.
- WoodMart's Elementor widgets are translated with their page. The Marquee widget works too.
- Sliders. Slides are translated with Translate Everything, from the Translation Dashboard, and when you rebuild them by hand.
- AJAX search answers with products in the visitor's language.
WoodMart with the Block Editor
- WoodMart's blocks are translated with Translate Everything, from the Translation Dashboard, and when you rebuild them by hand.
- Paragraph blocks stay intact when you save the translated page in the block editor.
- Links in HTML blocks. Links inside HTML blocks you build with the block editor lead to the translated pages.
- Mega menu links. The category and brand links in a mega menu dropdown lead to the translated category and brand pages.
Different Content in Each Language
You can rebuild some parts by hand in a language, in their own editor:
- Pages.
- HTML blocks.
- Header templates made with Elementor Pro.
Rebuild after the last send. If you rebuild a block or page by hand in a language, do it after the last send, or do not send that item again. Sending it again replaces your rebuild with the translation. Read about using different translation editors for different pages.
Other parts have one copy for all languages. You translate them instead of rebuilding them:
- Theme Settings and headers: in the Strings tab, or from Other texts (Strings) in the Translation Dashboard. Every language shows the same header as the original.
- Product categories: in the Taxonomy tab of WPMLTranslations. The translated category page appears once its category is translated.
- Cart and checkout: WooCommerce Multilingual maps these pages to each language. You do not rebuild them.
If You Want to Change a Translation
You do not need to check anything. If you want to change a text, do it this way:
- Open Translation Jobs. Go to WPMLTranslationsTranslation Jobs.
- Click the pencil on the job's row. Use the row of the language you want. The pencil's title is Edit Translation. The Advanced Translation Editor opens.
- Edit what you want. Change any text in the editor.
- Click Save and Complete. Always finish this way, even with no change. Otherwise the job stays In progress.
When you use PTC, it learns from your edits, so you do not need to keep making the same corrections.
See WoodMart's compatibility status on the WoodMart theme page.