How to Translate a WordPress Plugin

Last Updated on February 14, 2023 by 17 Comments

How to Translate a WordPress Plugin
Blog / Tips & Tricks / How to Translate a WordPress Plugin

One of WordPress’ best features is the thousands of plugins for you to choose from. Whatever functionality you want to bolt onto your site, there’s likely a plugin available to help you do it. However, the vast majority are in English only, which means options are limited for non-speakers of the language.

To help bridge the gap, you can contribute by helping translate plugins (if you’re multilingual), whether it’s for your own use or for others to benefit from. In this post, we’ll talk more about why you should contribute to plugin translation. Then, we’ll walk you through how to translate a plugin in just three steps.

Let’s get started!

Why (And How) to Contribute to WordPress.org Plugin Translations

If you browse the WordPress.org Plugin Directory, you’ll notice that a lot of plugins are available in multiple languages. In some cases, those translations are the work of the plugin’s own developers. However, more often than not, the users themselves do the bulk of the work.

Contributing to a plugin’s translation via WordPress.org is very simple. You can translate as many or as few strings as you want, and it should only take a couple of minutes of your time to make suggestions. Ideally, hundreds of users will come together to create a full translation other people can enjoy.

It’s a win-win situation for everyone. You get some practice in another language, other users get to enjoy a plugin you like, and the WordPress community grows. Plus, you get a nice, warm feeling after helping out!

To start contributing, firstly register for an account on WordPress.org. Then, visit the page of a plugin you like and look a line reading “This plugin is also available in X language. Help improve its translation” (here, you’ll see that line in Portuguese):

Helping improve a language's translation.

If you click on the “Help improve its translation” link, you’ll see a list of all the languages WordPress officially supports. Next to each language, there should be percentages representing the progress of each translation for the plugin:

The progress for each translation.

Clicking on one of those percentages will show you a list of strings, including those that already have accepted translations, and others awaiting for input:

Strings available for translation.

If you click on one of the strings without a translation available, you’ll be able to add one yourself using a basic editor. Your suggestion will then be reviewed by a member of WordPress’ Polyglot Team. Once approved, the plugin’s translation percentage will increase, making it one step closer to being fully translated.

How to Translate WordPress Plugins (In 3 Steps)

There are two ways to approach plugin translation for the plugins you use. One involves creating translation files, telling WordPress where to look for them, and using an editor. It’s a lot of work, and you can save yourself tons of effort by using a plugin such as Loco Translate instead, which can provide you with the same results. In this section, we’ll focus on the plugin approach.

Step #1: Install Loco Translate and Pick a Plugin to Translate

We chose Loco Translate for this tutorial since it’s by far the most feature-filled translation plugin for WordPress. It enables you to translate plugins and themes on your site to any language you want, and includes a built-in editor, so you don’t need to download any other tools:

The Loco Translate plugin.

To get started, install Loco Translate as you would any other plugin. Once it’s active, look for the new Loco Translate > Plugins tab on your WordPress dashboard. Inside, you’ll find a list of your plugins, including both active and inactive options:

A list of plugins available for translation.

The rest of this step is simple – click on the plugin you want to translate, and move on to step number two!

Step #2: Pick a Language and Create a po File for Your Plugin

After you choose a plugin, you should see a list of all its available translations on the next screen. You’ll notice each language has an associated file with the po suffix. Po files are where you store plugin translations in plain ‘strings’, which enables WordPress to pull the text it needs depending on the language you set for your website. Here’s an example of a po file:

An example of a po file.

If you chose a popular plugin, there should be a lot of translations available for it. In any case, you can add new languages using the New Language button at the top of the screen:

Adding a new language for your plugin.

Next, pick a language for your translation and choose where WordPress should store the new po file the plugin will create for you:

Choosing a new language and location for your po file.

We recommend using the Custom location, so your po files don’t get overwritten when you update the plugin in question. In any case, click on the Start Translating button when you’re done, and move on to step number three.

Step #3: Get to Work on Translating Your Plugin’s Strings

As we mentioned earlier, Loco Translate comes with its own built-in editor. After you choose a language for your new po file, Loco Translate will compile a list of strings for the plugin you want to translate, and send you to the editor. Here, simply click on a string and add a translation for it underneath:

Translating a plugin's string.

You can also use the Comments section to the right to save notes for yourself or anyone else working on your translations, to avoid confusion. The editor is simple to use, so you just need to remember to click the Save button at the top of the screen from time to time, so your work doesn’t get lost by mistake if you close the tab.

You can also peek at the File Info tab from time to time if you want to check your progress. The plugin keeps count of how many strings you’ve translated and how many you have to go at all times:

Your plugin translation progress.

Keep in mind – you’ll need to change your dashboard’s language to use any of your translated plugins. To do this, just go to the General > Settings tab and look for the Site Language setting:

Changing your website's language.

Pick the language you want from the drop-down menu and save your changes. If your plugins have translations available for your new language, WordPress will now use them by default.

Conclusion

Helping translate WordPress plugins is one of the best ways you can contribute to the platform’s growth. The higher number of plugins available in other languages, the more people will be able to build amazing websites. Some of them might help translate plugins to other languages too!

When it comes to translating plugins, you can either contribute directly through the WordPress Plugin Directory or work on your own website with these three steps:

  1. Install Loco Translate and pick a plugin to translate.
  2. Choose a language and create a po file for your plugin.
  3. Get to work on translating your plugin’s strings.

Do you have any questions about how to translate WordPress plugins? Let’s talk about them in the comments section below!

Article image thumbnail by Qvasimodo art / shutterstock.com.

Divi

Want To Build Better WordPress Websites? Start Here! 👇

Take the first step towards a better website.

Get Started
Divi
Premade Layouts

Check Out These Related Posts

Splice Video Editor: An Overview and Review

Splice Video Editor: An Overview and Review

Updated on March 10, 2023 in Tips & Tricks

Video is a valuable form of content for social media. Unfortunately, creating quality videos is usually a long process that involves moving mobile footage to a desktop app for editing. However, mobile editing is on the rise. Apps such as Splice Video Editor make it possible to efficiently create...

View Full Post
How to Use Font Awesome On Your WordPress Website

How to Use Font Awesome On Your WordPress Website

Updated on September 16, 2022 in Tips & Tricks

When given the choice between using a vector icon or a static image, it’s a good idea to go with the vector. They’re small and fast to load, and they can scale to any size without a loss of resolution. Font Awesome is a superb library of vector icons that you can use on your websites,...

View Full Post

17 Comments

  1. Here is what I received from DIVI support when I asked about translations. I found it rather easy to follow.

    You can translate the various English strings that appear throughout the theme using Poedit.

    1. Once launched, click “Create a new translation” and then select the en_US.po file (found in the “/lang” directory of Divi’s files.)

    2. It will then ask you to select the locale you are translating to (This must match the locale you have configured in wp-config.php).

    3. Now you will be presented with 2 columns. On the left side will be the English strings and on the right side will be your translations. You do not have to translate all the strings. You can search for a specific string by pressing Ctrl+F.

    4. Once you have translated the strings you need, save your translations. When you save them, Poedit will generate two new files that you must upload to the /lang folder (a MO and a PO file).

    • Hi Weblink. Thanks for sharing.

  2. Great tutorial. Thank you! I will use on my website

    • Hi, Goldweb. You’re very welcome. 🙂

  3. How about using Loco Translate to translate the Divi Theme and plugins like Monarch? Can that be done?

    • Hello, Boris. Loco Translate does allow you to create and update language files directly in your theme or plugin, so it may be worth considering. However, we would recommend you peruse their support forum before attempting to use it for your intended purposes. You can find the forum via the following link:

      https://wordpress.org/support/plugin/loco-translate

  4. It would be better DIVI would care about the DIVI translations ….

    the poor quality of DIVI translations is a known problem for a long time already

    • Yes, I would love to join translation team for Divi, but no one knows how.

  5. Too bad de cant use LT to translate DIVI

  6. Nice information for me. Thanks for shar

    • Hi, Mukesh. You’re welcome. 🙂

  7. This has been a big help for me and perfect timing – thank you!

    • Hi, Valerie. You’re very welcome. 🙂

  8. I would love to contribute to Portuguese translation of Divi.

    There’s a place where can I?

  9. Thanks for the advice !
    I just installed Loco translate and your advice about the custom configuration to not loose the translation at each plugin or theme upgrade is helpful as I read that the problem to loose translation happened to other developers and I did not find until your article how to do configure it well.

    Your article came just in time for me!

  10. English non-speakers are the unlucky ones. However, Loco Translate helps! Many thanks.

    • No problem, Alex. Happy to help 🙂

Leave A Reply

Comments are reviewed and must adhere to our comments policy.

Get Started With Divi