Ranking block

Blocks ::: block_ranking
Maintained by Willian Mano
A ranking block to improve the gamification into the course.
Latest release:
1707 sites
107 fans
Current versions available: 3

Moodle Ranking block repository


This block is and will remain free, but your donation allows me to continue the development, and any amount is greatly appreciated.

Imagem com link para doação

This block improves gamefication into the moodle plataform.

This new version is more simpler and easy to use, but, with more visual.

The plugin works listening moodle events, so now, the points are added in real time.

The ranking works with the activity completion tracking, so you need to enable that and configure the criterias for all activities you want to monitor. The plugin only add points to activities with completion criterias. The method to add points remains the same.

There are different ways to gain points.

For example:

  • If a student completes a html page the ranking adds 2 points.
  • If a student completes an assignment and it is ended only when the student receive a grade. The ranking add 2 points plus the grade points to the student. You can configure the default points in the block configuraion.

NOTE: All the activities that needs grade to be finished will add the activity points (default 2) more the activity grade. For example: If the course has one assignment and it's configured to be completed only after the grade is received by the student and let's say a random student received by the end of the assignment 10(ten) as his grade. In this case that student will obtain 12(twelve) points, the 2(two pre-configured) from finishing the activity plus 10(ten) from his grade.

This only occurs with activities that have grades. ex: foruns, assignments, lessons, etc...

For Moodle version 3.2+ 

With the new chart api in moodle version 3.2 i added some graphs to see the groups performance. Enjoy and feel free to send me your feedback.

Update Notes

  • Added graphs page
  • Added event listeners to add point
  • Removed cron dependency
  • Added a weekly ranking
  • Added a monthly ranking
  • Added a tiny report with top 100 students in general ranking
  • Added filter the tiny report by groups (the course group mode needs to be "separeted groups" or "visible groups")
  • Now you don't need configure the course completion tracking, only the activities completion criterias. Again, the plugin only monitors the activities with completion criteria
  • The table ranking_cmc_mirror was removed.


First way

  • Clone this repository into the folder blocks.
  • Access the notification area in moodle and install

Second way

  • Download this repository
  • Extract the content
  • Put the folder into the folder blocks of your moodle
  • Access the notification area in moodle and install

Post instalation

After you have installed the block you just add it into the moodle course.

The ranking block works together with the activity completion, so you need to enable that and configure the criterias for all activities you want to monitor. The ranking block monitors these activities and add points to the students based on accomplishing the activities.

Enabling completion tracking

  • Go to: Site administration / Advanced features
  • Turn on the item "Enable completion tracking"
  • Inside the course go to: Course administration / Edit settings
  • In the section Completion tracking set "Completion tracking" to yes
  • Save


Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3
Screenshot #4
Screenshot #5
Screenshot #6


Willian Mano (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Plínio Felipe Peçanha Oliveira
    Thu, Apr 5, 2018, 4:41 AM
    Olá, como resetar o ranking? Mesmo reconfigurando todo o curso a nota do aluno permanece no ranking. E como configurar o ranking para dar somente a nota que os alunos conquistam nos testes sem que some +2 pontos? Obrigado!
  • Plínio Felipe Peçanha Oliveira
    Thu, Apr 5, 2018, 4:43 AM
    Mesmo configurando para 0 o plugin ainda somou 2 pontos
  • zeynep yıldırım
    Fri, May 18, 2018, 4:30 AM
    do students see the ranking blocks or only the instructor see ?
  • Ricardo Caiado
    Fri, Sep 21, 2018, 1:06 AM

    Planos para atualizar para o Moodle 3.5?

  • Gabriele Cristini
    Mon, Oct 8, 2018, 5:59 PM
    Is it possible setting the plug-in to do students see the Ranking graph?

  • M G
    Tue, Oct 9, 2018, 9:13 PM
    Hi Willian,

    I have installed this block in moodle version 3.5 but nothing is getting updated in ranking block.
    I have followed all the instructions mentioned above. Can you please confirm if I have to do something else as well?

  • Goodluck Emereuwa
    Wed, Apr 24, 2019, 6:35 AM
    Please how do you use this block?
    I can't seem to get it to work in my project. I use both 2.7 and 3.6
  • Christian Trindade
    Wed, Jun 12, 2019, 1:10 AM
    'm using moodle 3.7 with moove theme.
    Can I install Ranking block?
  • Willian Mano
    Thu, Jun 13, 2019, 4:21 AM
    Hi Christian. Yes, you can.
  • Dnyaneshwar Somwanshi
    Fri, Sep 13, 2019, 3:08 AM
    Have u planned to add mobile app support to this beautiful plugin. If yes , when will it be released.? Very excited to use in mobile app
  • Sourish Bose
    Tue, May 19, 2020, 4:47 PM

    Does it supports group leaderboard ?

    I want to see the ranks of the students in a particular group.
  • Sourish Bose
    Tue, May 19, 2020, 6:35 PM
    Also, can I add it to a specific activity or resource like a Quiz?
  • Jimmy Muñoz
    Tue, Jan 4, 2022, 9:01 AM
    this plugin is for the moodle 3.11?
  • Willian Mano
    Thu, Jan 6, 2022, 5:08 AM
    Jimmy Muñoz, yes it is.
  • chandan kumar
    Sun, May 28, 2023, 1:54 AM
    How does Ranking block calculates points?
    Here is what I did
    1. Created two students roles in course naming "Student five" and "Student two".
    2. Both of them gave a Quiz which was part of course.
    3. "Student five" in his first attempt answered all questions correct and scored grade 10 and ranking block points 19.
    4. "Student two" attempted quiz and got zero grade and 4 points in first attempt. "Student two" cored 10 grade and 17 points in second attempt.
    5. Grade is set to highest score.

    Why when grade of both students are same, they are getting different rating?
1 2 3 4 5 6 7 8 9
Please login to post comments