{"id":576,"date":"2017-06-28T16:31:22","date_gmt":"2017-06-28T14:31:22","guid":{"rendered":"https:\/\/codesavory.com\/demo\/?post_type=knowledgebase&#038;p=576"},"modified":"2021-06-30T17:35:57","modified_gmt":"2021-06-30T15:35:57","slug":"multilingual-knowledge-base","status":"publish","type":"knowledgebase","link":"https:\/\/basepresskb.com\/docs\/knowledge-base\/features\/multilingual-knowledge-base\/","title":{"rendered":"Multilingual knowledge base"},"content":{"rendered":"<section class='bpress-notice has-title has-icon is-style-info'><div class=\"bpress-notice-icon\"><span class=\"bp-check-circle\"><\/span><\/div><div class=\"bpress-notice-title\">Info<\/div><div class=\"bpress-notice-content\">Multilingual knowledge base is a Premium feature.<\/p>\n<p><a href=\"https:\/\/basepresskb.com\/pricing\/\">Upgrade today<\/a> to take your documentation to the next level!<\/div><\/section>\n<p>&nbsp;<\/p>\n<p>BasePress is compatible with WPML making it the perfect solution for a multilingual knowledge base.<br \/>\nThis article explains how to use BasePress in conjunction with WPML to make your knowledge base multilingual. It does not cover all aspects of how to use WPML. Please consider visiting <a href=\"https:\/\/wpml.org\/\">WPML<\/a> website to consult their <a href=\"https:\/\/wpml.org\/documentation\/\">documentation<\/a> for further details.<\/p>\n<p>To build your multilingual knowledge base you need to install the following plugins:<\/p>\n<ul>\n<li>BasePress (version 1.5.0 or above)<\/li>\n<li>WPML Multilingual CMS<\/li>\n<li>WPML String Translation add-on<\/li>\n<li>WPML Translation Management add-on<\/li>\n<\/ul>\n<p>After you have installed and activated all plugins and add-ons you are ready to start translating your content.<\/p>\n<h2>Introduction to the multilingual knowledge base<\/h2>\n<p>When using WPML to translate your knowledge base we suggest to always create your content in the main language and then proceed with the translations. If for example you have English and French as active languages for your website and you have set English as the main language, you should always create content in English first and then translate it to French. This will simplify the process in particular for big size knowledge bases.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-873\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/hierarchy.png\" alt=\"Knowledge Base Hierarchy\" width=\"550\" height=\"450\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/hierarchy.png 550w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/hierarchy-300x245.png 300w\" sizes=\"auto, (max-width: 550px) 100vw, 550px\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>All content in the knowledge base is hierarchical &#8211; Knowledge Bases are top level categories, sections are descendant of Knowledge Bases (or other sections) and finally the articles are descendant of sections. It is very important to preserve this hierarchy during translation.<\/p>\n<p>Always start by translating your Knowledge Bases, then translate the top sections followed by their sub-sections and finally translate the articles. Following this simple order will guaranty that the content hierarchy is always preserved.<\/p>\n<h2>How to translate Knowledge Bases and Sections<\/h2>\n<p>To translate you Knowledge Bases and Sections go to <em>WPML &gt;Taxonomy Translation<\/em> and select <strong>\u2018Knowledge Base Categories\u2019<\/strong> from the menu.<\/p>\n<figure id=\"attachment_587\" aria-describedby=\"caption-attachment-587\" style=\"width: 750px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-587 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/taxonomy-translation.png\" alt=\"taxonomy-translation\" width=\"750\" height=\"527\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/taxonomy-translation.png 750w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/taxonomy-translation-300x211.png 300w\" sizes=\"auto, (max-width: 750px) 100vw, 750px\" \/><figcaption id=\"caption-attachment-587\" class=\"wp-caption-text\">Taxonomy-translation<\/figcaption><\/figure>\n<p>A list of all Knowledge Bases and sections will appear. In the column with the language flags click the plus icon to translate the item. Fill in the form that will open with the translated content and save. BasePress will keep all data like the KB image, section image and icon, KB and section order for all languages synchronized.<br \/>\nOnce the Knowledge Bases and sections are translated you can find the translation in under <em>Knowledge Base &gt;Manage KBs<\/em> and <em>Knowledge Base &gt;Sections<\/em> for their relative languages. You can make any further changes directly there without the need to go back to the WPML screen.<\/p>\n<h2>How to translate the articles<\/h2>\n<p>After you have translated the Knowledge Bases and Sections you can start translating your articles. Go to <em>Knowledge Base &gt;All Articles<\/em> and click on the plus icon for the language you want to make the translation for.<\/p>\n<figure id=\"attachment_868\" aria-describedby=\"caption-attachment-868\" style=\"width: 750px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-868 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/translate-post-1.png\" alt=\"Translate article\" width=\"750\" height=\"313\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/translate-post-1.png 750w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/translate-post-1-300x125.png 300w\" sizes=\"auto, (max-width: 750px) 100vw, 750px\" \/><figcaption id=\"caption-attachment-868\" class=\"wp-caption-text\">Translate article<\/figcaption><\/figure>\n<p>&nbsp;<\/p>\n<p>The standard WordPress editor will open. You can then proceed creating the translation. Remember to select the Knowledge Base and Section for the translation and save. BasePress will synchronize all extra data like the icon and the article order across all languages.<\/p>\n<h2>How to know if some of your content has lost the hierarchy<\/h2>\n<p>Knowledge Bases are top level categories for the knowledge base, they will never loose hierarchy so you should not worry about them. Just make sure they are the first to be translated.<\/p>\n<p>Sections and sub sections are child categories of Knowledge Bases. If you translate a section but its parent Knowledge Base has not been translated yet, that translated section will remain without parent. The same will happen if you translate a sub-section before its parent section. Any section or sub-section without parent will be be treated as a Knowledge Base by BasePress.<\/p>\n<p>When this happens you will notice that when you go to <em>Knowledge Base &gt;Manage KBs,<\/em> the section you have translated will appear in the Knowledge Base list.<\/p>\n<p>To fix a section that has lost hierarchy start by translating its parent Knowledge Base. Once translated go to <em>Settings &gt;BasePress &gt;General<\/em> and enable <strong>\u2018Restore Category Screen\u2019<\/strong>.<\/p>\n<p>&nbsp;<\/p>\n<figure id=\"attachment_596\" aria-describedby=\"caption-attachment-596\" style=\"width: 780px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-596 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/restore-category.png\" alt=\"Restore WordPress category screen\" width=\"780\" height=\"444\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/restore-category.png 780w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/restore-category-300x171.png 300w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/restore-category-768x437.png 768w\" sizes=\"auto, (max-width: 780px) 100vw, 780px\" \/><figcaption id=\"caption-attachment-596\" class=\"wp-caption-text\">Restore WordPress category screen<\/figcaption><\/figure>\n<p>You will now find a new menu item under knowledge base called <em>\u2018Knowledge Base Categories\u2019<\/em>. This is the standard WordPress screen to manage categories. Select the section that has lost the hierarchy from the category list and use the parent list to select the correct Knowledge Base for this section and save. You can now disable the Category screen from the options.<\/p>\n<figure id=\"attachment_869\" aria-describedby=\"caption-attachment-869\" style=\"width: 755px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-869 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/category-editor-1.png\" alt=\"Category editor\" width=\"755\" height=\"339\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/category-editor-1.png 755w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/category-editor-1-300x135.png 300w\" sizes=\"auto, (max-width: 755px) 100vw, 755px\" \/><figcaption id=\"caption-attachment-869\" class=\"wp-caption-text\">Category editor<\/figcaption><\/figure>\n<p>When you are translating an article you won&#8217;t be able to select the Knowledge Base or section if they aren&#8217;t translated yet. You can save the article as a draft and proceed to translating the Knowledge Base and section the article belongs to. Once finished you can go back to the article, select the Knowledge Base and section and publish the article.<\/p>\n<h2>How to translate the setting texts<\/h2>\n<p>Some of the text that appear in the front side of the knowledge base are present under <em>Settings &gt;BasePress<\/em>. To translate them go to <em>WPML &gt;String Translation<\/em> and select \u2018<em>admin_texts_basepress_settings<\/em>\u2019 from \u2018<em>Select strings within domain\u2019<\/em> menu. You will get a list of all BasePress settings. Click on \u2018<em>translations\u2019<\/em> on the right side of each item, add your translation and save.<\/p>\n<figure id=\"attachment_597\" aria-describedby=\"caption-attachment-597\" style=\"width: 755px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-597 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/settings-translation.png\" alt=\"BasePress settings translation\" width=\"755\" height=\"577\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/settings-translation.png 755w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/settings-translation-300x229.png 300w\" sizes=\"auto, (max-width: 755px) 100vw, 755px\" \/><figcaption id=\"caption-attachment-597\" class=\"wp-caption-text\">BasePress Settings &#8211; Translation<\/figcaption><\/figure>\n<h2>How to translate the widgets<\/h2>\n<p>To translate the widgets go to <em>WPML &gt;String Translation<\/em> and select <em>\u2018Widgets<\/em>\u2019 from \u2018<em>Select strings within domain\u2019<\/em> menu. You will get a list of all active widgets including the the ones for the knowledge base. Click on \u2018<em>translations<\/em>\u2019 on the right side of each item, add your translation and save.<\/p>\n<figure id=\"attachment_598\" aria-describedby=\"caption-attachment-598\" style=\"width: 755px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-598 size-full\" src=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/widgets-translation.png\" alt=\"widgets-translation\" width=\"755\" height=\"575\" srcset=\"https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/widgets-translation.png 755w, https:\/\/basepresskb.com\/docs\/wp-content\/uploads\/widgets-translation-300x228.png 300w\" sizes=\"auto, (max-width: 755px) 100vw, 755px\" \/><figcaption id=\"caption-attachment-598\" class=\"wp-caption-text\">Widgets-Translation<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>&nbsp; BasePress is compatible with WPML making it the perfect solution for a multilingual knowledge base. This article explains how to use BasePress in conjunction with WPML to make your knowledge base multilingual. It does not cover all aspects of how to use WPML. Please consider visiting WPML website to consult their documentation for further [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"https:\/\/basepresskb.com\/docs\/knowledge-base\/features\/multilingual-knowledge-base\/\">Read More&#8230;<span class=\"screen-reader-text\"> from Multilingual knowledge base<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","knowledgebase_cat":[21],"knowledgebase_tag":[],"class_list":["post-576","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-features"],"_links":{"self":[{"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase\/576","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/comments?post=576"}],"version-history":[{"count":5,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase\/576\/revisions"}],"predecessor-version":[{"id":1658,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase\/576\/revisions\/1658"}],"wp:attachment":[{"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/media?parent=576"}],"wp:term":[{"taxonomy":"knowledgebase_cat","embeddable":true,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase_cat?post=576"},{"taxonomy":"knowledgebase_tag","embeddable":true,"href":"https:\/\/basepresskb.com\/docs\/wp-json\/wp\/v2\/knowledgebase_tag?post=576"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}