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 a language #

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

How to make website multilingual #

You can use special plugins to make your website multilingual. Ultimate Member is compatible with some popular multilingual plugins.

WPML - Ultimate Member supports the WPML multilingual plugin functionality for pages. Follow instructions in the article "Language Setup" to add the WPML language switcher.

Polylang - Ultimate Member does not support the Polylang multilingual plugin by default. 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 a language switcher or use the [um_pll_switcher] shortcode to add a language switcher.

GTranslate - This plugin can translate Ultimate Member pages without any integration. But GTranslate can not translate emails. Install a free extension Ultimate Member - GTranslate to add translation functionality for Ultimate Member email templates in settings.

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 every additional language, translate duplicated forms.

With the Polylang extension you can duplicate Ultimate Member forms for all additional languages in one click. Go to wp-admin > Ultimate Member > Forms and click the Create Forms button in the notice.

Once forms for languages are created you can open these forms and translate fields. You can translate a Title, Label, Placeholder and Help Text if needed.

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

Pages #

You have to create Ultimate Member pages for every language if you translate the site with the WPML or Polylang plugin. Duplicate default page for every additional language, translate duplicated pages. Put the translated form shortcode into the translated page. The form language should match the page language.

With the Polylang extension you can duplicate Ultimate Member pages for all additional languages in one click. Go to wp-admin > Pages and click the Create Pages button in the notice.

Emails #

You can view and edit templates for the E-mail notifications on wp-admin > Ultimate Member > Settings > Emails. You can add templates for multiple languages if you translate the site with the WPML, Polylang or GTranslate plugin.