ÃÛ¶¹ÊÓƵ

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

  1. As an Admin, in the left panel, select Native Extensions.

  2. Select Add an extension.

  3. Type the name of the extension in the Name field.

  4. Type the description of the extension in the Description field.

  5. 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.

    extension image
    Select invocation point

  6. Type the extension label that will appear on the UI in the Extension Label field.

  7. Type the URL where you want to host the extension in the URL field.

  8. In the Open In dropdown, select whether to launch the extension in a modal or in a new tab.

  9. 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' }
    
    ,{}'');
    
  10. 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.
  11. Select the Activate toggle to make the extension active. Once active, the extension appears on the specified invocation point according to the scope.

  12. Select Save in the upper-right corner of the page to create the extension.

Access the extension as Administrator

  1. As an Admin, select Learning Paths in the left toolbar.

  2. Select a course > View Learning Path.

  3. Select Instances in the left panel.

  4. Select More in the Instances section. The extension appears in the Instances section.

    instances image
    Select the extension

    When you select the extension, the extension appears in the modal.

Access the extension as Author

  1. As an Admin, select Learning Paths in the left toolbar.

  2. Select a course > View Learning Path.

  3. Select Instances in the left panel.

  4. Select More in the Instances section. The extension appears in the Instances section.

    instances image
    Access extension as an author

    When 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 extensions image
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 extension image
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 key image
Share the access key

Download extension report

There are two ways to download this report.

Extension configuration report

  1. In the Native Extensions page, select Extension Configuration Report.

    report image
    Download extension report

    The report gets generated.

  2. Select OK.

    generating report image
    Generating the report

    The 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

  1. In Reports > Custom Reports, select Extension Configuration Report.

    reports page image
    Download the report from Reports page

The state must be in the range 0 - 4294967295, while configuring the enrollment state.

recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d