Submit a ticket My Tickets
Welcome
Login

Kenai User Guide

Kenai User Guide

TABLE OF CONTENTS


Overview

Kenai is a premium theme for Moodle LMS and Moodle Workplace. It adds a customizable home page that presents content in a structured layout, and a catalog for browsing courses and programs.

System requirements

Requirement

Details

Moodle LMS

4.5, 5.0, 5.1

Moodle Workplace

4.5, 5.0, 5.1

Optional: local_ratings

Adds star ratings to course cards

Optional: customfield_options

Gives the catalog filter fields a fixed list of choices. Available on request

Optional: customfield_picture

Needed for sponsor logos on cards


Getting started

Installation

Kenai is a premium theme and must be purchased. Contact your Moodle Account Manager to add it to your site.

Theme activation

  1. Go to Site administration > Appearance > Themes.

  2. Select Kenai as the default theme.

Where settings live

All Kenai settings are under Site administration > Appearance > Custom theme settings > Kenai. The pages are shown as tabs.


Page

What it controls

General settings

Catalog on/off, info field icons, custom navigation, footer, login page, activity and course options, ratings, custom SCSS

Front Page Settings

Home page content, per tenant on Workplace

Activity Icon Management

Replacement icons for activity types

Email customization

Branding for outgoing email

Custom catalogs

Which catalog to use and how the catalog behaves (shown when the catalog is enabled)

Text field to dropdown field migration tool

Converts text custom fields into dropdown fields


Some settings are set on each course or program through the Kenai Fields section of its settings form. See the individual Field reference.

Home page

The home page is built from optional sections, so it can work as a portal, a dashboard or a mix of both. Configure it at Custom theme settings > Kenai > Front Page Settings.

Sections

Sections appear on the page in this order. Each can be turned on or off, and most can be set to load collapsed.


Section

What it shows

Notes

Announcements

A scrolling carousel of short messages, each with an optional link

Choose how many announcements to show

Banner

A video, a single image, or an image slider, with text overlay and a link

See Banner settings below

Welcome

Your own HTML content, created in the rich text editor

Can stretch to full page width

Recent courses

Up to 4 course cards the learner opened most recently

Incomplete courses only

Mandatory training

Up to 4 incomplete mandatory courses or programs the learner is enrolled in

Flag items with the kenaimandatory field

Top in-progress training

Up to 4 in-progress courses or programs, soonest due date first

Excludes mandatory items

Recently completed

Up to 4 courses or programs, most recently completed first


Explore by industry

A grid of images, up to 4 per row, each with text and a link

Set how many cards to configure

Featured items

Cards for courses, programs or custom items; becomes a carousel after 4 cards

See Featured items below

Get certified

A block with a title, text, image and a button or link



The card sections (Recent, Mandatory, Top in-progress, Recently completed) can each have a heading and a "View all" link. Choose course or program cards for each section.

  • Video: plays automatically, muted. It replaces the image slider when turned on. Optional text overlay. Turn on Standardize video height to keep the height constant across screen sizes (overlay text may be cut off).

  • Images: choose the number of slides, then set an image, overlay text, link and alt text for each.

  • Slider height: 300, 350, 400, 450 or 500px. Width follows the browser, so more or less of the image shows as the window resizes. Use images at least 3000px wide.

  • Slider controls: sliders with several images have a play/pause button.

  • Course and program cards use a simpler layout with no progress bar.

  • Custom item cards show one custom field value under the image and a second as a banner at the bottom of the card.

  • If a featured course or program has no image, Kenai generates one.

Images and accessibility

Every image setting (slider, industry, get certified) has an Alt text field and a Decorative checkbox. Use alt text for meaningful images and tick Decorative for images that are only visual. Links can be set to open in a new tab.

Block regions

You can add Moodle blocks between home page sections.

  1. Turn on editing mode.

  2. Add a block in the right-hand drawer.

  3. Drag it to one of these locations:

  • After the banner

  • After "Available courses"

  • After the welcome section

  • After Recent courses

  • After Mandatory training

  • After Top in-progress training

  • After Recently completed

  • After Get certified

Workplace features

On Moodle Workplace, each tenant can have its own home page. Tenants that are not configured fall back to a shared default page or to the site home, depending on one setting.

Set up tenant home pages

  1. Make Home the start page. Go to Site administration > Appearance > Navigation and set Start page for users to Home.

  2. Clear the site home content. Go to Site administration > Front page > Site home settings. Keep only Full site name and Short name for site. Clear Site home summary, Site home and Site home items when logged in, so they don't conflict with Kenai.

  3. Configure each tenant. Go to Front Page Settings and pick a tenant from the Tenant list. Turn on Enable Kenai front page, then set up its sections (see Home page). If a tenant's page is turned off, its users go to the dashboard.

  4. Configure the default page. Pick Default Front Page in the Tenant list and set it up. This page is the fallback for tenants without their own settings.

  5. Choose the fallback. In General settings, set Front page fallback behavior to Default front page if unconfigured tenants should see the default page. The default value, Site home page, sends them to the standard site home instead.

To clear a tenant's settings and start over, use the Reset Frontpage link at the top of Front Page Settings.

Tenant start pages (experimental)

Tenant start pages let you build each tenant's home page with Workplace custom pages and standard blocks instead of the Front Page Settings form.

  • Turn on Enable tenant start pages in General settings, then choose a fallback for tenants without a page: site home, the default tenant's page, or the dashboard.

  • Custom pages can be set to Full content width so content runs edge to edge.

  • The Front page migration tool converts an existing Kenai tenant front page into a custom page. It needs the block_ap_learning and block_carousel plugins and tenant start pages turned on.

Tenant appearance and email

Kenai adds options to the Workplace tenant editing pages, so each tenant's appearance and outgoing email branding can be set separately.

Catalogs

Kenai offers two catalog options. The Kenai Catalog works on Moodle LMS and Workplace. The Enhanced Native Catalog works on Workplace only. The Enhanced Native Catalog requires an additional plugin available to Kenai license-holders upon request.



Kenai Catalog

Enhanced Native Catalog

Platform

LMS (courses only) and Workplace (courses and programs)

Workplace only

Programs

Yes, on Workplace

Not yet supported

Cost

Included with Kenai

Included with Kenai; ask your Account Manager to install it


Kenai Catalog

The Kenai Catalog replaces the course index page (/course/index.php) with cards or a list. Learners can filter, sort and search, self-enrol in courses or allocate themselves to programs, and see their own in-progress and completed learning.

Cards

Element

Shown when

Details

Image

Always

The course or program image, or a generated image if none is set. Shown at the ratio set on the Custom catalogs page

Title

Always

Course full name or program name

Filter value

kenaifilter1 has a value


Information fields

kenaiinfo1 or kenaiinfo2 has a value

Each can show a Font Awesome icon

Sponsor logo

Sponsor logos are on and kenaisponsor has an image

Needs customfield_picture

View more button

Learner not enrolled

Opens a window with the image, description and a Start button. Needs course self-enrolment or program self-allocation

Launch button

Learner enrolled

Opens the course or program

Progress

Learner enrolled

A progress bar with percentage, or a Completed label

Star rating

Ratings are on

See Ratings


Image tips

  • Keep files small. The catalog loads 12 cards first, then 24 more each time the learner scrolls down.

  • Match the image ratio setting so images aren't cropped: 3:2 (300×200px), 4:3 (400×300px) or 5:4 (500×400px).

  • Compress images rather than shrinking their dimensions.

Filters and controls

Control

What it does

Card type selector

Switch between courses and programs. Shown when more than one card type is enabled

Category filter

Lists the categories the learner can see. Choosing a category includes its sub-categories

Custom filters (3)

Values come from the kenaifilter1–3 fields. A filter is hidden if no course has a value

Competency filter

Shows courses linked to the selected competency

Search and sort

Search box, A–Z or Z–A sort, and a Clear filters button

Modify View

Learners choose which filters they see and can hide items they are already enrolled in

My Cards tab

Separates the learner's enrolled items from the rest of the catalog

Grid / List

Switch between the card grid and a compact list


Guests can browse the catalog if the guest role has moodle/category:viewcourselist in the category or system context. On Workplace, guests see only non-tenant categories and the active tenant's category. If you use guest auto-login, also turn on forcelogin to avoid an extra page reload.

Configuration

  1. Turn the catalog on. In General settings, set Enable catalog? to Yes (this is the default).

  2. Add a navigation link. In General settings > Custom navigation, add a line such as Catalog|/course/index.php. New 4.5 installs include this line already.

  3. Set catalog options on the Custom catalogs page (table below).

  4. Fill in Kenai fields on courses and programs. See the Field reference.


Setting

What it does

Fixed image ratio

Crops card images to 3:2, 4:3 or 5:4, or turns cropping off

Enabled catalog card types

Courses, programs, or both

Show self-enrol courses

Includes courses the learner can self-enrol in

Additional catalog enrollment methods

Includes courses that use the enrolment methods you select

Enable My Cards

Shows the My Cards tab

Enable Catalog Preferences

Shows the Modify View button

Enable category filter

Shows the category filter. Turning it off also stops breadcrumb links from filtering by category

Enable competency filter

Shows the competency filter

Catalog view options

Grid, list or both

Sponsor logos on cards

Shows the kenaisponsor image on cards

Open cards in new tab

Opens the course or program in a new browser tab


Enhanced Native Catalog

The Enhanced Native Catalog builds on the standard Workplace catalog. It adds A–Z sorting, collapsible filters and a grid/list toggle. It does not show programs yet.

Key features

  • My Progress view: an optional page, linked from navigation, that lists the learner's enrolled courses. Learners filter by mandatory, in progress or completed, with optional progress bars.

  • Custom field migration: converts Kenai text fields into standard Moodle dropdown fields, so their values can be used as catalog filters.

Setup

  1. Turn on both catalogs.

  • Kenai: General settings > Enable catalog? = Yes

  • Workplace: Site administration > Learning > Learning catalog settings > Enable learning catalog = Yes

  1. Select it. On the Custom catalogs page, set Selected catalog to the Enhanced Native Catalog.

  2. Optional: turn on My Progress. On the Custom catalogs page, turn on the My Progress view (off by default). Then add /course/index.php?mycourses=1 under General settings > Custom navigation. Once on, enrolled courses no longer appear in the main catalog.

  3. Optional: progress and filters. On the Custom catalogs page:

  • Show completion progress: progress bars on cards (needs course completion turned on)

  • In Progress filter: lets learners show incomplete enrolled courses

  • Completed filter: lets learners show completed courses

  1. Optional: mandatory filter. In Learning catalog settings, under Fields to display in the learning catalogue filter, make Mandatory visible.

  2. Optional: migrate text fields. Open Text field to dropdown field migration tool, pick a field and select Submit. A background task turns it into a dropdown with every existing value as an option. The original field is kept, with _backup added to its short name.

For more on the native catalog, see the Moodle docs on Catalogue.

Customization

Unless noted, these settings are on the Kenai General settings page.


Feature

What it does

Where

Activity icons

Upload a replacement icon for any activity type, including third-party plugins. Accepts the image types allowed for course images (.jpg, .gif, .png by default)

Activity Icon Management page

Activity navigation

Adds Previous and Next activity buttons at the bottom of each activity

Enable activity navigation

Course Information tab

Shows or hides the Information tab on every course

Show course information tab

Go to top button

A floating button that scrolls course pages back to the top. On by default

Enable go to top button

Footer Banner

Plain text pinned to the bottom of every page

Footer Banner

Custom footer

Replaces the Moodle footer with your own HTML. Overrides the Footer Banner

Enable custom footer, Custom footer

Login box position

Places the login box on the left, center or right

Login box position

Login background image

Background image for the login page. Moodle LMS only

Login background image

Custom navigation

Adds items to the navigation bar, one per line: NAME|URL|BEFORENODE|ROLES. Purge caches after changing icons

Custom navigation

Custom styling

Add your own styles

Raw initial SCSS, Raw SCSS

Email branding

Sender name, subject prefix or override, and HTML and plain-text templates. Use {$a} where the original Moodle content should go. On Workplace this is set per tenant

Email customization page


Filter labels

Catalog filter labels come from language strings, not from the custom field names.

  1. Go to Site administration > Language > Language customization.

  2. Open the theme_kenai strings.

  3. Edit the strings for each filter:


String

Default

Where it appears

filter_kenaifilter1

Sub-category filter

Filter name

filter:kenaifilter1

All sub-categories

First option in the dropdown

filter_kenaifilter2

Type filter

Filter name

filter:kenaifilter2

All types

First option in the dropdown

filter_kenaifilter3

Difficulty filter

Filter name

filter:kenaifilter3

All difficulties

First option in the dropdown


You can change any other Kenai text the same way by searching for theme_kenai strings.

Ratings

With the optional local_ratings plugin installed, learners can rate courses on a five-star scale once they complete them. Ratings appear on course cards in the catalog and on the home page. Programs are not rated.

To turn ratings off without removing the plugin, clear Enable ratings in General settings. The setting only appears when local_ratings is installed.

Field reference

Kenai adds these custom fields to courses and programs, in a Kenai Fields section at the bottom of each settings form. Don't change a field's Short name, or Kenai can't find it. You can rename a field's Name, but that only changes the label on the edit form.

  • Courses: open the course > Settings > Kenai Fields

  • Programs: Site administration > Learning > Programs > select the program > Edit details > Kenai Fields

  • Field definitions: Site administration > Courses > Course custom fields (and the program custom fields page on Workplace)


Short name

Type

Applies to

Purpose

kenaifilter1

Dropdown or text

Courses, programs

Catalog filter 1. Its value also shows on cards

kenaifilter2

Dropdown or text

Courses, programs

Catalog filter 2

kenaifilter3

Dropdown or text

Courses, programs

Catalog filter 3

kenaiinfo1

Text

Courses, programs

Extra information on cards. Set its icon in Kenai Info 1 Icon

kenaiinfo2

Text

Courses, programs

Extra information on cards. Icon defaults to fa-clock-o; change it in Kenai Info 2 Icon

kenaimandatory

Checkbox

Courses, programs

Marks the item as mandatory for the Mandatory training section

kenaiprogallocate

Checkbox

Programs

Lets learners allocate themselves. The program appears in the catalog only when this is on and program cards are enabled

kenaisponsor

Picture

Courses, programs

Sponsor logo on cards. Created only when sponsor logos are on and customfield_picture is installed


Filter fields are created as dropdowns when the customfield_options plugin is installed, and as text fields otherwise. To convert existing text fields, use Text field migration or the Text field to dropdown field migration tool. If a Kenai field is deleted, Kenai recreates it unless Disable custom fields recreation is turned on in General settings.

Quick reference

Kenai pages are under Site administration > Appearance > Custom theme settings > Kenai.


Task

Where

Turn the catalog on or off

Kenai > General settings > Enable catalog?

Set catalog options

Kenai > Custom catalogs

Configure the home page

Kenai > Front Page Settings

Choose the tenant fallback

Kenai > General settings > Front page fallback behavior

Add navigation items

Kenai > General settings > Custom navigation

Replace activity icons

Kenai > Activity Icon Management

Brand outgoing email

Kenai > Email customization

Convert text fields to dropdowns

Kenai > Text field to dropdown field migration tool

Edit course Kenai fields

Course > Settings > Kenai Fields

Edit program Kenai fields

Site administration > Learning > Programs > [program] > Edit details > Kenai Fields

Change filter labels

Site administration > Language > Language customization

Turn on the Workplace catalog

Site administration > Learning > Learning catalog settings


For additional help with Kenai, contact your Moodle Account Manager.


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.