Hi @sendres,
You have that correct, in it's most basic usage, it can add new nav items with some icon options (instructure ui, inline SVG, or a hosted SVG file). With it's expanded or advanced capabilities, it allows adding new trays or augmenting existing trays.
It sounds like your Center for Teaching & Learning Excellence course is similar to our Curriculum Hub, which is a course index for a bunch of other linked courses.
I'm short on basic documentation at the moment as I've been spending my time on this consolidating the multiple navigation mods we've been utilizing for years into this one. However, the 3 JavaScript files in the repo are setup to test the primary features. If you have a single instance (of Canvas and not a consortium*), and are only interested in adding a nav item for your custom course, then the global-custom-nav-context-items.js will work.
/main/global-custom-nav-context-items.js#L282
Starting with the example options of globalCustomNav_items, you can remove the examples and replace it with the following snippet. Then the href would be changed path of your course. The roles function allows you to enable the nav item for faculty with those enrollment types. The icon_svg can be any of the 3 options: instructure icon, inline SVG, or an https url to an external file. The position property will set the icon location, by default it will be placed before the Help icon. The roles property includes a callback function to handle adding the item for staff users.
const globalCustomNav_items = [{
title: 'Center for Teaching & Learning Excellence',
// custom context handles active class in global nav
icon_svg: 'icon-expand-start',
href: '/courses/101',
target: '_top',
//position: 'before' // can be one of: integer (position after first), 'after' (help or last), 'before' (help or last)
roles: function () {
var enrollment_type = ['teacher', 'admin', 'root_admin', 'consortium_admin'].some(a => ENV.current_user_roles.includes(a));
return enrollment_type;
}
}];
The CSS (lines 8-26) at the top can be removed if you favor adding the rules in your Themes CSS file with:
/main/css/global-custom-nav-items.css
* If you have multiple trust instances of Canvas (consortium), I need a couple of test cases to work out the logic for this beyond how I handled it for us.
