Kenai User Guide
TABLE OF CONTENTS
- Kenai User Guide
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
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
Go to Site administration > Appearance > Themes.
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.
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.
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.
Banner settings
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.
Featured items
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.
Turn on editing mode.
Add a block in the right-hand drawer.
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
Make Home the start page. Go to Site administration > Appearance > Navigation and set Start page for users to Home.
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.
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.
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.
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
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
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
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
Turn the catalog on. In General settings, set Enable catalog? to Yes (this is the default).
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.
Set catalog options on the Custom catalogs page (table below).
Fill in Kenai fields on courses and programs. See the Field reference.
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
Turn on both catalogs.
Kenai: General settings > Enable catalog? = Yes
Workplace: Site administration > Learning > Learning catalog settings > Enable learning catalog = Yes
Select it. On the Custom catalogs page, set Selected catalog to the Enhanced Native Catalog.
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.
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
Optional: mandatory filter. In Learning catalog settings, under Fields to display in the learning catalogue filter, make Mandatory visible.
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.
Filter labels
Catalog filter labels come from language strings, not from the custom field names.
Go to Site administration > Language > Language customization.
Open the theme_kenai strings.
Edit the strings for each filter:
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)
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.
For additional help with Kenai, contact your Moodle Account Manager.