1. Home
  2. Translate
  3. Translators Handbook

Translators Handbook


Who translates? (Everyone!)
Find your Language Team
Setup
Say Hi/Bonjour/Selamat
Translate some strings
Request Validation
Become a PTE
Additional Resources

Welcome to our Translator’s Handbook. This is where we collect the resources we need to translate into all the different languages of the world. My name is Ismi and I’m here to help.

If you want to Translate UsersWP right now, visit this link.

Who does translations? Everyone! All the plugin users together!

In 2017 WordPress translations changed completely. First there was a change in where translations are stored, and now the responsibility for who creates the translations has changed, too. Instead of plugin authors, it is now all of us, the plugin users and site managers and everyone together who are responsible for translating plugins into our own language.

It’s a big job, but luckily both WordPress.org and AyeCode are providing us with tools and support to help us get organized. Join us in making UsersWP available in your language. Read on to find out more about how to join us #polyglots to #makewordpress.

Find Your Language Translation Team on WordPress.org

Every language has a team. If you want to be a translator, you should go find out how to join the team for your language: https://make.wordpress.org/polyglots/teams/

Setup your accounts

Most translation team leaders are on WordPress slack. Here are the steps to quickly setup your WordPress and WordPress Slack accounts.

  1. Login/Register at http://wordpress.org
  2. Login/Register (same account) at https://translate.wordpress.org
  3. Visit https://make.wordpress.org/chat and use the same account to register for Slack
  4. Visit https://gravatar.com to set an image for your new
    @chat.wordpress.com address
  5. Visit https://make.wordpress.org/polyglots/teams/ and find your language, then click on “View Team”

Say Hi and ask to how to join your language team

Once you know where to find your language team, and you have all your accounts setup, it’s time to say hello to your language team.
Introduce yourself on #polyglots
Start with saying “Hi” in the #polyglots channel on WordPress Slack.

  1. Open WordPress Slack
  2. Click the + next to channel
  3. Search for #polyglots
  4. Join the channel
  5. Say “Hello” (or something like it). Introduce yourself, and mention which language team you want to join. For example: “Hello, everyone @here ! I am new, and want to join the language team. @ismiaini @alexrollin”

Say hi to your language team leaders
Next, you can message some of the leaders of the team, to let them know. Visit your language team page, or look through the requests or the GD Translations to find other WordPress users who have validated in the past. Then make a direct message in Slack to say hello to them also:

  1. Open WordPress Slack
  2. Click the plus next to Direct Message
  3. Search for the people from your translation team and add them to the message.
  4. Also add @ismiaini and @alexrollin to share the joy
  5. Enter a message and say “Hi” again and introduce yourself, like you did in the #polyglots channel.

Ask your team at least these questions
There are, at least, two (2) questions that you want to ask your language team leaders before you submit a request for help with validation:

  1. “How do I join the team?”
  2. “Is there anything you can tell me before I make a request for validation?”

Note: Be nice to these folks, as they have worked hard at what they do and obviously care a great deal about translation into your own language. They are your new collaborators, and you are their new team member. Enjoy the opportunity to meet these new colleagues and to work together on this great project called WordPress.

Translate some strings

Visit the plugin page for your language: https://translate.wordpress.org/projects/wp-plugins/userswp
The best way to get started is to click on one of the incomplete projects and then click on “untranslated”. This gives you a list of strings that need translation. Double click and add a translation. Easy!

Request Validation

Once you have translated some strings, you can ask your language team for help with validation. You can make your request here: https://make.wordpress.org/polyglots/?resolved=unresolved

Here is a template you can use to make your request. All the users tagged in the request will receive a notification.


Hello #polyglots! I translated some strings with our project language team and we need your help with validation.

o fr_FR @MyUsername @ismiaini @alexrollin

Pleased to answer comments and questions below in the comments.

CAUTION: Your language team will be happier if you contact them by WordPress Slack to say hi, first, BEFORE you request help. Your team may also have additional suggestions or rules about joining their team. Be sure to ask “How do I join the team?” before you ask “Is there anything you can tell me before I make a request for validation?”.

What’s a PTE?

Once you translate some strings, the strings must be validated by someone who is a member of your language team. Remember the person you said “hi” to above? Someone like them. Once you join your language team, and then complete a translation, you can ask a leader of your language team to set you up as a PTE for the plugin for your language. A “PTE”, which is an acronym for “Project Translation Editor”. PTEs can validate strings. PTEs are assigned by the WordPress language team to to projects in their language. For example, a person who translates GD into Russian would go and talk to the Russian team members and ask them to validate the new translations. Then, when they finish, the translation team might make them a PTE for the Russian translation. Being a PTE means that your strings are automatically validated, and you can validate the contributions of others, too.

Translate UsersWP

Was this helpful to you? Yes 3 No