Documentation and Tutorials for your BestWebSoft products

User Guide Multilanguage Plugin                                                                                

 

Multilanguage

User Guide

WordPress

5.7.2 *

Multilanguage

Gallery

Portfolio

1.3.7 *

4.6.5 *

2.51 *

*When using other versions some differences are possible to occur

** Screenshots were taken from a PC

Table of Contents

Table of Contents

1. Introduction

2. Add Language

3. Edit Language

3.1. Title

3.2. Default

3.3. URL slug

3.4. Flag Image

3.5. Order

3.5. Site Title

3.6. Tagline

4. Multilanguage Settings

4.1. Google Auto Translate

4.2. Default Language Switcher Type

4.3. Switch Language Automatically

4.4. Default Language Slug

4.5. Slug Position in the URL

4.6. Permalink Translation

4.7. WordPress Language

4.8. Open Graph Markup

4.9. Hreflang Attribute

4.10. Translation Saving Mode

4.11. Default Search by

5. Miscellaneous Settings

5.1. Update GeoIP Every

5.2. Track Usage

5.3. Restore Settings

6. Custom Code

7. License Key

7.1. Pro License

7.2. Check License Key

7.3. Manage License Settings

8. Post Categories and Tags

9. Multilanguage Switcher

10. Multilanguage in Menus

10.1. Add Multilanguage Switcher to Menus

10.2. Separate Menus for Different Languages

11. Add Multilanguage Switcher via shortcode

12. Different Widget for Different Languages

13. Content Translation

13.1. Posts and Pages Translation

13.2. Custom Post Types Translation

13.3. Custom Taxonomies Translation

13.4. Custom Fields Translation

14. Yoast SEO

15. How to add a language that is not on the list

You can download Multilanguage Plugin here: https://bestwebsoft.com/products/wordpress/plugins/multilanguage/.

1. Introduction

Note: Сlick the “Save Changes” button in order to apply any changes.

1.1. Open your WordPress Admin Dashboard and find the menu on the left.

 

2. Add Language

Add necessary languages for their further activation and configuration.

 

Note: It is recommended to start the work with the plugin by adding the necessary languages on the “Languages” page.

2.1. Open the “Multilanguage” > “Languages” page on the dashboard.

 

2.2. Click the ”Add New” button.

 

2.3. Choose the necessary language from the dropdown.

2.4. Click the “Add Language” button.

2.5. The chosen language will be added to the table and the notification “Language added” will appear in the upper left corner of the “Languages” page.

2.6. To enable the language click the “Enable” button under the necessary language name.

2.7. To apply an action to several languages, choose the languages, choose the “Bulk action and click the “Apply” button.  

3. Edit Language

Use the “Edit” option to make additional settings for the chosen language on the “Edit Language” page.

3.1. Title

Use the “Title” option to change the default language title.

3.2. Default

Enable the “Default” option to use the chosen language as the default one.

3.3. URL slug

Use the “URL slug” option to choose the type of URL slug that will be shown in the address field of the page.

3.4. Flag Image

Use the “Flag Image” option to choose the image of the edited language’s flag.

3.4.1. To use a custom flag image, choose “Custom” and upload the file from your computer by clicking the “Choose File” button.

3.5. Order

Use the “Order” option to set the position of language in the switcher by changing the number in the box.

 

3.5.1. The set order number will be displayed in the table of the “Languages” page.

3.5. Site Title

Use the “Site Title” option to change the title of the site for non-default languages.

3.5.1. The entered “Site Title” will be displayed in the table of the “Languages” page.

3.5.2. The entered “Site title” will be displayed on the page as follows.

3.6. Tagline

Use the “Tagline” option to change the tagline of the added language.

3.6.1. The entered “Tagline” will be displayed in the table of the “Languages” page.

3.6.2. The entered “Tagline” will be displayed on the page as follows.

4. Multilanguage Settings

Use the “Multilanguage Settings” page to make the global settings of the plugin.

4.1. Google Auto Translate

Enable the “Google Auto Translate” option to activate webpages auto translate. When google auto translate is enabled, a Google language switcher is displayed on the page allowing visitors to translate the page content automatically.

4.2. Default Language Switcher Type

Use the “Default Language Switcher Type” option to select the type of the language switcher, displayed in the menu.

Note: This option is relevant only for “Multilanguage Switcher” added via shortcode. If the “Google Auto Translate” option is enabled, only google switchers will be available.

4.1.1. The “Drop-down list (flag + title)” switcher will look on the page as follows.

4.1.2. The “Drop-down list (title)” switcher will look on the page as follows.

4.1.3. The “Drop-down list (flag)” switcher will look on the page as follows.

4.1.4. The “Google Auto Translate (drop-down only)” switcher will look on the page as follows.

4.1.5. The “Google Auto Translate (horizontal)” switcher will look on the page as follows.

4.1.6. The “Google Auto Translate (vertical)” switcher will look on the page as follows.

4.3. Switch Language Automatically

Enable the “Switch Language Automatically” option to identify user IP and switch website language automatically according to location.

4.4. Default Language Slug

Enable the “Default Language Slug” option to show default language slug in the URL of the page.

Note: If this option is enabled, the alternative URL slug on the “Languages” page will be ignored.

4.5. Slug Position in the URL

Use the “Slug Position in the URL” option to choose the language slug position in the URL.

4.5.1. Choose “Before” to place the language slug before the domain name.

4.5.2. Choose “After” to place the language slug after the domain name.

4.6. Permalink Translation

Enable the “Permalink Translation” option to translate pages, posts, and custom posts slugs in different languages.

4.7. WordPress Language

Note: This option requires installed WordPress language packs.

Enable the “WordPress Language” option to switch the language of the WordPress interface automatically when the language is changed in the front-end.

4.8. Open Graph Markup

Enable the “Open Graph Markup” option to add the ability to translate open graph meta tags.

Note: This option automatically adds metadata for each language in the <head> section. Facebook and other social networks use this data when your pages are shared.

4.9. Hreflang Attribute

Enable the “Hreflang Attribute” option to add hreflang attribute used by search engines and display the correct language or regional URL in search results.

Note: This option inserts automatically the respective link for each language within the <head> section.

 

4.10. Translation Saving Mode

Use the “Translation Saving Mode” option to set the saving mode for translations.

4.9.1. Choose “Auto (AJAX)” to save translations automatically.

 

4.10.2. Choose “Manual (Save Changes button)” if you have some problems with translations saving in Auto mode.

4.11. Default Search by

Use the “Default Search by” option to set the prior language/languages used by search engines while scanning your site.

4.11.1. Choose “Current Language” for search engines to scan the current site language.

4.11.2. Choose “All active languages” for search engines to scan all languages on the site.

5. Miscellaneous Settings

Use the “Miscellaneous Settings” tab to control the track usage, to restore the global settings of the plugin and to set the frequency for your GeoIP list updating.

5.1. Update GeoIP Every

Use the “Update GeoIP every” option to set the frequency of GeoIP database updating.

5.1.1. Click the “Update Now” button to update the GeoIP database immediately.

5.2. Track Usage

Enable the “Track Usage” option to allow tracking plugin usage anonymously.

5.3. Restore Settings

Click the “Restore Settings” button to reset all the settings made previously and revert them to the default ones.

6. Custom Code

Use the “Custom Code” tab to insert a CSS, PHP or JavaScript code. To activate a custom code, enable the “Activate custom … code” option and save changes.

7. License Key

Use the “License Key” tab to activate or check the Pro plugin license.

7.1. Pro License

After a successful plugin purchase, you will receive an email notification with a download link and a license key. Activate Pro license by pasting a license key into the “Multilanguage Pro License” field and clicking the “Save Changes” button.

7.2. Check License Key

To check the license key, click the Check license key button. If the entered key is correct, the notification The license key is valid. Your license will expire on XXXX-XX-XX will be displayed in the upper left corner of the page.

7.3. Manage License Settings

Use the Manage License Settings option to change your license settings. Click the Login to Client Area button to open your personal Client Area dashboard found on the https://bestwebsoft.com/ website. Browse and download purchased products, change the license domain and copy the license keys.

8. Post Categories and Tags

Use the “Categories” and “Tags” pages to make the translation of categories and tags.

8.1. Open the “Posts” > ”Categories” page.

8.2. Click the ”Edit” button under the chosen post category/tag.

 

8.3. Insert the necessary translation of a category/tag name and its description in the “Translations” section. Once the translations are inserted click the “Update” button.

 

9. Multilanguage Switcher

To make the multilanguage switcher available in the front-end, add the “Multilanguage” widget.

9.1. Open the ”Appearance” > ”Widgets” page, find the “Multilanguage” widget and click the “Add” button.

9.2. Enable the “Multilanguage” widget for “Sidebar”, “Footer #1” or “Footer #2”  and click the “Save Widget” button.

Note: Widget for “Sidebar” available only if the WordPress theme contains sidebar widgets.

9.3. If the “Drop-down list (flag + title)” switcher is set, the “Multilanguage” widget will look on the page as follows.

10. Multilanguage in Menus

Add multilanguage switcher in menus and customize the menus depending on the language.

10.1. Add Multilanguage Switcher to Menus

Use the “Menus” page to add the “Multilanguage” switcher to the preferred menu.  

10.1.1. Open the “Appearance” > “Menus page.

10.1.2. Choose the necessary menu to add the “Multilanguage” switcher and click the “Select” button.

10.1.3. Enable the “Multilanguage switcher” option and click the “Add to Menu” button. If this option is not displayed It seems like this block is disabled in “Screen Options” of the menu edit page. Open “Screen Options” on the page (in the upper right corner of the screen) and enable the “Multilanguage” checkbox.

10.1.4. Configure the “Multilanguage switcher” in the “Menu Structure” and the “Menu Settings” blocks and click the “Save Menu” button.

 

10.1.5. If the “Drop-down list (flag)” is set, the switcher will look as follows.

10.2. Separate Menus for Different Languages

Create separate menus for different languages.

10.2.1. Open the ”Appearance” > ”Menus” page. Select the menu or create a new one.

10.2.2. Enable one or several languages to be displayed for the selected menu in the ”Display location” option and click the “Save Menu” button.

10.2.3. Enable necessary “Menu items” for the selected menu and click the “Add to Menu” button. Click the “Save Menu” button.

10.2.4. The primary “Navigation menu” may look as follows.

10.2.5. Created or customized “Navigation menu” may look as follows.

10.2.6. Use the “Manage Locations” tab to choose which menus will be displayed for certain languages menu.

10.2.7. Choose the necessary “Assigned Menu” from a dropdown for “Theme Location” and click the “Save Changes” button.

11. Add Multilanguage Switcher via shortcode

Add shortcodes with language switcher to the posts and pages.

11.1 Open a post/page in the “Edit” mode, click the “Add block” button and select “Classic”.

11.2 Put the cursor to the appropriate place of the content and click the “Add BWS Shortcode” button.

11.3. Choose the switcher type in the “SHORTCODE SETTINGS” window and click the “Insert” button.

11.4. After the shortcode is added into the content click the “Update” button.

11.5. The multilanguage switcher will look on a page as follows.

12. Different Widget for Different Languages

Customize the appearance of the widgets depending on the used language.

12.1. Open the ”Appearance” > ”Widgets” menu, find the necessary widget, and click the “Add” button.

12.2. Select the necessary language or “All Languages” from “Display for” dropdown, select the sidebar for the widget and the position of the widget in the sidebar and click the “Save Widget” button.

12.3. If the “All languages” is selected from “Display for” dropdown, enter the title for other languages and click the “Save Widget” button.

12.4. “Text widget” for the “Deutsch language will look as follows.

13. Content Translation

Translate content to necessary languages manually.

Note: This plugin does NOT translate texts automatically if the “Google Auto Translate” option is disabled. Translate all the necessary post types into the required languages manually.

13.1. Posts and Pages Translation

Translate the posts and pages to necessary languages.

13.1.1. Open the necessary page/post in the “Edit” mode.

13.1.2. Click the “Languages” button to switch to the necessary language version of the page or post.

13.1.3. Enter the translated text in content blocks of the necessary language and click the “Update” button.

13.1.4. After the update, the page/post will get the checkmarks in the column of the used languages.

13.2. Custom Post Types Translation

Translate custom post types necessary languages using the external plugins.

Note: Install and activate the plugin that adds custom post types to use this option. “Gallery by BestWebsoft” is used as an example.

To download “Gallery by BestWebsoft” plugin follow the link: https://bestwebsoft.com/products/wordpress/plugins/gallery/

13.2.1. To translate custom post types open “Galleries” page on the dashboard.

13.2.2. To translate custom post types, search the necessary custom post and click the “Edit” button.

13.2.3. The tabs with languages that added and enabled before will appear at the top of the page.

13.2.4. Open the necessary language tab, and enter the translation for custom post type title, description and image info. Click the “Update” button and then switch to the next language tab.  

13.2.5. Gallery in the English language will look as follows.

13.2.6. Gallery translated to the German language will look as follows.

13.3. Custom Taxonomies Translation

Translate custom taxonomies to necessary languages using the external plugins.

Note: Install and activate the plugin that adds custom taxonomies to use this option. “Gallery by BestWebsoft” is used as an example.

To download “Gallery by BestWebsoft” plugin follow the link: https://bestwebsoft.com/products/wordpress/plugins/gallery/

13.3.1. To translate custom taxonomies open ”Galleries” > ”Gallery Categories” page.

13.3.2. Choose the necessary custom taxonomy and click the “Edit” button.

13.3.3. Use the “Translations” option to insert the necessary translation of the custom taxonomy.

13.4. Custom Fields Translation

Translate custom fields to necessary languages using the external plugins.

Note: Install and activate the plugin that adds custom fields to use this option. “Portfolio by BestWebsoft” is used as an example.

To download “Portfolio by BestWebsoft” plugin follow the link: https://bestwebsoft.com/products/wordpress/plugins/portfolio/

13.4.1. To translate custom fields open the ”Portfolio” > ”Projects” page.

13.4.2. Choose the necessary custom fields and click the “Edit” button.

13.4.3. The tabs with languages that added and enabled before will appear at the top of the page.

13.4.4. Open the necessary language tab and complete the translation for the custom fields. Then click the “Update button.

13.4.5. Default language custom fields will look as follows.

13.4.6. Custom fields translated to another language will look as follows.

14. Yoast SEO

Multilanguage by BestWebSoft Plugin is compatible with the Yoast SEO WordPress plugin.

You can customize the SEO title, slug, meta description, and other parameters for each language using the Yoast SEO.

14.1. To customize SEO parameters, open the post or page in the “Edit” mode, choose the language, and set the preferred parameters for each language separately.  

14.2. Click the “Update” button to save changes.

15. How to add a language that is not on the list

Follow the steps from this article on our Help Center: https://support.bestwebsoft.com/hc/en-us/articles/360018257597

Thank you!

Help & Support

Visit our Help Center if you have any questions — https://support.bestwebsoft.com/

Services

We provide additional services such as WordPress themes & plugins development,

graphic design, custom programming.

Contact us now to get a free quote — https://bestwebsoft.com/contacts/

Help & Support

Support.bestwebsoft.com                                                                                                 of