User Guide Multilanguage Plugin
*When using other versions some differences are possible to occur
** Screenshots were taken from a PC
Table of Contents
You can download Multilanguage Plugin here: https://bestwebsoft.com/products/wordpress/plugins/multilanguage/.
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.
Use the “Title” option to change the default language title.
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.
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.
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 the 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
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, click the “Add” button, find and click the “Multilanguage” plugin.
9.2. Set up the “Multilanguage” plugin widget. Enter the title in the “Title” section and choose the appearance type..
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 to 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, click the “+” button, find and click the “Multilanguage” widget.
12.2. Select the necessary language or “All Languages” from the “Display for” dropdown, select the sidebar for the widget and the position of the widget.
12.3. If the “All languages” is selected from the “Display for” dropdown, enter the title for other languages and click the “Update” 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 the “Gallery by BestWebsoft” plugin follow the link: https://bestwebsoft.com/products/wordpress/plugins/gallery/
13.2.1. To translate custom post types open the “Galleries” page on the dashboard.
13.2.2. To translate custom post types, search for the necessary custom post and click the “Edit” button.
13.2.3. The tabs with languages that were added and enabled, 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 the “Gallery by BestWebsoft” plugin follow the link: https://bestwebsoft.com/products/wordpress/plugins/gallery/
13.3.1. To translate custom taxonomies open the”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 the “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 were added and enabled, 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
Help & Support
Visit our Help Center if you have any questions — https://support.bestwebsoft.com/
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