How to Translate MemberPress

Live translations

Since MemberPress 1.10.0, we introduced a live translation feature that takes translations available in MemberPress and updates translations on your site automatically. After you install or update MemberPress, you will see a notification icon next to the Dashboard → Updates section in your WordPress Dashboard and a new Translations section with the message that new translation(s) are available. 

When you click the Update Translations button, MemberPress will download translations automatically to the wp-content/languages/plugins/ folder.

Note: translation updates will show up only if the Site Language option in WordPress Dashboard → Settings → General section is set as one of the available languages: Spanish, German, Italian, French, French (Belgium), Portuguese (Brazil), and Japanese. Keep in mind that not all of them are fully translated, but we’re working on this.

If your site is in a language not available yet, you should follow the steps from the Manual translations section below and translate it.

If you have a custom translation of one of the supported languages in the wp-content/plugins/mepr-i18n folder and want to keep it, go to wp-content/languages/plugins/ folder and check if translation files in your languages exist in this folder already. If they do, you’ll need to delete them first. Then, install a free WPCode plugin (please check this article for details: How to add custom code snippets in WPCode).

Once installed, create a new Snippet and paste the following into it:

add_filter( 'mepr-remove-traduttore', '__return_true');

Another option is to add this code at the end of your current theme’s functions.php file.

Manual translations

Note: follow the steps below only if you want to translate MemberPress into a language not available in the list above or if you want to have your own version of the translation.

There are a few plugins that you can use to manage your translations, but sometimes these types of plugins come with their own headaches. So the way we prefer to translate plugins is by using the PoEdit tool.

In MemberPress, you may want to translate the plugin for two reasons. Click on the links below to be taken directly to their instructions:

  1. New Translation - follow these instructions if translating the plugin into a language not currently included.
  2. Update Existing Translation - follow these instructions if you want to update one of our translations or your own.

New Translation using PoEdit

Note: when using PoEdit, please note that if you have any translation marked as "fuzzy" (highlighted with yellow text), those translations will not show up as translated even with correctly uploaded translation files. If you want them to show correctly, you need to unmark any translations from "fuzzy" (like this).

1. Download the MemberPress plugin (current stable) from your account page and save it to your desktop.

2. From the .zip file, navigate to the memberpress//i18n folder, then cut and paste the memberpress.pot file onto your desktop.

3. Open PoEdit.

4. From the PoEdit menu, click "Create New Translation".

5. From the menu offered, browse to your desktop and select the .pot file saved in step 2.

6. The translatable strings show in the list on the main body of the program. Select a string to translate, and at the bottom of the program, use the "Translation:" text box to enter your new translation for that string.

Note: some strings have backslashes before quotes or characters like \" or \n or \', and some have wildcard characters like %s or %d. The backslashes and wildcards should be left in the translation strings as well.

7. When you're done translating the strings you want, click on File -> Save As. You'll need to save your file as "memberpress-{language_code}". So if your language code is "es_ES" (Spanish), your filename would be "memberpress-es_ES".

8. It saves two files; memberpress-es_ES.po and memberpress-es_ES.mo. If you find that it did not save the .mo file in addition to your .po file, please be sure to go to File -> Compile to MO within PoEdit to get that file saved.  Both files need to be uploaded to your hosting server and placed in the .../wp-content/plugins/mepr-i18n/ folder. This folder is not erased when updating MemberPress; this ensures that your existing translation files will not be lost when you upgrade or update MemberPress.

Upload your translation files to the  .../wp-content/plugins/mepr-i18n/

Adding them to .../wp-content/plugins/member press/i18n will cause them to be deleted during updates.

9. Be sure to keep a copy of your .po and .mo files on your computer just in case something fails, and your translations are lost on the webhost.  Note: if you would like to submit your translation files to us, we can include them in future releases of MemberPress. Your translation would also benefit others using MemberPress in your language.

10. Set your site language appropriately in the Dashboard -> Settings -> General tab (see screenshot below).

Update Existing Translation Using PoEdit

1. Open PoEdit and select the " Edit a Translation" option. 

2. From the PoEdit menu, select your existing .po translation file. So if it was a Spanish translation, you would open memberpress-es_ES.po.  

3. Click on Catalog -> Update from the POT file.  IMPORTANT: Please make sure you are updating from the latest .pot file that comes from the latest stable version of MemberPress. To ensure this is the case, please download the MemberPress plugin (the current stable version) from your account page and save it to your desktop. Then, from the .zip file, navigate to the memberpress//i18n folder, then cut and paste the memberpress.pot file onto your desktop.  

4. Browse to the new .../memberpress/i18n/memberpress.pot file. 

5. A window will pop up showing you a list of new translatable strings and ones that were removed. Click on OK. 

6. The translation strings list will update, and you can now edit the new translatable strings. 

7. When done translating, click on Save. 

8. Upload the modified .po and .mo files back to your hosting server.

Translate MemberPress Add-ons

Every MemberPress Add-on, for example, Courses, Corporate, PDF Invoices, and more have its own translation .pot files. If you want to translate these Add-ons, you will need to use translation files in the .../wp-content/plugins/{Add-on}/i18n/ folder and translate them following the same steps as above. 

If your language is Spanish, your translation file names should be, for example, memberpress-courses-es_ES, memberpress-corporate-es_ES, and memberpress-pdf-invoice-es_ES. Once you translate them, they need to be uploaded to your hosting server. 

For Add-ons like MemberPress Courses, MemberPress Corporate, MemberPress PDF Invoices, and MemberPress Gifting, translation files need to be placed in the .../wp-content/plugins/mepr-i18n/ folder. 

Translation files for other Add-ons need to be uploaded to the .../wp-content/plugins/{Add-on}/i18n/ folder.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.