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

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

Contents

• Getting started
• Translating your pages
• Translating Portfolio pages and categories
• Translating texts from X theme theme, plugins and other places.
• Adding translation support for Cornerstone elements
• Translating sliders
• Translating menus
• Maintaining the CornerStone Builder Compatibility with WPML
• Known issues
• Getting help from our support
• Get help with building and maintaining your site
• Get WPML

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.

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. Please note that from the WPML 4.0 version and newer, the option to activate the translation editor is on the WPML -> Settings page.

Translating Portfolio pages and categories

To translate Portfolio items or any custom post type items, you need to follow the same steps as for translating any other types of pages. Visit our documentation page for exact steps on translating the contents yourself.

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.

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 plus 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.

Adding translation support for Cornerstone elements

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

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

X Theme 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 you use an X Theme 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 sliders

X Theme comes bundled with Slider Revolution. Read our documentation on how to create multilingual sliders using Slider Revolution to translate any slider created using the Slider Revolution plugin.

Translating 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 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.

Known issues

Currently, there is an issue with translating the old, classic (legacy) Cornerstone elements using any of WPML’s translation editors. As a workaround, you should be able to translate the classic elements manually.

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.