How to configure course widgets

How to configure course widgets

Overview

Each course allows instructors and teachers to customize the widgets displayed in the right panel for users. They can also enable a course Dashboard that can display a variety of widgets. This article will show you how to customize widgets at the course level.
Info
Note that the business platform defaults to the term course, and the academia platform defaults to the term class. The term course and class are interchangeable in this article.

Configuring dashboard widgets

Instructors and administrators can configure the widgets available to users on a course's dashboard.

To add widgets to the dashboard, you must first enable a course dashboard:

  1. Access the course.
  2. Click Admin from the course navigation menu.
  3. Click Features from the fly-out menu.
  4. Select Dashboard.

Course, Admin, Features tab with Dashboard checkbox highlighted

To configure the dashboard widgets:
  1. Access the course.
  2. Click Dashboard on the course navigation menu.
  3. Click the Edit widgets button on the upper-right side of the course landing page.

Course, Dashboard, Edit widgets button highlighted

The Edit pop-up displays, which allows you to edit widgets for learners and instructors. To edit dashboard widgets:
  1. Click Instructor center panel or Learner center panel.

Edit pop-up

Available widgets display in the right panel. 
  1. Drag and drop widgets from the right panel to the dashboard.
  2. Use drag and drop to reorder widgets on the dashboard.
  3. To remove a widget from the course dashboard, move it back to the Available widgets panel.
  4. When you have finished configuring widgets, click Save.
  5. If you want to discard the changes you made, click Cancel.

Edit Dashboard screen with the Assessments widget highlighted and being moved to the center panel

Some widgets allow you to change the way data is displayed on the widget. If available:
  1. Click the icon on the widget tile.
  2. Last: Select data from the last 7 days, 4 weeks, or 6 months to display.
  3. Chart type: Select between spline, column, area, or pie chat. 
Learners widget with the more icon highlighted

To further customize the course dashboard, there are two HTML widgets that can be added to the center panel:
  1. Wide HTML widget: The Wide HTML widget can be added to the center panel and spans the width of the center panel.
  2. Small HTML widget: The Small HTML widget can be added to the center panel and is a quarter of the width of the center panel.
To learn more about configuring HTML widgets, visit the Custom HTML widgets section of the Widgets article. 

Edit dashboard screen with the Wide HTML widget highlighted in the center panel and the Small HTML widget highlighted in the Available widgets column

Configuring the welcome widget

The welcome widget is a large carousel at the top of the dashboard, which is useful for displaying instructions and announcements for users.

 To add a welcome widget:

  1. Click the Edit widgets button.
Course, Dashboard with the Edit widgets button and Welcome widget highlighted

  1. Select Instructor center panel or Learner center panel from the pop-up.
Edit pop-up with Instructor center panel and Learner center panel options highlighted

The Available widgets panel displays.

  1. Drag-and-drop the Welcome widget to the top of the dashboard.
  2. After the banner is added, click Save.
Edit Dashboard screen with the Welcome widget highlighted and being moved to the center panel

Once the dashboard layout is saved, you can edit the widget. 

  1. Click the edit icon on the Welcome widget to add slides with text, images, and call-to-action buttons.
Welcome widget with the edit button highlighted

The Settings pop-up displays.

You can add, edit, and reorder slides on the left panel. The right panel displays a preview of the slide.

To add a new slide:
  1. Click Add slide.

Welcome widget settings pop-up with the Add slide button highlighted

The Add banner slide pop-up displays.
  1. Click Text+Picture to create a slide using the built in editor.
  2. Click Custom HTML to create a custom slide with HTML
Add banner slide pop-up

Selecting a Text+Picture slide allows you to edit the slide using the editor on the left panel.

  1. Enter Heading and Description text that will display on the slide.
  2. Select Text color and Background color for the slide.
  3. If a default image displays, click Remove picture.
    1. Click Change picture to add your own image.
  4. Add Button text and a Button url if you would like to add a button and link to the slide.
    1. The button text and url are optional. 
Welcome widget settings pop-up with slide content highlighted

You can also add visibility filters if you would like to filter which users see the slide:

  1. Click + Add filter in the Visibility section.
  2. Select a field, operator, and value for the filter.
  3. Click +.
  4. Visit the Filters article to learn more about defining filters.
Welcome widget settings pop-up Visibility section highlighted
Once you have completed your slide:
  1. Click < Back.
  2. The changes will be automatically saved.

Welcome widget settings pop-up with the Back button highlighted

Selecting a Custom HTML slide allows you to use the built-in HTML editor.
  1. Use the HTML editor to add text, images, media, and more.
  2. When you finish creating the slide, click Save.

Custom HTML slide editor pop-up

To adjust slides in the carousel:
  1. Reorder slides by clicking the icon and dragging and dropping slides to a new location.
  2. To hide or delete a slide:
    1. Hover over the slide.
    2. Click the cog icon.
    3. Click Hide or Delete.
Welcome widget settings pop-up with the cog menu highlighted

There are two additional welcome widget settings:

  1. Title: Enter a title for the widget.
  2. Autoplay slide speed: Define how many seconds each slide displays before moving to the next slide. 
    1. To disable the slide autoplay, select Don't autoplay.
When you finish configuring the banner widget, simply close the editor. Changes are saved automatically.

Welcome widget settings pop-up with the Title and autoplay slide speed settings and X button highlighted

On the dashboard, the welcome widget includes a number of options in the upper-right corner.

  1. If the widget is configured to autoplay the slides, click the Pause button to pause on a slide.
    1. Once paused, click the Play button to resume autoplay. 
  2. If you customized the course dashboard banner widget, click the Reset button to quickly reset the widget to default content.
  3. Click the Edit button to edit the widget.

Course, Dashboard with the Welcome widget buttons highlighted

Additional information regarding the welcome widget:

  • If the welcome widget is added to the instructor center panel, it is automatically added to the learner center panel.
    • Likewise, If the welcome widget is added the learner center panel, it is also added to the instructor center panel.
  • If you add custom content to the welcome widget, it is shown to both learners and instructors by default.
    • If you do not want slides to display to a specific set of users, you can add a filter. Visit the Filters article to learn more about defining filters.

Configuring right bar widgets

Instructors and administrators can configure the widgets available to users on the right panel of a course.

Info
Please note that if you customize the widgets for a specific course, it will not affect other courses. 

To configure right panel widgets for a course:

  1. Access the course.
  2. Click the Edit widgets button on the upper-right side of the course landing page. 
Course, Dashboard with the Edit widgets button highlighted

The Edit pop-up displays, which allows you to edit widgets for learners and instructors.
To edit right panel widgets:
  1. Click Instructor right panel or Learner right panel.

Edit pop-up with Instructor right panel and Learner right panel options highlighted

Available widgets display in the left panel.
  1. Drag and drop widgets from the the Available widgets panel (on the left) to the right panel. 
  2. Use drag and drop to reorder widgets on the right panel.
  3. To remove a widget from the course dashboard, move it back to the Available widgets panel.
  4. When you have finished configuring widgets, click Save.
  5. If you want to discard the changes you made, click Cancel.
  6. You can reset the right panel back to the initial defaults by clicking Reset.
Info
Note: If you remove all widgets from the right panel, the panel will be automatically hidden.

Edit right panel screen with the Site-wide game widget highlighted and being moved to the right panel

Custom report widgets

You can add report widgets to the course dashboard and also to the right panel.

Info
Please note that you can only attach widgets to scheduled reports that return a chart.
To add a report widget:
  1. Access the course's dashboard.
  2. Click the edit widgets button.
  3. Select where you want to add the report widget:
    1. On the center panel or on the right panel
    2. For instructors or for learners.
Course, Dashboard with the Edit widgets button highlighted

  1. Select the Report widget from the Available widgets panel and drag it to the dashboard (or right panel).
Edit Dashboard screen with the Report widget highlighted and being moved to the center panel

To associate the widget with a custom report:

  1. click  on the Report widget tile.
  2. Click Report.
Edit Dashboard screen, Report widget, More menu active with Report highlighted

A pop-up displays of your scheduled custom reports.

  1. Select which scheduled custom report you would like to display in the widget.
Select a scheduled report to display pop-up

To edit the widget:
  1. Click the  icon on the Report widget.
  2. Click Report to update which report is displayed in the widget.
  3. Click Title to change the widget title.
  4. Click Delete to delete the widget. 
Report widget with the More menu active and highlighted

You can add as many report widgets as you want to the central or right panel.

When you finish adding widgets:
  1. Click Save.
  2. The selected report widgets will be added to the dashboard and the data will refresh every time the report runs based on the defined schedule.
Edit dashboard screen with two Report widgets highlighted

To learn more about creating custom reports, please visit the Reports topic.

HTML widgets

You can create custom HTML widgets and add them to the right and center panels. 

To add a HTML widget:
  1. Access a course.
  2. Click the Edit widgets button on the upper-right side of the course landing page. 
  3. Select where you want to add the HTML widget:
    1. On the center panel or on the right panel
    2. For instructors or for learners.
  4. Drag the HTML widget from the Available widgets panel to the center or right panel.
    1. You can add multiple HTML widgets to either panel.
Edit Dashboard screen with two HTML widgets highlighted on the right panel

To configure a HTML widget:

  1. Click the icon on the HTML widget tile.
  2. Click Settings.
HTML widget with the More menu active

  1. Enter a widget Title.
  2. Determine if you want the widget to be minimizable,
  3. Click Save.

HTML widget Settings pop-up

To add content to the widget:
  1. Click the icon on the HTML widget tile.
  2. Click Editor.
  3. Use the HTML editor to build the content of the widget.
  4. Click Save.
HTML widget editor

To delete an HTML widget:

  1. Click the icon on the HTML widget tile.
  2. Click Delete.asdf
HTML widget with the More menu active

    • Related Articles

    • Configure courses and classes

      Overview The Configure menu gives you the ability to customize and modify courses to meet the learning needs of your organization. This article will walk you through the course and class configuration features in the platform. CYPHER for business ...
    • Course editor and content builder

      Overview The built-in editor allows instructors, teachers, and administrators to create content directly inside of courses, with formatted text, pictures, attachments, and links. The editor also allows users to format content pages using columns and ...
    • Course and class completion

      Overview Course and class completions are an important part of the platform, as they help track learner progress, provide records for compliance or audits, and provide data for reports. CYPHER for business defaults to courses, and CYPHER for academia ...
    • Course templates

      Overview A course template is a course without learners or enrollments that serves as a template from which you can easily create new courses. Course templates can be configured the same way as courses, with all settings copied to the new courses. ...
    • Copy a course or class

      Overview The platform allows you to copy an existing course to quickly create a new course or course template. CYPHER for business defaults to the term course. CYPHER for academia defaults to the term class. The terms course and class are ...