Shortcodes

You can add shortcodes to the content area of any page or post in order to display specific content. For more on shortcodes and how to use them, please see WordPress Codex: Shortcodes.

Sensei provides the following shortcodes:

Courses

A list of courses.

[sensei_courses]

Option	Description	Values	Default
category	Show courses from a specific category	Any valid course category ID, slug, or term name	none (all categories)
exclude	Specific course(s) to exclude from display	Any valid course ID(s) (comma separated)	none
ids	Specific course(s) to display	Any valid course ID(s) (comma separated)	none (all courses)
number	Number of courses to display	Any valid number	10
order	Sort order	asc, desc	desc (asc when orderby is menu_order)
orderby	How to order the courses	Any orderby parameter found here	date
teacher	Show courses from specific teacher(s)	Any valid user ID(s) or user name(s) (comma separated)	none (all teachers)

Example

[sensei_courses category="music" exclude="23" number="10" order="asc" orderby="name" teacher="123"]

Featured Courses

A list of featured courses.

[sensei_featured_courses]

Options

Option	Description	Values	Default
number	Number of featured courses to display	Any valid number	10
order	Sort order	asc, desc	desc (asc when orderby is menu_order)
orderby	How to order the courses	Any orderby parameter found here	date
teacher	Display only courses by a specific teacher	User ID or user name	none (all teachers)

Example

[sensei_featured_courses number="5" order="asc" orderby="name" teacher="123"]

Courses by User

A list of courses the currently logged in user is taking.

[sensei_user_courses]  

Options

Option	Description	Values	Default
number	Number of courses to display per page	Any valid number	10
order	Sort order	asc, desc	asc
orderby	How to order the courses	Any orderby parameter found here	title
status	Whether to display active or completed courses	active, complete	no status (displays both active and completed)

Example

[sensei_user_courses number="5" order="desc" orderby="name" status="complete"]

Teachers

A list of users with the teacher role, displayed as links to their author archive page.

[sensei_teachers]

Options

Option	Description	Values	Default
exclude	Teachers to exclude	Any valid user IDs or user names (comma separated)	none (display all teachers)
include	Teachers to include	Any valid user IDs or user names (comma separated)	none (display all teachers)

Example

[sensei_teachers exclude="23"]

User Messages

A list of private Sensei messages for the current user.

[sensei_user_messages]

Options

There are no options for this shortcode.

Course Page

Display the content of a specific course page by course ID.

[sensei_course_page]

Option	Description	Values	Default
id (required)	The ID of the course to display	Any valid course ID	none

Example

[sensei_course_page id="123"]

Course Categories

A list of course categories.

[sensei_course_categories]

Options

Option	Description	Values	Default
exclude	Specific course categories to exclude	Any valid course category ID, slug, or term name (comma separated)	none (display all)
hide_empty	Display only categories containing at least one course	true, false	false
include	Specific course categories to display	Any valid course category ID, slug, or term name (comma separated)	none (display all)
number	Number of categories to display	Any valid number	100
order	Sort order	asc, desc	asc
orderby	How to order the categories	Any orderby parameter found here	name
parent	Display only categories with a specific parent	Any valid course category ID. To show only top-level categories, set parent="0".	none (display all)

Example

[sensei_course_categories exclude="music" hide_empty="true" order="desc" orderby="slug"]

Unpurchased Courses

A list of all courses linked to a WooCommerce product that the current user has not yet purchased.

[sensei_unpurchased_courses]

Options

Option	Description	Values	Default
number	Number of courses to display	Any valid number	10
order	Sort order	asc, desc	desc (asc when orderby is menu_order)
orderby	How to order the courses	Any orderby parameter value found here	title

Example

[sensei_unpurchased_courses number="5" order="asc" orderby="date"]

Legacy Shortcodes

The following shortcodes were deprecated in Sensei 1.9 and should no longer be used:

[newcourses] – Displays the latest courses.

[featuredcourses] – Displays the courses marked as featured.

[freecourses] – Displays courses that do not require payment to take.

[paidcourses] – Displays courses that require payment to take.

[usercourses] – Displays the user’s active/completed courses or a login/register form if they are not logged in.

Finding the ID

In order to find the course ID to use for the [sensei_courses] or [sensei_course_page] shortcode, go to Courses > All Courses and edit the course you want to use. The URL will show a number that is the ID for your course (in the screenshot below, the course ID is 7707).

You can use a similar technique to find the course category ID or teacher ID.