Skip to content

Integrates Ultimate Member with the Polylang plugin. Makes UM multilingual.

Notifications You must be signed in to change notification settings

umdevelopera/um-polylang

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ultimate Member - Polylang

Integrates the Ultimate Member plugin with the Polylang plugin. Makes Ultimate Member multilingual.

Key features

  • Language switcher shortcode. Display the Polylang language switcher where you need it.
  • 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 email templates.
  • Ability to translate bio (description) field in profile.
  • 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.

Note: This plugin is designed to integrate with the "Polylang" plugin, do not use it with the "Polylang PRO" plugin.

How to install from GitHub

Open git bash, navigate to the plugins folder and execute this command:

git clone --branch=main [email protected]: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.

WP Settings, Permalink (default)

Verivy settings on wp-admin > Languages > Settings.

Image - Recommended settings. URL modifications Custom post types and Taxonomies

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 dropdown Displays languages into a dropdown if set to 1. Defaults to 0.
  • int show_flags Displays flags if set to 1. Defaults to 1.
  • int show_names Shows language names if set to 1. Defaults to 1.
  • string display_names_as Whether to display the language name or its slug. Accepts 'slug' and 'name'. Defaults to 'name'.
  • string item_display Whether to display languages as a list or inline. Accepts 'list-item' and 'inline'. Defaults to 'inline'.
  • string item_spacing Whether to preserve or discard whitespace between list items. Accepts 'preserve' and 'discard'. Defaults to 'preserve'.
  • int hide_current Hides the current language if set to 1. Defaults to 0.
  • int hide_if_no_translation Hides the link if there is no translation if set to 1. Defaults to 0.

Screenshots

Image - Language switcher shortcode in the header template. Language switcher shortcode in the header template

Image - Language switcher in the page header. Language switcher in the page header

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.

UM Forms cr

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.

Note: Choices in the Checkbox, Radio, Dropdown and Multi-Select fields are not translatable. Don't change choices in the field settings! You can use custom functions to translate choices. See examples here:

UM Forms, Edit Form, Edit Field - Dropdown (use Choices Callback to translate values)+

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.

WP Pages cr

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.

UM Settings, Email cr

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.

WP, Ultimate Member, Account Tabs (Create Tabs) cr

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.

WP, Ultimate Member, ProfileTabs (Create Tabs) cr

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

Free extensions for Ultimate Member

Code snippets for Ultimate Member