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
.mo files and add them to your site manually for translations that do not meet this minimum threshold.
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.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.
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:
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.
The Sensei LMS and Sensei with WooCommerce Paid Courses 2.1 betas are ready for testing.
Sensei LMS 2.1
Here are the highlights of the Sensei LMS 2.1 release:
- We added an Edit Course button to the lesson page to enable easier navigation to the course page (currently only available in the classic editor).
- We made the queries on the Analysis page more performant. This should help speed things up for sites with a significant number of learners.
- We fixed an issue with teachers not being able to save course settings in the block editor.
- We fixed a long-standing issue with the module status overlapping the module name on single course page for long module names.
- We’ve enabled the ability to add more HTML elements to Sensei notices.
- We added some event logging to the WordPress dashboard. More details can be found here.
See what else is in this release.
Template File Change
single-course/modules.php – Moved the location of module status to inside the
sensei_complete_lesson_redirect_url – Disable the redirect that occurs after completing a lesson
Sensei with WooCommerce Paid Courses 2.1
In addition to the changes from Sensei LMS, there are a couple of additional items in the Sensei with WooCommerce Paid Courses 2.1 release:
- We fixed an issue with the course purchase confirmation not being displayed on the correct page. The confirmation notice will now show on the Order Received page after a course is purchased.
- We replaced a call to the deprecated WooCommerce Memberships
You can download the Sensei LMS 2.1 beta here. Beta testers will receive the Sensei with WooCommerce Paid Courses 2.1 beta directly to their inbox. Our tentative release date for both Sensei LMS and Sensei with WooCommerce Paid Courses 2.1 is June 17th.
If you find a bug in the beta, please submit an issue on Github or leave a comment here.
As this is a beta release, please test it on a staging site and not your live site. If you don’t have a staging site, you can use the WP Staging plugin to create one.
Thank you to all our testers and contributors!
We’re very pleased to announce that Sensei LMS is now available on WordPress.org! 🙌
This is the free version of Sensei LMS (previously known as Sensei) that enables the creation of free online courses. Selling online courses is possible using the WooCommerce Paid Courses extension, which integrates with WooCommerce, WooCommerce Subscriptions and WooCommerce Memberships.
We hope that by making Sensei LMS available on WordPress.org, we are doing our part to democratize online learning!
The next beta, Sensei LMS 2.0.1 Beta 1, is ready for testing. It contains changes that rename the plugin from Sensei to Sensei LMS.
We recognize that the naming of this beta may be confusing. Given that Sensei 2.0 was made available prematurely on WordPress.org for a short period of time, we’ve had to rename the plugin from Sensei to Sensei LMS in order to prevent the same situation from happening again.
We’ve also bumped the version to 2.0.1, since technically Sensei 2.0.0 was briefly (albeit erroneously) released.
Template File Changes
- All templates – Changed text domain from
templates/emails/footer.php – Updated footer text.
manage_sensei_page_sensei_learners_sortable_columns has been deprecated in favour of
manage_sensei_page_sensei_grading_sortable_columns has been deprecated in favour of
manage_sensei_page_sensei_analysis_sortable_columns has been deprecated in favour of
Other Things to be Aware of
There are some additional things you should be aware of, particularly for developers:
- The main plugin file has been renamed from
- Sensei LMS is now installed in the
- The text domain has been changed to
sensei-lms throughout the codebase.
- The screen IDs for all subpages under the Sensei LMS menu have changed. If you are referencing screen IDs in any custom Sensei code, they will need to be updated.
You can download the beta here. Should you find any issues, please report them here in the comments or on Github. Thank you!
As this is a beta release, please test on a staging site and not your live site. If you don’t have a staging site, you can use the WP Staging plugin to create one.