Knowledge Base

Working with WPML

Overview

WPML is a multilingual plugin for WordPress that enables you to offer your website in many different languages. WPML is preferred multiligual plugin for all HeroThemes products and we provide the following notes to help setup and configure products with WPML.

Our products do not include any translations, these must be provided for all the languages you wish to offer.

These notes are provided for guidance only, please see WPML’s official support pages for issues related to WPML itself.

Getting Started

Install and configure WPML as per the WPML documentation.

Install and configure your HeroThemes product as per the documentation supplied or from the help center.

Translate any themes and plugins using the standard WordPress i18n techniques, alternatively use WPMLs string translation module to translate in the WordPress admin panel.

Make your articles translatable. From WPML > Settings > Post Type Translation, set Articles (ht_kb) to Translate. You will now get an option to provide translations for knowledge base articles in Knowledge Base > All Articles.

Make your article categories and tags translatable. From WPML > Settings > Taxonomies Translation, set Article Categories (ht_kb_category) and Article Tags (ht_kb_tag) to Translate. You will now get an option to provide translations for knowledge base categories and tags in Knowledge Base > Article Categories and Knowledge Base > Article Tags.

URL configuration

It is important to select a URL configuration that works for your setup. This is the area that causes the most issues for those setting up WPML for the first time. In WPML > Languages > Language URL format. The recommended setting is Different languages in directories.

Permalinks can be configured from the object you wish to translate, for example an article, category or tag, when editing the object.

It is not possible to translate the taxonomy slug for different languages due to a limitation of WPML/WordPress, you can find more details on the WPML support forum here.

String Translation

The string translation module is an optional plugin, available from WPML. It adds a String Translation menu option to the WPML settings from the WordPress admin.

The string translation module can be used to translate conventional strings, defined by the theme or plugin’s text domain. It can also be used to translate admintext, including the theme_mods (or optionsframework) and plugin settings. These are defined in the theme or plugin’s wpml-config.xml file. This must be copied to the child theme to enable theme mods to be translatable with the string translation module. You must also ensure the parent keyname is updated to match the name of your child theme, eg theme_mods_knowall to theme_mods_knowallchild.

It’s important to have the setting Translate the theme and plugins using WPML’s String Translation enabled from WPML > Theme and Plugin Localization.

It may also be necessary to scan the theme and/or plugin to initialize the strings for translation and when the product is updated. This can be done from the Theme and Plugins localization screen, selecting the themes and/or plugins and clicking Scan the selected theme/plugin for strings. This will ensure they are available for translation from the String Translation screen.

When you change a string using the customizer or an option within the theme or plugins settings, you may need to re-translate it within the WPML string translation module.

Troubleshooting issues with WPML

Most of the issues reported by customers relate to a configuration setting within WPML. It is important to review all WPML’s settings to ensure they are consistent and working well for your site.

It is important your server is capable of meeting the minimum requirements for WPML and HeroThemes products.

The following steps may help towards issues with configuration:-

If you have queries on configuration, please consult your web host.

Was this article helpful?

Related Articles