How to translate pages built with Cornerstone (XTheme)

XTheme includes the Cornerstone page builder. WPML allows you to conveniently translate pages built with Cornerstone. You will design once with Cornerstone and translate just the texts with WPML.

Cornerstone Page in original content	Cornerstone Page translated to Italian

Getting started and what to check

Make sure that the X Theme is activated, by going to the Appearance -> Themes page.

Make sure that the WPML Multilingual CMS, WPML String Translation, WPML Translation Management, and WPML Media Translation plugins are activated.

For a better translation experience with contents created using Cornerstone builder, activate WPML Translation Editor. To do this go to the WPML -> Settings page. There, check the Use the translation editor option under the How to translate posts and pages section and click Save.

Translating your pages

With WPML, you can also translate any types of contents in your site, including pages and posts. For an easy start, read our Getting Started Guide to site translation.

Translating your pages built with Cornerstone

Visit our documentation page for exact steps on how to translate contents build with Page Builders.

Watch a short overview of translating pages built with Cornerstone in the following video.

Translating Portfolio pages and categories

To translate Portfolios, you need to follow the same steps as for translating any other types of pages. Again, visit our documentation page for exact steps on translating pages designed using WPBakery Page Builder (former Visual Composer).

Using WPML to translate X Theme — The portfolio is ready to be translated – WPML Language box

Portfolio Categories can be translated while translating your pages, on the Translation Editor screen. There, you can translate the portfolio elements as well as your Portfolio Categories.

Using WPML to translate pages built with X Theme — WPML Translation Editor

Additionally, you can translate your Portfolio Categories on the WPML -> Taxonomy Translation page. Select the Portfolio Categories from the drop-down menu and a list of your categories will appear. Click the “+” icon to translate a category for the respective language and use the dialog box that appears to add your translation.

Keep in mind that the translations of categories are universal: if you make a change, they will be updated everywhere.

Translating texts from X theme theme, plugins and other places

Besides contents coming from posts and pages in your site, there are usually some texts coming from other places. Most common example are themes and plugins.

To learn how to translate these texts, read our documentation page about translating these texts manually or sending them to others for translation.

List of all the current translatable XTheme/Cornerstone Elements

The following textual elements found in Cornerstone are currently supported by WPML:

Accordion
Alert
Author
Block Grid
Blockquote
Callout
Card
Columnize
Counter
Creative CTA
Custom Headline
Feature Box
Feature Headline
Feature List
Icon
Icon list
Image
Pricing table
Promo
Prompt
Raw Content
Recent Post
Search
Skill bar
Slider
Social Sharing
Tabs
Text
Text type
Widget Area

Adding support for more elements

WPML allows you to manually enable the translation of additional XTheme/Cornerstone elements.

Enabling the translation of following elements might cause issues when sending a page to professional services or using Translation Editor locally to translate it. The issue is not technical, but stems from the fact that translators often do not, understandably, understand the code and can break it during translation.

To translate any textual element in any these shortcodes, you must add them to the Custom XML Configuration tab found on the WPML -> Settings page.

Let’s consider an example of a Classic Code Snippt element which includes texts that require translation. In this case, you would add the following code on the Custom XML Configuration page.

Example - Classic Code Element

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>x_code</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

The following is the list of all shortcodes you can add manually, along with their attributes:

Audio (x_audio_player, x_audio_embed) | Attributes: mp3, oga
Classic Clear (x_clear)
Classic Code Snippet (x_code)
Counter (x_code) | Attributes: num_start, num_end, num_speed, num_color
DropCap (x_dropcap)
Gap (x_gap)
Line (line)
Map (x_map)
Classic Google Map (x_google_map)
Classic Promo (x_promo) | Attribute: image
Classic Protect (x_protect)
Classic Recent Posts (x_recent_posts) | Attribute: category
Classic Pricing Table (cs_pricing_table_column) | Attribute: price
Video (x_video_player) | Attributes: m4v, ogv, posterc
Classic Raw Content (x_raw_content)
Classic Skill Bar (x_skill_bar) | Attribute: percent

You can find more information on the page about defining page builder shortcodes in the language configuration file.

Translating content coming from Cornerstone add-ons

XTheme ecosystem is wide and it features many useful add-ons extending its usability. Although we are constantly working on making these add-ons translatable with WPML, not all of them are yet integrated (we’re not even familiar with all these great add-ons).

In case of you use a XTheme add-on that’s not yet configured to work with WPML, you can fix it yourself. Follow the instructions on integrating page builders that use shortcodes with WPML. You will tell WPML which shortcodes include texts, making it all work together.

Translating X theme’s menus

WPML allows you to easily synchronize between your language’s menus. We recommend that you see our full documentation explaining how to translate a menu.

Maintaining the CornerStone Builder Compatibility with WPML

We have prepared a documentation that explains how the CornerStone Builder works with WPML. Additionally, it explains the process of updating the language configuration file in order to maintain the compatibility between WPML and CornerStone builder. Feel free to check it here.

Getting help from our support

We have supporters in our forum who are ready six days a week to help you. They are trained in how to use WPML with X Theme. If you are working with a developer for your site, please use our Translation support forum to get help with translating your site’s content.

If you are setting up the site and WPML yourself, please use our Technical support forum.

Need help with building and maintaining your site?

If you need help with building or maintaining your site, take a look at our list of WPML Contractors. They are experienced developers specialized in developing multilingual sites.

Get WPML

You can evaluate WPML for 30 days and see how you like it. If you are not happy with our plugin, we refund you without any questions in the 30 days.

Buy and Download

How to translate pages built with X Theme (Cornerstone Builder)

Contents