How to translate plugin

Contents

Translating WordPress community #

The basic language of the Ultimate Member plugin is English. We can't provide translation to other languages.

The core Ultimate Member plugin is translated to several languages by the Translating WordPress community. You may view available translations and download translation files here: https://translate.wordpress.org/projects/wp-plugins/ultimate-member/. You can help translate the plugin to your language at any time. Just log in to the translation platform with your WordPress.org account and suggest translations.

How to install language files #

Go to wp-admin > Settings > General and use the Site Language setting to switch the site language, save changes. WordPress will download and install language files for the WordPress core, a theme and all free plugins. You may need to use the Poedit program or the Loco Translate plugin to create language files for the paid extensions. You can use these tools to edit existing language files.

Image - How to install or switch the site language.

How to translate using program "Poedit" #

Download Poedit

How to translate:

  • Open the ultimate-member.pot file from the /wp-content/plugins/ultimate-member/languages/ directory and create a translation to your language. Or open the PO file with your language translation if the needed translation has already been created.
  • Edit texts
  • Save PO and MO files with names, that matches your language locale, for example: ultimate-member-es_ES.mo and ultimate-member-es_ES.po
  • Copy PO and MO files to the directory /wp-content/languages/plugins/

Do the same for extensions.

Image - Poedit start screen.

Image - Edit texts in Poedit.

Try to update the current file from the original POT file if you can not find needed texts.

Image - Update from POT file.

How to translate using the plugin "Loco Translate" #

Download Loco Translate

How to translate:

  • Go to wp-admin > Loco Translate > Plugins > Ultimate Member
  • Open the language translation you need or click the "New language" button to create a new one
  • Click the button "Sync"
  • Edit texts
  • Save changes

Do the same for extensions.

Image - wp-admin > Loco Translate > Plugins > Ultimate Member

Image - wp-admin > Loco Translate > Plugins > Ultimate Member > New language

Warning: All files inside the plugin's directory are replaced on the plugin update. We recommend storing custom translations inside the /wp-content/languages/plugins/ directory.

Image - wp-admin > Loco Translate > Plugins > Ultimate Member > Edit

Relocate

All files inside the plugin's directory are replaced on the plugin update. That's why you should store custom translation inside the directory /wp-content/languages/plugins/. You can relocate existed translation.

Image - wp-admin > Loco Translate > Plugins > Ultimate Member - Private Messages > Edit > Relocate

Sync

You can sync existed translation with the original if you don't want to create a new translation.

Image - wp-admin > Loco Translate > Plugins > Ultimate Member > Edit

Settings

You should increase option " Extracting strings: Skip PHP files larger than" if you see a notice like "Warning: 2 files over 100 KB have been skipped. (Largest is 141.1 KB). Check all strings are present before saving." on sync.

Image - wp-admin > Loco Translate > Settings

How to switch language #

WordPress dashboard language

Switch default language using option "Site Language" on the page "General Settings"

Frontend language switcher

The Ultimate Member plugin doesn’t have the "language switcher" element. You have to use the multilingual plugin to make the site multilingual and add the "language switcher" to the front. A way to add language switcher depends on a multilingual plugin you use.

WPML

Ultimate Member plugin supports the WPML multilingual plugin by default. Follow instructions in the article "Language Setup" to add the WPML language switcher.

Polylang

Ultimate Member plugin does not support the Polylang multilingual plugin by default. You can install a free extension Ultimate Member - Polylang that integrates Ultimate Member with Polylang. Once extension is installed follow instructions in the article "The language switcher" to add the Polylang language switcher.

TranslatePress

Ultimate Member plugin does not support the TranslatePress multilingual plugin by default. You can install a free extension Ultimate Member - TranslatePress that integrates Ultimate Member with TranslatePress. You have three options to display language switchers on the site: shortcode [language-switcher], menu item, floating language selection. See details in the TranslatePress documentation.

How to translate pages and forms #

You have to create pages for each language if you translate the site with the WPML or Polylang plugin.

You can create several forms of each type (Login, Profile, Register). Duplicate default form for each new language, translate duplicated forms, and put a proper form shortcode into each translated page.

You have to translate Label for each field in the translated form. You also can translate Placeholder and Help Text if needed.

Strings coming from Title and Label are not translatable with the "WPML String Translation" plugin.

Choices in the Dropdown and Multi-Select fields are not translatable.

How to translate E-mail notifications #

You can edit templates for the E-mail notifications on wp-admin > Ultimate Member > Settings > Email.

You are able to add templates for multiple languages if you translate the site with the WPML or Polylang plugin.