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
andwoothemes-sensei-de_DE.mo
. (Note that thede_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
tosensei-lms
in one copy, andsensei-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:
- First, open the plugin within Loco Translate and go to the Advanced tab.
- Use the Add Set button at the bottom to add two more sets to the configuration. In the end, you should have the following three sets:
- Sensei with WooCommerce Paid Courses
- Sensei LMS
- WooCommerce Paid Courses
You should now be able to manage all of the translations for Sensei with WooCommerce Paid Courses within Loco Translate.