Setup WPML for Knowledge Base

You are here:

Intro

Note:

Ensure that you have the latest version of the WPML software installed.

Note: If you have questions about WPML options or encounter errors with WPML plugin please contact their support team. If you have questions or need help with WPML related to KB and its articles and categories, please contact KB support.

For more details on individual functions for WPML and configurations beyond the Knowledge Base. See WPML help:

s

Note:

Warning: WPML offers many ways to setup a multilingual site. Some configuration options might not work with Echo KB and will not be supported. However, the following configuration has been tested successfully.
q

Note:

Note that Access Manager does not support WPML.

1. Installation

  1. KB plugin is installed and active
  2. Install WPML  Multilingual CMS plugin
  3. Activate WPML  Multilingual CMS plugin
  4. Install WPML String Translation plugin.
    • In order to translate text on the user-facing website, such as search button text, you have to purchase and install WPML String Translation plugin.
  5. Activate WPML String Translation plugin.
  6. Go to WPML -> Languages Menu and follow the Setup WPML
Languages Menu and follow the Setup WPML

2. Post Types Translations

Go to WPML ► Settings ► Post Types Translations

  1. Make sure KB: Knowledge Base is set to translatable ( Radio button is checked )
  2. Click Save button.
q

Note:

Note that Access Manager does not support WPML.
Make sure KB: Knowledge Base is set to translatable ( Radio button is checked )

3. Taxonomies Translations Part 1

Go to WPML ► Settings ► Taxonomies Translations

Make sure these options are selected:

  1. Make sure KB Categories ( epkb_post_type_1_category)  are set to translatable
  2. Make sure KB Tags (epkb_post_type_1_tag)  are set to translatable
Make sure these options are selected: ( Radio button is checked )

4. Taxonomies Translations Part 2

  1. For KB Category, click on the blue link to open translation for category slug
  2. For each language, set its name for “category” word.
    • In this example we have changed the English word “category” to the French word “catégorie
  3. For KB Tag, click on the blue link to open translation for category slug
  4. For each language, set its name for “tag” word
    • In this example we have changed the English word “tag“to the French word “étiquette
  5. Click the Save button.
Set Your Language Category link.

5. Enable WPML in Knowledge Base

Go to Knowledge Base ► Configuration ► Overview ►  Configuration

  1. Select checkbox to enable WPML
  2. Click Save
Enable WPML check the box.

6. Edit the KB Main Page

Go to Knowledge Base ► Configuration ► Overview and in Configuration open the first KB Main page edit screen:

  1. Click on the Edit link

Note: As you add more languages, you should see here one KB Main Page per language.

Edit the KB Main page

7. Translate KB Main Page

When on the page with KB shortcode, go to the right sidebar and choose to either:

  1. Translate” each language
    • Enter your knowledge base title in given language
    • You have to manually enter the KB shortcode.
  2. Duplicate” each language
    • Adjust your knowledge base title in given language

Difference between Translate and Duplicate is explained here: Translate vs. Duplicate

Translate KB Main Page

8. Add and Translations for Categories

Go to Knowledge Base ► Category Screen

  1. If necessary select your main language (top admin bar or link above category list)

Click “add” (see screenshot pointer) to create your translation of this category for each language

Add translations for Categories

Note:

If you prefer to use WPML’s “Taxonomy translation” admin page you must save any KB Category after you add translations to let KB process the updates.

Tags translation works the same way.

9. Add Translations for Articles.

Go to Knowledge Base ► All Articles page

If necessary switch to your main language using top admin bar or links above articles table

  1. Click on the Plus sign for the language you want to translate the article to
  • Translate the article
  • Assign the language categories
Add translations for your articles.

Note:

If you do not assign any category to the article, the article will not appear on the KB Main Page.

On the All Articles page, if you do not see any KB Articles or are missing KB Articles, you can try to refresh WPML tables:

  1. Backup your database
  2. Go to WPML -> Support -> Troubleshooting Page -> Set language information.

10. Add Menu Language Switcher (Optional)

Go to WPML ► Languages ► Menu Language switcher

  1. Click on the button “+Add a new language switcher to a menu”
Click on the button “+Add a new language switcher to a menu
  1. Choose your menu
  2. Choose your Position
  3. Save
Adding Menu language switcher
On your Knowledge Base Main Page you should see the language switcher.
Front End Example

11. Translate strings from KB Configuration (administrative text)

Go to WPML ► String Translation screen

  1. Select the “admin_texts_epkb_config_1” from Select strings within domain
Select strings within domain
  1. Select the String you wish to add a language string.
  2. Click on the translations text.
  3. Enter in your language alternative text.
  4. Check the Translation is complete checkbox.
  5. Click the save button.
Select the String you wish to add a language string.
q

Note:

For more details on individual functions for WPML and configurations beyond the Knowledge Base. See WPML help:

12. Troubleshooting

Problem: Category Archive Page shows 404 or nothing found message.

Solution: The category has no articles assigned to it. Assign article to the category or handle case where category has no articles assigned.

Problem: On the All Articles page, if you do not see any KB Articles or are missing KB Articles, you can try to refresh WPML tables.

Solution:

  1. Backup your database
  2. Go to WPML -> Support -> Troubleshooting Page -> Set language information.

Problem: Translations are not working.

Solution: Ensure that you have installed the latest version of WPML plugins.

Last Updated On April 02, 2019