Print

Setup WPML for Knowledge Base

Introduction

It is very important to read the following instructions carefully. If you have issues, read the troubleshooting tips at the end of this article.



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 non-original 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 non-original 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 admin > knowledge base > configuration > settings > various and enable WPML option:

6. Edit the KB Main Page

Go to admin â–º Knowledge Base â–º KB URLs and click on Edit link beside your KB Main Page.

Note: You will only see the URL for the primary language.

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. 
  2. If you have KB add-ons, you will also have option to select “admin_texts_asea_config_1“, “admin_texts_elay_config_1” or “admin_texts_eprf_config_1

Note: if you have KB #2 or higher that you need to setup with WPML, select KB # e.g. “admin_texts_epkb_config_3

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:

q

Note:

Ensure you have the text string written in your original language in the Content. For example:

 

    q

    Note:

    For each language, user Ordering Wizard to sequence your language categories and articles.

      You might also need to select this option if you are having trouble with article links in one language going to another language:

      12. Troubleshooting – read before submitting a ticket

      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 -> click on button called “Set language information”.

      Problem: Translations are not working.

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

      Problem: Some strings, like those in the Search box, are in English rather than in my default language.

      Solution: Ensure that your strings are in the default language in frontened Editor -> Content tab (select the text on the screen right side and edit it in the left sidebar of the Editor).

      Problem: For users that did not log-in, the search in one language is not working.

      Solution: If the search works for logged in users then enable the following option in WPML languages:

      Was this article helpful?
      0 out Of 5 Stars
      5 Stars 0%
      4 Stars 0%
      3 Stars 0%
      2 Stars 0%
      1 Stars 0%
      How can we improve this article?
      Please submit the reason for your vote so that we can improve the article.
      Need help?
      Table of Contents