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.

Ultimate Member was 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 translating 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 translate using program "Poedit" for Windows #

Download Poedit

How to translate:

  • Open old .po file "ultimate-member-en.po" from the /wp-content/plugins/ultimate-member/languages/ directory in the Poedit program and create translation to the your language. Or you can open .po file with yours language translation if it have been created earlier
  • Edit texts
  • Save new .po and .mo files with names, that matches to your language locale, for example: “ultimate-member-es_ES.mo” and “ultimate-member-es_ES.po”
  • Copy new .po and .mo files to the directory /wp-content/languages/plugins/

Do the same for the UM extensions. For example: make translation files "um-activity-es_ES.po" and "um-activity-es_ES.mo" for extension "Ultimate Member - Social Activity"

How to translate using plugin "Loco Translate" #

Download Loco Translate

How to translate:

  • Go to the page [Loco Translate > Plugins > Ultimate Member]
  • Copy default English translation and create translation to the your language. Or you can open your language translation if it has been created earlier
  • Click the button "Sync"
  • Edit texts
  • Save changed translation

[Loco Translate > Plugins > Ultimate Member]

[Loco Translate > Plugins > Ultimate Member > New language]

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

[Loco Translate > Plugins > Ultimate Member > Edit]

Relocate

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

[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.

[Loco Translate > Plugins > Ultimate Member > Edit]

Settings

You should increase option " Extracting strings: Skip PHP files larger than" if you see 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.

[Loco Translate > Settings]

How to switch language #

How to switch language in the site's front end

The plugin "Ultimate Member" doesn’t have such an element as "language switcher". You have to use the multilingual plugin to make the site multilingual and add a "language switcher" at the front end. Ultimate Member is compatible with several most popular multilingual plugins.

We recommend using the plugin WPML. Read the article Language Setup to get know about the WPML language switcher.

You may use the plugin Polylang if you search for a free solution. In this case you should install a special version of the plugin "Ultimate Member", you can download it from the branch "feature/multilingual" of the official repository. Read the article Widgets to get know about the Polylang language switcher.

How to switch language in the site's back end

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

How to translate pages and forms #

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

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 the "Label" of each field in the translated form. You also may translate "Placeholder", "Help Text" and other field settings if needed.

How to translate Notifications #

You can edit patterns for the 'Real-time Notifications' on the admin page [wp-admin > Ultimate Member > Settings > Extensions > Notifications].

You can edit templates for the E-mail Notifications on the admin page [wp-admin > Ultimate Member > Settings > Email]. You can add multiple language translations with WPML.

If some string is not translatable #

This is common way to translate plugins. If it doesn’t work the problem may be in the translation plugin, like WPML or similar, if it is installed at your site. These plugins may override translations from .po and .mo files.