Native extensibility
You can set up custom experiences within the native version of ÃÛ¶¹ÊÓƵ Learning Manager, allowing you not to use headless for less complicated cases. You can also create custom apps and place them at various points in the native version of the learner, manager, admin, author, or instructor workflows.
ÃÛ¶¹ÊÓƵ Learning Manager supports 15 invocation points across Admin, Author, Learner, Manager, and Instructor App.
Create an extension
-
As an Admin, in the left panel, select Native Extensions.
-
Select Add an extension.
-
Type the name of the extension in the Name field.
-
Type the description of the extension in the Description field.
-
Select an invocation point. An invocation point is any location in ÃÛ¶¹ÊÓƵ Learning Manager where a link or button can be inserted on a custom app. The following invocation points are available:
For this example, select Admin, Author: Course, Learning Path - Instances - Instance row.
Select invocation point -
Type the extension label that will appear on the UI in the Extension Label field.
-
Type the URL where you want to host the extension in the URL field.
-
In the Open In dropdown, select whether to launch the extension in a modal or in a new tab.
-
Select the size of the modal. The options are available if you’ve selected In-app modal in the previous step.
To maintain the accessibility inside the popup, the extension app must be sent to the event once they are on the last focusable element on their website, and then the user selects the TAB key. This is needed to keep the focus inside the popup to support accessibility.
code language-none window.parent.postMessage({*} { type: 'ALM_EXTENSION_APP', eventType: 'trapFocusInModal' } ,{}'');
-
Set the scope of the extension. The following scopes are available:
- All Courses, Learning Paths and Certifications: This extension is enabled for all Courses, Learning Paths, and Certifications. Along with Admins, Authors can disable it for some Courses, Learning Paths, and Certifications.
- Selected Courses, Learning Paths and Certifications: This extension is disabled for all Courses, Learning Paths, and Certifications. Along with Admins, Authors can enable it for some Courses, Learning Paths, and Certifications.
-
Select the Activate toggle to make the extension active. Once active, the extension appears on the specified invocation point according to the scope.
-
Select Save in the upper-right corner of the page to create the extension.
Access the extension as Administrator
-
As an Admin, select Learning Paths in the left toolbar.
-
Select a course > View Learning Path.
-
Select Instances in the left panel.
-
Select More in the Instances section. The extension appears in the Instances section.
Select the extensionWhen you select the extension, the extension appears in the modal.
Access the extension as Author
-
As an Admin, select Learning Paths in the left toolbar.
-
Select a course > View Learning Path.
-
Select Instances in the left panel.
-
Select More in the Instances section. The extension appears in the Instances section.
Access extension as an authorWhen you select the extension, the extension appears in the modal.
View all extensions
As an Admin, you can view all extensions on the Native Extensions page. To see the list, select Native Extensions in the left panel of the app.
View all extensions
Enable or disable an extension
As an Author, on the Settings page of a Course, you can enable or disable an extension for a Course, Certification, or a Learning Path.
Activate an extension
Share an Access key
You must share the Access key if you are configuring an enrollment extension.
This is important because if this key is not generated and shared across, the authentication for the enrollment will fail, and learners cannot enroll themselves in the courses.
The Access key must be shared for enrolling in course or Learning Path and certificates.
In the Settings tab, generate the key.
Share the access key
Download extension report
There are two ways to download this report.
Extension configuration report
-
In the Native Extensions page, select Extension Configuration Report.
Download extension reportThe report gets generated.
-
Select OK.
Generating the reportThe report contains the following fields:
- Extension Name
- Invocation Point
- Label
- Open in URL
- Scope
- Activate
- LO Unique ID
- Training Id
- Training Type
- Training Name
Reports page
-
In Reports > Custom Reports, select Extension Configuration Report.
Download the report from Reports page
The state must be in the range 0 - 4294967295, while configuring the enrollment state.