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 #

How to switch the default language in the WordPress dashboard

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

How to switch the language in the site's front end

The Ultimate Member plugin 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. We recommend using the WPML plugin. Read the article Language Setup to get to know about the WPML language switcher.

Note: Strings coming from field's Title and Label are not currently translatable with the WPML plugin. We'll add this as a feature request. We are also working on improving the translation with different translation plugins, please see: https://github.com/ultimatemember/ultimatemember/pull/1137

How to translate pages and forms #

You have to create pages for each language if you translate the site with the WPML 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 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 wp-admin > Ultimate Member > Settings > Extensions > Notifications.

You can edit templates for the E-mail Notifications on wp-admin > Ultimate Member > Settings > Email. You are able to add multiple language translations with the WPML plugin.