Posted on

Sensei 2.0 and Translations

When upgrading Sensei 1.x to Sensei with WooCommerce Paid Courses, all official translations should continue to work. Although we’ve made a lot of changes under the hood, Sensei with WooCommerce Paid Courses ships with the set of translation files that were used with Sensei previously.

However, if your site has custom translations (for example, using the Loco Translate plugin) then you may run into some issues when you upgrade.

Submitting Community Translations

Before discussing per-site custom translations, it’s worth emphasizing that the best solution for translations is to submit them to the official translation repositories. This way, any translations you submit can be used by other Sensei LMS sites as well.

Strings for most Sensei LMS functionality should be submitted to the WordPress.org translation repository. Strings related to selling courses are part of the WooCommerce Paid Courses extension and should be submitted to its repository.

Sensei with WooCommerce Paid Courses will, by default, pull its translation files from the above two locations using the default WordPress update page. It’s important to note that translation files will not be built and served from WordPress.org (for Sensei LMS translations) unless the translation file is at least 95% complete. You can export the .po and .mo files and add them to your site manually for translations that do not meet this minimum threshold.

Custom Translations

If you have custom translations saved to your site, it’s possible that they may have stopped working after the upgrade to Sensei with WooCommerce Paid Courses. This is likely because those custom translations were added under the legacy woothemes-sensei text domain.

To resolve this:

  • Find the custom translation files on your server. They should be named something like woothemes-sensei-de_DE.po and woothemes-sensei-de_DE.mo. (Note that the de_DE is the language code, and may be different in your case, depending on the language you are using.)
  • Make a copy of both files.
  • Change woothemes-sensei to sensei-lms in one copy, and sensei-wc-paid-courses in the other. For example, for German translations (de_DE), you should end up with the following files:
    • sensei-lms-de_DE.po
    • sensei-lms-de_DE.mo
    • sensei-wc-paid-courses-de_DE.po
    • sensei-wc-paid-courses-de_DE.mo

Your custom translations should now work for Sensei with WooCommerce Paid Courses.

Managing Translations with Loco Translate

Some specialized setup is required in order to manage translations with Loco Translate:

You should now be able to manage all of the translations for Sensei with WooCommerce Paid Courses within Loco Translate.

Posted on

Help us Translate Sensei

Sensei 1.9 is currently in the beta testing phase, and one of the new features included with it will be downloadable language packs. Sensei in your language at the click of a button!

We rely on the Sensei community to contribute translations. Sensei is currently being translated into 30 languages, but there are only 8 languages with over 80% of the strings translated.

Screen Shot 2015-11-23 at 18.42.13.png

We need more languages!

We are looking for bilingual/multilingual Sensei users who can help us translate Sensei into other languages.

How can I help?

If you know a language other than English, you can help. All you need to do is head over to our Sensei project on Transifex, and click HELP TRANSLATE “Sensei”.

You’ll be taken to a signup page where you can create a free account, and as soon as that’s done you can start translating into any of the listed languages.

If your language isn’t listed, you’ll need to request a new language, and once we’ve approved the new language you can start translating.

I already translated Sensei. How can I contribute my translation?

If you’ve translated Sensei into your language, using POedit, Codestyling Localization, Loco Translate, or any other translation plugin, you can easily upload your .po file to Transifex. Just join the translation team for your chosen language and click on “Upload file”.

How do I use Transifex?

Translating in Transifex is simple, you just select an English string on the left, enter your translation on the right and click “Save”.

If you need more help using Transifex, check out their support pages.

If you have any questions about contributing translations, leave a comment below.