Program Widget Documentation

• Overview & Setup
• Widget Configuration & Display Settings
• Field Visibility & Filter Options
• Permission Management

Overview & Setup

The Program Widget is a centralized dashboard block that displays all programs assigned to a user. It acts as a "Learning Hub" where users can view:

• Assigned Programs: Names, descriptions, and total required credits.
• Course Sets & Courses: Specific modules within each program.
• Class Details: Active Course Instances, instructor names, and availability status.

 

Follow these steps to enable the widget for your users:

• Navigate to the Dashboard.
• Toggle Edit Mode to "On" (top right corner).
• Click Add a block and select Learnexify Dashboard.

• On the new block, click the Three-dot menu (⋮) and select Configure Learnexify Dashboard block.

 

• Then from the configure Learnexify block, select Program Widget, Click Save changes.

 

Widget Configuration & Display Settings

To configure this program widget, go to Side Menu > Admin > Widgets > Program Widget.

On the program widget page, you will see the following configuration options: 

• Sync User’s Grades: When enabled, student grades are recalculated in the background every time the dashboard loads. This ensures the progress bar always reflects the most recent academic data.

Progress Bar:

The progress bar provides a graphical representation of the learner's completion status.

• Enabled: Toggle the progress bar on or off.
• Color Stages: You can customize the colors based on three completion tiers to match your institution's branding:

• • 0%–49%: Initial progress (Default: Red).

  • 50%–79%: Mid-way progress (Default: Yellow).

  • 80%–100%: Near completion/Success (Default: Green).

Field Visibility & Filter Options

Learnexify offers granular control over what information is shown at each level of the academic hierarchy. For every field, you can choose one of four states:

• Visible: Always shown.
• Hide: Always hidden.
• Default: Follows system backend settings.
• Lock: Hidden and restricted from being changed by Learners.

Filter Value: Pre-fills a search box (e.g., type "DGD-001" into a Program ID filter value to force the widget to only show that program by default).

These options control whether a search box appears on the dashboard and if the user can change the results:

• Visible / Hide: Shows or hides the data. Note: End users will not have a search filter for these fields.
• Default: Pre-fills the search box with your chosen "Filter Value." Users can delete or change this value to search for something else.
• Lock: Pre-fills the search box and freezes it. Users cannot change the value; they can only see the results you have pre-defined here.

 

These fields appear across all sections of the Program Widget configuration (Program, Course Set, Course Description, and Course Instance). They control what data is shown on the dashboard and how the search filters behave.

Standard Identification Fields

• Name: The full title of the program, course, or set.
  Filter Value: Type the text/name you want to search for.
• Code: A short, shorthand identifier for the course.
  Filter Value: Type the specific code (e.g., CS101).
• ID Number: The unique system identification number.
  Filter Value: Type the exact ID number assigned in the database.
• Description: A summary of what the course or program covers.
  Filter Value: Type keywords found within the description text.
• Credits: The numerical academic value or workload assigned.
  Filter Value: Type the number of credits (e.g., 30).
• Cost: The price or fee required for enrollment.
  Filter Value: Type the numerical price.
• Version: batches updates to the content (e.g., 1.0, 2.0).
  Filter Value: Type the version number.
• Status: Shows the user's current progress.
  Filter Value: Select from the Options include: Not Enrolled, Enrolled, Not Completed, or Completed.
• Pre-test: The assessment taken before the course starts.
  Filter Value: Select the specific test name from the provided list.
• Post-test: The assessment taken after course completion.
  Filter Value: Select the specific test name from the provided list.
• Start Date: The day the class officially begins.
  Filter Value: Use the Date Picker (Calendar) to select a specific day.
• End Date: The day the class officially finishes.
  Filter Value: Use the Date Picker (Calendar) to select the deadline date.

---

To filter a specific item, you must enter your search criteria into the Filter Value box of that matching section:

• For Programs: Type the specific ID Number or Name etc. in the Program section to force the dashboard to only show that degree or diploma.
• For Course Set: Enter the Name or ID of a course bundle (e.g., "Semester 1") to filter the view to a specific group of related courses.
• For Course Descriptions: Select a status like "Completed" or a specific Pre-test in the Course section to filter by student progress.
• For Course Instances: Use the Date Picker or Status dropdown in the Course Instance section to search for specific batch or only available classes.

 

After making the necessary changes and selecting the fields, click the Save button to save your settings.

Permission Management

Permissions control who can view or modify the widget.
To set these, click the Three-dot menu (⋮) on the widget block and select Permissions.

 

Use the Plus (+) Icon to grant a role (like Teacher or Manager) permission, or the Trash Icon to remove it.

 

• View block: Controls who can see the widget (e.g., Students).
• Edit a block’s settings: Controls who can change colors and configurations (e.g., Admins or authorized Managers).
• Add a new Learnexify Dashboard block to My home: Determines if users can manually add this block to their personal "My Home" page.
  
  

 

Advanced Role Overrides:

If you need to change permissions for a specific role exclusively for this widget, use the dropdown to select the role. 

Then, choose one of the following:

• Inherit: Use the standard site default.
• Allow: Explicitly grant the permission.
• Prevent/Prohibit: Block the role from performing the action.