How to translate plugin

This document provides plugin translation instructions and recommendations for multilingual websites.

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 Poedit #

Download Poedit

How to translate:

  • Open the language translation you need from the existing PO file or open the ultimate-member.pot file from the /wp-content/plugins/ultimate-member/languages/ directory to create a new one
  • Click the Update from POT file... item
  • Edit texts
  • Save PO and MO files with the locale suffix, 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.

Create or open a translation #

Image - Poedit start screen.

Edit texts #

Image - Edit texts in Poedit.

Sync #

Update your translation from the translation pattern (original POT file) if you can not find needed texts. Click the Update from POT file... item.

Image - Update from POT file.

How to translate using 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 Sync button
  • Edit texts
  • Save changes

Do the same for extensions.

Create or open a translation #

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.

Edit texts #

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

Sync #

Update your language files from the translation pattern (original POT file) if you can not find needed texts. Click the Sync button.

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

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 #

Switch website language #

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

Language switcher for multilingual sites #

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 #

Pages #

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

With the Polylang extension you can duplicate Ultimate Member pages for all languages in one click. Go to wp-admin > Pages and click the Create Pages button in the notice. Or click the "+" icon under the flag to duplicate and configure a page manually.

Forms #

You have to create Ultimate Member forms for every language if you translate the site with the WPML or Polylang plugin. Duplicate default form for each new language, translate duplicated forms, put a proper form shortcode into translated pages.

With the Polylang extension you can duplicate Ultimate Member forms for all languages in one click. Go to wp-admin > Ultimate Member > Forms and click the Create Forms button in the notice. Or click the "+" icon under the flag to duplicate and configure a form manually.

Once forms for languages are created you can open these forms and translate fields. You have to translate a Label for custom fields. 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.