We’ve been hard at work on the latest Sensei update, and it’s almost ready! This beta release contains 514 commits from 10 contributors.
We would really love your help with testing the new features, to make sure it all works seamlessly.
The main changes in this version are an improved template system, built-in language packs, and a new collection of shortcodes for adding Sensei content anywhere in your site.
We need help to test these changes, to make sure that the new features work as they should, and also that everything still works as it did before for existing users.
We’ve made some changes to the frontend Sensei templates, combining files where appropriate, and separating logic from markup, making the templates much more flexible.
We need to test all of the following templates thoroughly. All screens need to be tested both when logged in and logged out. When testing courses/lessons/quizzes, you should test when logged in and taking the course, and when logged in and not taking the course.
- New Course Archive Page
- This includes the following new filters:
- All – Displays all courses
- Free – Displays all free courses
- Paid – Displays all paid courses
- Featured – Displays all featured courses
- Sort by: Newest first / A-Z
- This includes the following new filters:
- New Course Archive Page
- Single Course Page (including courses with and without modules)
- Single Lesson Page
- Single Quiz Page (including quizzes with all question types)
- Messages Page
- Single Message Page
- My Courses Page
- My Profile Page
We have updated all templates except for the Email templates. If you have customised your templates in your theme they will still work. Please give us feedback if any of your templates break so we can look at improving the backwards compatibility.
The main frontend CSS file has moved from /assets/css/frontend.css to /assets/css/frontend/sensei.css
Previously we relied on shortcodes to display our course archives. In 1.9 we have introduced a new course archive template, as well as some new shortcodes that customers can use to display Sensei content wherever they wish.
The current shortcodes:
- [newcourses] – A list of all courses.
- [featuredcourses] – A list of featured courses.
- [paidcourses] – A list of paid courses (those linked to a WC product).
- [freecourses] – A list of free courses (not linked, or linked to a free WC product)
- [usercourses] – A list of courses the current user is taking or has completed. (Or a login/register form for logged out users).
These will continue to work for at least the next few versions, and we need to make sure they still work as they did before.
However, we will be encouraging people to switch to using the new course archive page, and the new shortcodes instead. The course archive page no longer requires shortcodes, and will be the page you select as “Course Archive Page” in Sensei > Settings.
All the following shortcodes and their parameters need testing thoroughly:
- [sensei_featured_courses number=”” =”” orderby=”” order=”” teacher=””] – A list of featured courses
- [sensei_user_courses number=”” orderby=”” order=”” status=”active|completed”] – A list of the courses the current user is taking. The default order here is by ‘title’ and order ‘ASC’. You can choose to show the completed or the active courses by the status parameter. If you omit this all courses (active and completed will be shown.
- [sensei_courses teacher=”” category=”” exclude=”” ids=”” number=”” orderby=”” order=””] – A list of specific courses by id. If no id’s are specified this shortcode will show all courses. By default this will show the most recent course by date. You can also specify the teacher and the category. Teacher can be the user ID or the teacher user name. Category can be the slug, id or term name.
- [sensei_teachers include=”” exclude=”” ] – A list of users with the teacher role, as link to their archive page. The include parameter is for adding extra users to the list of teachers. The exclude paramater will remove teachers already on the list.
- [sensei_user_messages] – A list of private Sensei messages for the current user.
- [sensei_course_page id=””] – Display a specific course page’s content by id.
- [sensei_course_categories orderby=”” order=”” parent=”” hide_empty=”” exclude=”” include=”” hierarchical=””] – Display the course categories in a list. The categories will link to the archive pages. To only show top level categories, set the parent parameter to zero.
- [sensei_unpurchased_courses] – A list of all courses linked to a WC product, which the current user has not yet purchased.
If a Sensei translation exists for your chosen language, it can now be installed and updated directly from WP admin.
To test this:
- Go to our Sensei project on Transifex, and choose a language from the list (preferably one that is mostly translated).
- Go to Settings > General in your WordPress dashboard and change your Site Language to your chosen language.
- When you click ‘Save Changes’ your site’s language will change, and you should see a notification at the top of your dashboard telling you there is a Sensei translation available for your language.
- Click ‘Install’ and the language pack will be installed. You should see a success message, and your Sensei admin pages should now display in your selected language.
- Also test switching to a language that isn’t in the list on Transifex and make sure you aren’t prompted to install a language pack.
There are currently only a small number of language packs available, mostly with incomplete translations. We will be posting again soon with more details on how you can help contribute Sensei translations.
There are several other changes in this release, which also need testing:
- When lessons are completed, you will now see a “Next Lesson” button in the completion message.
- Improved support for Twenty Fifteen theme
- Added support for Twenty Sixteen theme
- Improved support for Storefront theme
- If you view a quiz that has no questions, you will be redirected back to the lesson
- All chosen dropdowns have been replaced with Select2
- Questions can now have a zero grade
- Course management metabox on Edit Course screen which links directly to learner management and grading.
Important notes for developers
now officially replaces
, which will be deprecated in a future update.
- The php classes are now auto loaded when needed instead of loading all classes for every request. New filters for all sensei core post type for easier customization.
- You’ll notice that our class naming convention is no longer class-woothemes-sensei but rather class-sensei.
- Better class and function comments to assist developer IDE with discovery.
How to test
If you’re interested in helping us test this update, please complete this short form, and we’ll get back to you soon with further details:
This round of beta testing will be open until Monday 30th November, so the sooner you can test the better.