The Courses List block provides a dynamically updated list of one or more courses.

The list can be displayed as either a standard row list or as a grid. You can also choose to show or hide course data such the excerpt, date, or taxonomies.

How to Use

  1. Choose the Courses List block from the Add block menu (under the Widgets category).
  2. The Courses List block will default to a row list of course posts ordered newest to oldest, showing only the title link. How many courses display by default will depend on the “Block pages show at most” setting in your WordPress reading settings (default 10).
  3. If you’re happy with the defaults this is all you have to do. The list is dynamically generated based on the parameters you set in the Filtering and Order and number settings menus and will automatically update whenever a new post is published.

Additional Options

Layout and Display Options

You can change between the default list layout and a card-style grid layout by toggling between the List view and Grid view options in the block toolbar.

  • When set to Grid view you can change the maximum number of columns to display under the Order and number panel in the block settings (in the sidebar). Note that at narrower screen widths (such as on phones) the display will fall back to fewer columns to preserve readability.

In the block settings you’ll find panels for Post content settings, Post meta settings, and Featured image settings. These control the following options:

  • Course content settings: select whether to show the course content or not. If toggled on you’ll be able to also choose between an excerpt or the full text of the course, and also customize the length of the excerpt.
  • Post meta settings: choose whether to show the post date, post categories, post tags, and other post taxonomies. Each can be toggled independently of the others.

Filtering and Sorting Options

By default the Courses List block will display the x most recent published courses. You can choose to modify that by changing the sort order and by filtering the included posts by taxonomy (either learning program or course tag).

  • To change the order: expand the Order and number panel in the block settings and select from the options listed in the “Order by” menu. Options include chronological, reverse chronological (default), alphabetical by title, and reverse alphabetical.
  • To change the number of posts shown: expand the Order and number panel in the block settings and adjust the slider in the “Number of items” option.
  • To filter the included posts: expand the Filtering panel in the block settings and enter the terms you want to filter by in the provided fields. You can filter using as many learning program and/or course tag terms as you want.

Examples

You want the 5 most recent courses with the “Favorites” course tag: insert a Courses List block, open the Order and number panel and change “Number of items” to 5, then open the Filtering panel and enter “Favorites” in the “Course Tags” field.

As a list:

As a grid displaying the excerpt and date in two columns:

You want to list 10 courses with either the “Research” or “Teaching” learning program: insert a Courses List block and then open the Filtering panel and enter both “Research” and “Teaching” in the “Learning Programs” field.

You want to list 10 courses, alphabetically, that have the “Research” learning program and the “Favorites” course tag: insert a Courses List block, open the Order and number panel and change “Order by” to “A → Z,” then open the Filtering panel and enter “Research” in the learning programs field and “Favorites” in the course tags field.

Note about filtering multiple terms: Within each taxonomy (learning programs or course tags) posts returned will match either term entered. So if you select two course tags you’ll get courses matching either tag. Between taxonomies the courses returned will be only those that match both terms. So if you select a learning program and a course tag you’ll only get courses matching both terms.