Learn Compete

The LearnCompete plugin is an advanced gamification system for the e-learning platform that introduces competitive and ranking elements to increase user engagement. The plugin allows the creation of global and per-course leaderboards, stimulating active participation through mechanisms of competition and recognition.

Main Features

Leaderboard System

• Global Leaderboard: A general ranking of all users on the platform, calculated based on the total points and the number of courses completed.

• Course Leaderboard: A specific ranking for a single course, based on user performance within it.

• User Ranking: A detailed view showing the list of courses a single user has completed, along with their scores and rankings.

Technical Features

• Score calculation based on performance and course difficulty.

• Display of a single user's results history.

• Data visualization through clear and intuitive tables.

• Integration with the user dashboard via a dedicated widget.

Leaderboards: mastering your corporate academy

Accessing your Leaderboards

The plugin is accessible through a dedicated menu in the administration panel:

1. Access the admin panel.

2. Navigate to the "Leaderboard" menu item.

1. LearnCompete Global Ranking

The global leaderboard shows the general ranking of all active users on the platform.

Features:

• Displays rank, username, total completed courses, and points.

• Sorted by total score. In case of a tie, the user who has completed more courses is ranked higher.

• Ability to search for specific users.

• Clicking on a user's name allows you to view their course history.

Metrics displayed:

• Rank: Position in the leaderboard.

• Name: User's name.

• Tot. Courses: Total number of completed courses.

• Points: Total accumulated score.

2. LearnCompete Course Ranking

A specific leaderboard for a single course, showing users who have completed or are currently taking a specific course.

Features:

• Displays the participant leaderboard for a single course.

• Displays completion time (Tracking Time).

• Shows specific points earned in the course.

• Identifies the course leader.

Metrics displayed:

• Rank: Position in the course leaderboard.

• Name: User's name.

• Tracking Time: Time taken to complete the course.

• Points: Points earned in the specific course.

3. LearnCompete User Ranking

This view shows the individual performance of the logged-in user, with a history of their performance and progress over time. It lists the courses the user has completed and the results achieved in each.

Features:

• Lists the courses completed by the user.

• Details of the score, completion date, and rank obtained for each course.

• Access the specific course leaderboard by clicking on the corresponding row.

Metrics displayed:

• Course Name: The name of the completed course.

• Tracking Time: The time taken to complete the course.

• Points: The score obtained in the single course.

• Rank: The leaderboard position achieved in that course.

4. LearnCompete Aggregated Course Ranking (Course List)

This section displays an aggregated list of all courses that contribute to the general leaderboard, providing an at-a-glance view of which courses are included in the ranking system.

Features:

• A list of all courses active in the gamification system.

• Displays the number of enrolled students per course.

• Identifies the leader of each course.

• Displays the maximum achievable score for each course.

Metrics displayed:

• Name: Course name.

• Students: Number of enrolled students.

• Leader: The user with the best performance.

• Points: The maximum score achievable in the course.

Course Configuration

Adding Courses to Ranking System

To include a course in the LearnCompete ranking system:

1. Navigate to the course settings page
2. Expand the relevant configuration sections
3. Locate the "add to ranking" checkbox at the bottom of the settings
4. Check this box to include the course in the global and course-specific leaderboards
5. Save the course settings

Note: Only courses with the "add to ranking" option enabled will appear in the leaderboards and contribute to user scores in the gamification system.

Scoring System

The plugin uses a scoring system to calculate user ranks, based on the following factors.

Calculation Factors:

• Course Score: Each course assigns a variable score based on the user's performance (result and completion time) and is weighted by the course's difficulty.

• Global Ranking: The platform's global ranking is calculated based on the total points acquired by each user across all courses and the total number of courses completed.

Example of Scoring Parameters:

• Base Score: A score assigned by each course for the purpose of the global leaderboard.

• Difficulty Index: The impact of course difficulty can be configured in two ways:

1. Through a multiplier applied based on the course's difficulty level.

2. By assigning a different base score for each difficulty threshold.

User Dashboard Integration

The plugin integrates natively with the user dashboard, providing an immediate overview of performance.

User Global Ranking (Dashboard Widget)

The User Global Ranking widget provides each user with a quick overview of their position in the platform’s global leaderboard directly from the dashboard.

Features displayed:

• Rank: The user’s position compared to all active users.

• Global Score: The total points accumulated across all courses included in the gamification system.

• Total Courses: The number of courses completed by the user that contribute to the ranking.

This widget offers immediate feedback on the user’s progress and fosters engagement by highlighting their standing relative to peers.

Suggested Courses Section

The dashboard can include personalized suggestions for the user, such as:

• Available courses with direct links.

• References to the F.A.Q. section for support.

• Access to the helpdesk for technical assistance.

• Motivational messages (e.g., "Happy Learning!").

Customization and Configuration

Dashboard Settings

Administrators can customize the dashboard layout and the blocks displayed using the Dashboard Settings panel.
To access:
Settings → Dashboard Settings → Create a new dashboard

Available configuration options:

• Type: Defines the layout of the block (e.g., 1-col, 2-col).

• Title: Allows the administrator to input a custom title for the dashboard block.

Manual Leaderboard Update

To manually update the leaderboards, navigate to Configuration > Plugin then find the plugin and click on "Configuration"  in the administration panel. Here you will find the following options:

• Generate Actions: This button runs a script that generates user actions (e.g., "test completed," etc.) which serve as the basis for leaderboard computations.

• Generate Aggregated Courses Leaderboard: This button generates the leaderboard for aggregated courses.

• Generate Courses Leaderboard: This button generates the leaderboard for individual courses.

• Generate User Global Ranking: This button generates the global user ranking leaderboard.
  

Troubleshooting

Common Issues

Scores Not Updating

• Verify that the course has been effectively completed.

• Check that the score calculation rules are correct.

• Perform a manual recalculation if necessary.

Empty Leaderboards

• Verify the presence of active users who meet the criteria.

• Check the course's configuration.

• Check the viewing permissions.

Slow Performance

• Optimize database queries.

• Implement a caching system for results.

• Limit the number of results displayed per page.

Best Practices

Gamification Implementation

• Maintain healthy competition: The goal is to motivate, not discourage.

• Balance challenge and achievability: Objectives should be difficult but not impossible.

• Celebrate individual successes: Publicly acknowledge achieved milestones.

Community Management

• Leaderboard Moderation: Monitor for incorrect behavior within the system.

• Communication: Clearly explain the scoring rules and celebrate achievements.

Monitoring user Engagement

Engagement Metrics

The system allows for monitoring the impact of gamification on user engagement.

Main KPIs:

• Course completion rate.

• Average completion time.

• Leaderboard participation rate.

• User retention rate.

Competitive Analysis

• Analysis of score distribution.

• Identification of user clusters based on performance.