TemplateMonster is one of the largest WordPress theme houses. Many of its themes share the common Cherry Framework which is compatible with WPML, nevertheless we did not test each and every TemplateMonster theme with WPML yet, so we can not promise 100% compatibility with all of their themes.
In this tutorial, we teach you how to run multilingual sites with a Cherry-based theme (Monstroid) and WPML.
Themes based on TemplateMonster’s Cherry Framework come with a rich assortment of normal and custom post types (CPTs). In this case, most CPTs come from the Cherry Framework itself; therefore, you’ll find them in all Cherry-based TemplateMonster themes. All these CPTs are translatable, which means they can be translated using standard WPML methods.
What you will need
- A recent version of WPML (version 3.3.6 or above), including the String Translation, Translation Management, and Media Translation add-ons.
- Monstroid Theme (version 1.1.2 or above)
- Cherry Framework (version 4.0.2 or above)
- Monstroid documentation has step-by-step instructions on how to fully setup your website and alter all theme elements.
- WPML’s Getting Started Guide will help you in setting up WPML in a few minutes. You would want to refer later to some of its subtopics, such as Theme and Plugin Localization and String Translation.
- Getting started
- Translating the home page (pages created with the MotoPress content editor)
- Translating pages, posts, CPTs, and custom taxonomies
- Translating theme text and other strings
- Translating MotoPress Slider
- Translating menus
- Translating the contact page
- Translating widgets
- Install Cherry Framework, Monstroid Theme, and the sample content using Monstroid Wizard.
- Install and activate the core WPML plugins (WPML Multilingual CMS, WPML String Translation, WPML Translation Management, WPML Media Translation) and then install other WPML plugins that may depend on them.
- Set up WPML from your WordPress dashboard by navigating to WPML >> Languages and following the instructions. See our WPML Getting Started Guide for complete reference, but the initial simple three-step setup is self-explanatory, asking you to choose your default language, a set of active languages, and a language selector. (For starters, choose the footer language selector. You can change this later.)
- You’ll probably be interested in the process of batch duplication of pages and posts (we actually used it to set up this tutorial). To use this feature, follow the steps below:
- Navigate to WPML >> Translation Management.
- From the Translation Dashboard (the tab that is opened by default), select the (Pages/Posts) you want to duplicate the content of.
- Choose the “Duplicate content” option and click on the “Duplicate” button. See the below illustration:
Translating the home page (pages created with the MotoPress page builder)
To translate the sample home page or any other page created with the MotoPress page builder follow these steps:
- Navigate to “Pages.”
- Find the home page and click the icon to edit the translation.
- Add the translated text to the title, and then click on the “Translate independently” button found in the language meta-box on the right.
- Click on the “MotoPress Content Editor” button.
- Add the translated text to different page elements by editing the element and filling out the translated required text as shown below:
Note that the imported home page includes different theme elements (CPTs, sliders, menus, widgets); in order to fully translate the home page, you will need to translate all the different elements.
Translating pages, posts, CPTs, and custom taxonomies
Translating pages and posts can be done by navigating to “Pages” or “Posts” on the WordPress dashboard and clicking on the icon to add the translated content or on the icon to edit the translation on the secondary language page.
Monstroid Theme comes with many CPTs, as listed below:
- Slides List
Monstroid Theme comes with a simple WPML configuration file, wpml-config.xml, that makes the CPTs added by the theme to the Cherry Framework translatable. If you are using another Template Monster theme, and for some reason it doesn’t come with a file with this name in the theme’s root directory, you can either add it yourself if needed or navigate to WPML >> Translation Management >> Multilingual Content Setup. Click on the “Custom posts” link to make the desired CPTs and taxonomies translatable, as shown in the illustration below:
To translate any of the CPTs, follow the below steps. For this example, we will translate “Services”:
- Navigate to “Services” from your WordPress dashboard.
- Click on the icon to edit the translation.
- Click on the “Translate independently” button found in the language meta-box on the right.
- Add the translated text and then click on the publish button.
To translate any of the custom post categories, follow the steps below. For this example, we will translate “Price blocks”:
- Navigate to WPML >> Taxonomy Translation.
- From the “Select the taxonomy to translate” drop down menu, choose “Services Category.”
- Click on “Price blocks” under the secondary language column, fill the required fields with the translated text, and then click “OK”. See the illustration below:
Translating theme text and other strings
Theme strings can be scanned and registered for translation on the string translation screen. Read more about Theme and Plugin Localization.
This can be done by following the steps below:
- Go to WPML >> Theme and plugins localization.
- Click on the “Scan the theme for strings” button; this will register the theme texts for translation on the string translation screen. Check the illustration below:
- Now you can navigate to WPML >> String Translation. You can either filter the strings by “translation needed” to see which strings are missing translations or select a specific text domain. You can also search for a specific string by typing it in the “search for:” field and then clicking the “search” button. Click on “translations” and add your translated text, choose the “Translation is complete” option, and click “Save.” Check the illustration below:
Note: to translate the admin theme texts, choose the “admin_texts_monstroid” text domain.
Translating MotoPress Slider
The demo content home page contains a slider named “Home Business Slider.” To translate this slider, we will need to duplicate it, translate its content, and paste its short code in the secondary language home page. Follow the instructions below:
- Navigate to “MotoPress Sliders.”
- Click on the “Duplicate” button next to “Home Business Slider.”
- Click on the “Edit” button next to the duplicated slide named “Duplicate of Home Business Slider.” See the illustration below:
- Click on “Edit” next to any of the slides to open the slides editor.
- Scroll down and choose the slide layer, add the translated content, and click on the “Save Slide” button. Note that you will do this for all the slide’s layers. See the illustration below:
- Copy the slider shortcode and paste it, replacing the original one in the secondary language home page, and then click on the “Publish/Update” button as illustrated below:
With WPML, you can easily synchronize your languages’ menus. For more information, please check our full translating menus tutorial.
Translating the Contact page
The themes based on Cherry Framework use the Contact Form 7 plugin. You have to translate the Contact page just as any other page, and you have to translate the contact form itself, following the procedure in Using Contact Form 7 with WPML.
Read our complete tutorial about widget translation.
If you need help with using WPML with Monstroid, please head over to our technical forum.
Before posting about issues, we recommend that you review this quick checklist:
- Make sure that you have the latest versions of the theme and WPML plugins and that they are all activated. These include WPML Multilingual CMS, WPML String Translation and WPML Translation Management.
- The problem does not appear if the WPML plugins are deactivated, and it does appear when only the core WPML plugins are activated. In other words, try to make sure that it is an issue of compatibility of Bridge with WPML, since otherwise Monstroid support is likely to be able to help you better.
Monstroid Theme comes with a built in MotoPress page builder and slider. Coupled with Cherry framework, it will provide you with tons of customization options. The detailed instructions introduced in this document will allow you to translate all Monstroid Theme elements smartly using WPML.