https://github.com/umdevelopera/um-polylang
Integrates Ultimate Member with the Polylang plugin. Makes UM multilingual.
https://github.com/umdevelopera/um-polylang
multilingual polylang ultimate-member wordpress
Last synced: 18 days ago
JSON representation
Integrates Ultimate Member with the Polylang plugin. Makes UM multilingual.
- Host: GitHub
- URL: https://github.com/umdevelopera/um-polylang
- Owner: umdevelopera
- Created: 2023-06-13T16:14:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-09T21:06:47.000Z (11 months ago)
- Last Synced: 2025-02-17T07:35:15.616Z (11 months ago)
- Topics: multilingual, polylang, ultimate-member, wordpress
- Language: PHP
- Homepage:
- Size: 43 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ultimate Member - Polylang
Integrates 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](https://github.com/umdevelopera/um-account-tabs) extension. Makes custom account tabs translatable.
- Integration with the [Profile tabs](https://ultimatemember.com/extensions/profile-tabs/) extension. Makes custom profile tabs translatable.
## Installation
__Note:__ This plugin requires the [Ultimate Member](https://wordpress.org/plugins/ultimate-member/) and [Polylang](https://wordpress.org/plugins/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](https://drive.google.com/file/d/1K3Ac3KGAtJ_HrGtZ1MpeIMaqOm3HSZlq/view?usp=sharing) as any other plugin. Follow [this instruction](https://wordpress.org/support/article/managing-plugins/#upload-via-wordpress-admin).
## 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](https://polylang.pro/documentation/support/guides/strings-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](https://docs.ultimatemember.com/article/1335-email-templates).
### How to translate custom account tabs
This feature is available if you use the [Account tabs](https://github.com/umdevelopera/um-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](https://ultimatemember.com/extensions/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](https://polylang.pro/doc/the-language-switcher/#ls-in-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.
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](https://github.com/umdevelopera/um-polylang/issues) 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](https://wordpress.org/plugins/ultimate-member)
[Documentation for Ultimate Member](https://docs.ultimatemember.com)
[Official extensions for Ultimate Member](https://ultimatemember.com/extensions/)
[Free extensions for Ultimate Member](https://docs.google.com/document/d/1wp5oLOyuh5OUtI9ogcPy8NL428rZ8PVTu_0R-BuKKp8/edit?usp=sharing)
[Code snippets for Ultimate Member](https://docs.google.com/document/d/1_bikh4JYlSjjQa0bX1HDGznpLtI0ur_Ma3XQfld2CKk/edit?usp=sharing)