Ranking block

Blocks ::: block_ranking
Maintained by Willian Mano Araújo
A ranking block to improve the gamification into the course.
Latest release:
1664 sites
96 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 Araújo (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS


  • time!
    Fri, Apr 29, 2016, 4:14 PM
    Hi, I am running moodle 2.6 and can not get the ranking board to display any scores. I notice some other people with moodle 2.6 also had the same issue. Is there a simple solution?

    And on a different note - I think this is an awesome block.
  • Tue, May 24, 2016, 8:29 PM
    William, tudo bem? Belo plugin! Tenho uma dúvida na atribuição de pontos na atividade quiz, no bloco ranking:
    Optei pela pontuação na primeira tentativa e os resultados foram confusos para mim, veja:
    A sequencia é de notas do quiz seguido de notas que imagino que o ranking atribuiu (12/1.2 - 10,5/1.1 - 13,5/1.4 - 9/9 - 15/1.5) então as notas do ranking ficaram assim (3.2 - 3.1 - 3.4 - 12 - 3.5) Como podemos corrigir isso? Usou o Moodle 3.0 e a última versão do seu bloco.
  • Tue, Jun 21, 2016, 9:14 PM
    Hi William, awesome plugin.
    I wish to display the full name in the block (First name + Surname). Is that possible for us to do, perhaps with a small change to the code?
    Many thanks!
  • Tue, Jul 5, 2016, 10:36 PM
    Hey Nick, this is totally possible, but i removed that 'cause i received a recommendation about user privacy. You can change that on file lib.php line 305 and change to that: $OUTPUT->user_picture($data[$i], array('size' => 24, 'alttext' => false)) . ' '.$data[$i]->firstname . ' ' . $data[$i]->lastname,
  • Tue, Jul 5, 2016, 10:36 PM
    Dirceu, copiando aqui a resposta enviada diretamente por mensagem.

    Isso acontece pois o raking sempre da por padrão uma pontuação para o estudante. Nesse caso, está configurado para 2. Segue uma explicação mais detalhada:

    O ranking atribui pontos padrão por cada atividade concluída. Assim, é adotada para fins de classificação: a Visualização dos Produtos no AVA (Plano de Ensino, Roteiro de Aprendizagem, Leitura do Caderno de Estudo e Material Complementar, Videoaulas, entre outros); Postagem das Atividades e Nota Atribuída pelo Tutor.

    Para cada atividade concluída são atribuídos 2 pontos.

    O ranking também leva em consideração a nota obtida nas atividades avaliativas (nota atribuída pelo tutor a distância). Por exemplo, caso você receba 8,5 em uma atividade qualquer, serão somados 2 pontos, totalizando 10,5 onde a nota máxima será 12 pontos.
  • Wed, Jul 20, 2016, 8:50 PM
    Dear Willian
    Thank you very much for the plugin, I use it with my students in a class gamificada to learn programming.
    I have a problem when the note of an activity is greater than 10, for example 20, is assigned 2 points by default and only 2 points for the activity, when it should be 20, is divided by 10 to apparently this does not happen when note the activity is less than 10, in that case if the 12 points assigned properly. Please help. Thank you
  • Wed, Sep 14, 2016, 9:30 PM
    Olá Willian

    Haverá uma atualização desse plugins para o moodle 3.1?
  • Thu, Oct 6, 2016, 12:30 AM
    i installed this plugin but i cant see the option for change the points for activities...
  • Thu, Oct 6, 2016, 6:26 AM
    Bruce Chagas. Ainda essa semana eu subo a versão pro 3.1, mas de antemão eu digo que funciona.
  • Thu, Oct 6, 2016, 6:27 AM
    Michell Mejia, the option is located in site administrations -> plugins -> blocks -> ranking block
  • Ricardo Caiado
    Wed, Dec 7, 2016, 8:30 PM
    Any upgrade to Moodle 3.2?
  • Thu, Dec 8, 2016, 3:58 AM
    Ricardo Caiado, you can download right now the upgrade to Moodle 3.2
  • Fri, Dec 9, 2016, 10:59 PM
    How can you reboot all rakings points? Is there an option?
  • Wed, Dec 14, 2016, 4:02 PM
    is it work on PHP7.1?
  • Thu, Dec 22, 2016, 7:00 PM
    Is it possible separate the rank list by groups?
    I have two groups (group1 and group2) in group1 there is one student and in group2 another one.
    If I click on "See full ranking" as a student I see all the users ranking but i want to see only my groups!
Please login to post comments