Ultimate Member - Polylang
Integrates Ultimate Member with the Polylang plugin. Makes UM multilingual.
by umdevelopera · github.com/umdevelopera/um-polylang · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/umdevelopera/um-polylang/archive/refs/heads/main.zipIntegrates the Ultimate Member plugin with the Polylang plugin. Makes Ultimate Member multilingual.
Key features
- Localize links for Ultimate Member pages.
- Ability to duplicate Ultimate Member pages for all languages in one click.
- Ability to duplicate Ultimate Member forms for all languages in one click.
- Ability to translate the field "Label", "Help Text" and "Edit Choices" using the String Translation feature.
- Ability to translate bio (description) in profile.
- Ability to translate email templates.
- Language switcher shortcode. Display the Polylang language switcher where you need it.
- Integration with the Account tabs extension. Makes custom account tabs translatable.
- Integration with the Profile tabs extension. Makes custom profile tabs translatable.
Installation
Note: This plugin requires the Ultimate Member and Polylang plugins to be installed first.
How to install from GitHub
Open git bash, navigate to the plugins folder and execute this command:
git clone --branch=main git@github.com:umdevelopera/um-polylang.git um-polylang
Once the plugin is cloned, enter your site admin dashboard and go to wp-admin > Plugins > Installed Plugins. Find the Ultimate Member - Polylang plugin and click the Activate link.
How to install from ZIP archive
You can install the plugin from this ZIP file as any other plugin. Follow this instruction.
How to use
Settings
Go to wp-admin > Settings > Permalinks to verify permalink structure. The Post name permalink structure is recommended.
Verivy settings on wp-admin > Languages > Settings. See recommended settings below:
How to translate pages
Go to wp-admin > Pages to translate Ultimate Member pages. Click the Create Pages button in the notice to duplicate Ultimate Member pages for all languages. Or click the "+" icon unter the flag to duplicate each page manually.
Once pages for languages are created you can open and translate them. Note that translated pages Login, Registration, User should contain translated forms. The form language should match the page language.
How to translate forms
Go to wp-admin > Ultimate Member > Forms to translate Ultimate Member forms. Click the Create Forms button in the notice to duplicate Ultimate Member forms for all languages.
Once forms for languages are created you can open these forms and translate fields. You can translate a Label, Placeholder and Help Text if needed.
How to translate field options
Options in the Checkbox, Radio, Dropdown and Multi-Select fields can not be translated in the form builder. Don't change choices in the field settings! You can use the String Translation feature to translate the field Label, Help Text and Edit Choices if needed.
Example: The field settings
Example: The "Translations" table on wp-admin > Languages > Translations
How to translate E-mails
Go to wp-admin > Ultimate Member > Settings > Email to translate email templates. Click the "+" icon unter the flag to translate a template for the language. The plugin saves translated email templates to locale subfolders in the theme, see Email Templates.
How to translate custom account tabs
This feature is available if you use the Account tabs extension.
Go to wp-admin > Ultimate Member > Account Tabs. Click the Create Tabs button in the notice to duplicate tabs for all languages. Once the tabs are duplicated for each language, you can edit the tabs for additional languages.
How to translate custom profile tabs
This feature is available if you use the Profile tabs extension.
Go to wp-admin > Ultimate Member > Profile Tabs. Click the Create Tabs button in the notice to duplicate tabs for all languages. Once the tabs are duplicated for each language, you can edit the tabs for additional languages.
How to display language switcher
Add language switcher to the header menu if your theme supports classic menus, see Add a language switcher in a menu.
Add the [um_pll_switcher] shortcode to the header template if your theme does not support classic menus.
Shortcode attributes:
- int
dropdownDisplays languages into a dropdown if set to 1. Defaults to 0. - int
show_flagsDisplays flags if set to 1. Defaults to 1. - int
show_namesShows language names if set to 1. Defaults to 1. - string
display_names_asWhether to display the language name or its slug. Accepts 'slug' and 'name'. Defaults to 'name'. - string
item_displayWhether to display languages as a list or inline. Accepts 'list-item' and 'inline'. Defaults to 'inline'. - string
item_spacingWhether to preserve or discard whitespace between list items. Accepts 'preserve' and 'discard'. Defaults to 'preserve'. - int
hide_currentHides the current language if set to 1. Defaults to 0. - int
hide_if_no_translationHides the link if there is no translation if set to 1. Defaults to 0.
Screenshots
Image - Language switcher shortcode in the header template.
Image - Language switcher in the page header.
Support
This is a free extension created for the community. The Ultimate Member team does not provide support for this extension. Open new issue if you are facing a problem or have a suggestion.
Give a star if you think this extension is useful. Thanks.
Useful links
Ultimate Member core plugin info and download
Documentation for Ultimate Member
Official extensions for Ultimate Member