Introduction
Embedded learning allows you to start an instance of your Docebo platform on any external web page, as long as you have access to its HTML and JavaScript code.
The Docebo platform instance opens as a launcher activated either when the user clicks on a button or interacts with an element - such as a link, or a string - on the external web page or it is embedded as a widget within the page. The platform instance shows the training content you, as the Superadmin, have selected for the user on the basis of the action they are performing, in order to provide the best learning on the fly experience, enriching it with ad hoc training.
Embedded learning is available as a web-based application on desktop and mobile platforms.
The launcher allows you to open an instance of your Docebo platform in any external web platform, as long as you have access to its HTML and Javascript code. Find out more on embedded learning and the embedded learning launcher in their respective knowledge base articles.
This article describes the features and functions of the course list widget for the embedded learning launcher. For the Building Blocks version of the widget, please refer to Embedded learning Building Blocks: Course list widget.
Activating embedded learning
To activate embedded learning, reach out to Docebo via the Help Center, or by contacting your Account Manager (if your plan includes this option).
Prerequisites
In order to make use of the embedded learning launcher course list widget, you need to have the embedded learning launcher configured. Please see Embedded learning launcher for more information.
Adding widgets to the launcher home screen
As it happens for the pages of your platform, you can compose the layout of the launcher home screen with widgets. The preview of the launcher home screen is available on the right side of the Launcher Builder tab. From here, you can add or remove widgets from the home screen and edit their configuration.
In order to add a new widget, click on the plus button in the preview box. In the Add New Widget slideout panel, select the widget and click on Next to start its configuration according to the options listed in the following chapters.
At any time, you can edit or remove widgets by clicking on the ellipsis menu at the end of the widget name and by selecting the corresponding option.
The course list widget
The course list widget displays either a static or a dynamic list of courses in the launcher home screen in order to focus the user's attention on selected training activities.
Static View
Select this option and choose up to ten courses that will be listed in the widget. The courses will be visible to the page viewer if users have access to the course on the platform. There may also be situations where a course is visible to the learner in the list but not accessible (for example: the course is under maintenance or the maximum enrollment quota is reached). In those cases the learner will be redirected, within the launcher, to a page stating that the access to the course is denied.
Please note: The maximum number of courses that can be displayed in the static course list is 10.
Dynamic View
Select this option to make the platform artificial intelligence dynamically select the courses displayed in the widget, according to the rules of the platform Global Search engine.
When this option is selected, configure the widget to display courses, learning plans, and training material on the basis of the Global Search results for one keyword.
First, add the following code after the JavaScript section you have injected during the previous integration steps (in the Implementation Code area) to set the keyword that will be used by the widget to look for content.
DFlow.courseList().search(‘keyword’);
Once the launcher is up and running and the widget is shown, the command can affect the result of the search at the moment the command gets implemented, permitting a change of the content of the list on-the-fly without closing the launcher.
Set a title for the widget and move to the Filter Options area to configure how the content resulting from the Global Search will be filtered and displayed in the widget, so that learners will see only the content they are allowed to see.
Select All Courses not to apply any filter, or Other Courses to filter the search results in order to show:
- the courses and the learning plans the user is enrolled in
- the training material of the courses and learning plans the user is enrolled in
- the courses available in catalogs where the learner can self-enroll
Search result tabs can be enabled via the configuration options which will then be displayed in the app launcher as a drop-down menu. Please note that the drop down menu will only be visible if multiple tabs are enabled and there is data to populate those tabs returned by the search engine.
Finally, configure the maximum number of elements displayed in the widget, and customize the text that will be displayed in the widget when the search returns no results.