Back to Documentation

Settings

General WordPress Settings

To enable site visitors to register for and log in to your courses, go to Settings > General in your WordPress Dashboard, and ensure the Membership checkbox is selected:

General WordPress settings

Sensei Settings

Sensei’s settings are grouped into a few different screens:

General

Access Permissions

Enabling Access Permissions means that users will be required to log in to your site in order to be able to view course, lesson and quiz content. In most cases, you’ll want to enable this setting; however, if you aren’t using quizzes and want your course content to be freely available to everyone without registering, leave it unchecked.

Disable Private Messages

Allows learners to send private messages to the teacher from any course that they are enrolled in. You can disable this communication by checking this option.

Course Archive Page

Sets the page used to display courses.

My Courses Page

Sets the page used to display the active and completed courses for a particular learner.

Use placeholder images

Displays a placeholder image for any course or lesson that does not already have a featured image.

Disable Sensei Styles

Prevents Sensei’s CSS from loading, which effectively removes any default styling. This is useful if your theme already includes styling for Sensei elements, or if you prefer to style them yourself.

Quiz question points format

Formats the display of the number of points a question has been assigned when a learner takes a quiz.

Disable Sensei Javascript

Prevents all front-end Sensei-specific JavaScript from loading.

Disable HTML security

Allows any HTML tags in the video embed fields. Enabling this setting can leave your site vulnerable to XSS attacks. We therefore recommend that you leave it unchecked.

Delete data on uninstall

Deletes Sensei data when the plugin is deleted. Be careful! Once removed, this data can only be restored from a backup.

Enable usage tracking

Helps us make future improvements to Sensei by collecting usage tracking data. No sensitive information is collected.

Courses

Sensei Courses settings

Courses are complete

Determines when a course is considered to be complete:

  • Once all the course lessons have been completed – Course won’t be completed until all of the lessons belonging to it have also been completed.
  • At any time – Learners are able to mark courses complete by clicking the Mark as Complete button on the My Courses page:

"Mark as Complete" button

Display Course Author

Displays the course author on the course archive and My Courses pages.

My Courses Pagination

Sets the number of courses to display per page on the My Courses page.

Course Archive Image

Displays each course’s featured image on the course archive page.

Image Width – Archive

Specifies the width (in pixels) of the image to display on the course archive page.

Image Height – Archive

Specifies the height (in pixels) of the image to display on the course archive page.

Image Hard Crop – Archive

Crops the image to the specified dimensions. If not selected, Image Height – Archive can be left blank and will be set proportionally to the specified width.

Single Course Image

Displays a course’s featured image on the single course page.

Image Width – Single

Specifies the width (in pixels) of the image to display on the single course page.

Image Height – Single

Specifies the height (in pixels) of the image to display on the single course page.

Image Hard Crop – Single

Crops the image to the specified dimensions. If not selected, Image Height – Single can be left blank and will be set proportionally to the specified width.

Featured Courses Panel

Displays the featured courses panels on the course archive page.

More link text

Specifies the text to display for the link when there are more courses on the course archive page.

Lessons

Sensei Lessons settings

Allow Comments for Lessons

Enables learners to comment on lessons for courses they are enrolled in. Only registered learners are able to view these comments.

Display Lesson Author

Displays the lesson author on the single course and lesson archive pages.

Course Lesson Images

Displays each lesson’s featured image on the single course page.

Image Width – Course Lessons

Specifies the width (in pixels) of the lesson image to display on the single course page.

Image Height – Course Lessons

Specifies the height (in pixels) of the lesson image to display on the single course page.

Image Hard Crop – Course Lessons

Crops the image to the specified dimensions. If not selected, Image Height – Course Lessons can be left blank and will be set proportionally to the specified width.

Single Lesson Images

Displays a lesson’s featured image on the single lesson page.

Image Width – Single

Specifies the width (in pixels) of the image to display on the single lesson page.

Image Height – Single

Specifies the height (in pixels) of the image to display on the single lesson page.

Image Hard Crop – Single

Crops the image to the specified dimensions. If not selected, Image Height – Single can be left blank and will be set proportionally to the specified width.

Email Notifications

Sensei Email Notifications settings

Emails Sent to Learners

Specifies which events will trigger an email notification to learners:

  • When their quiz is graded (either manually or automatically)
  • When they complete a course

Emails Sent to Teachers

Specifies which events will trigger an email notification to teachers:

    • When a learner starts a course
    • When a learner completes a course
    • When a learner completes a lesson
  • When a learner submits a quiz for grading
  • When a learner sends a private message to a teacher

Emails Sent to All Users

Specifies which events will trigger an email notification to all registered users:

  • When they receive a reply to their private message

“From” Name

Specifies the name from which all Sensei emails are sent (usually your name or the name of your site).

“From” Address

Specifies the email address from which all Sensei emails are sent.

Header Image

Specifies the URL of an image to display in the header of all Sensei emails (e.g. your logo).

Email Footer Text

Specifies the text that is displayed at the bottom of all Sensei emails.

Colours

Specifies the colours to use in all email templates. The colours that can be configured are:

  • Base Colour (background colour of the header)
  • Background Colour
  • Body Background Colour (background colour of the email content area)
  • Body Text Colour

Sensei email colours

Please see Email Notifications for more information.

Learner Profiles

Public learner profiles

Creates a public profile page for each learner at http://yoursite.com/learner/username.

Show learner’s courses

Displays the learner’s active and completed courses on their profile page.

WooCommerce

These settings are only available if WooCommerce is installed and activated:

Enable WooCommerce Courses

Enables the ability to associate a course with a WooCommerce product in order to sell courses. When selected, a WooCommerce Product dropdown becomes available in the sidebar of the Edit Course page:

Sensei WooCommerce Product metabox

Enable Sensei WooCommerce Integration Debugging

Logs Sensei and WooCommerce events to WooCommerce > Status > Logs for easy debugging.