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


  • Mon, May 26, 2014, 5:17 AM
    i'm sorry for the block ranking. I'm without time to fix the issues. But you are free to fix something and make a pull request. Help the soul of the open source.
  • Mon, May 26, 2014, 2:42 PM
    Hi Willian,

    Sorry to ear that, but in that case you may be interested in requesting adoption for this plugin:

  • Tue, Nov 25, 2014, 10:15 PM
    Olá Willian. Meu caro, alguma previsão da atualização desta versão para o Moodle 2.7/2.8 + ? Gostaria de implementar no nosso ambiente, mas como temos a versão 2.7 e em preparação para a 2.8 seria interessante essa atualização! agradeço e sucesso!
  • Wed, Dec 17, 2014, 6:26 AM
    Hi Willian,
    I have a problem with this plugin, i don't know if this plugin works this way, I'm setting the Ranking block, but it doesn't assign points as I wish; in the ranking always adds the 2 default points to the left and the points of the forums, quiz and the activities adds to the right.
    I really want to merge and sum these two values in one value.
    My english isn't the best, i hope you can understand me.
  • Thu, Jan 8, 2015, 11:39 AM
    Hello. I'd like to ask a question to the developer or anyone who understands how the block works internally. I'm using it as reference for developing my own block and I'd like to know why the modules completion is mirrored to another table?
  • Sat, Feb 7, 2015, 1:04 AM
    Hi! Is there any chance to see this nice plugin updated for moodle 2.8?
  • Sat, Feb 7, 2015, 1:42 AM
    Yes, i will upload a new version tomorrow. ;)
  • Tue, Mar 3, 2015, 2:21 AM
    Hi! I don't want to be annoying but did you already find some time for a 2.8 release?

    Ranking block rocks! ;)
  • Tue, Mar 3, 2015, 6:52 AM
    Thanks for the patience... I want to change some stuffs of the block... who want to contribute with it answering some questions?
  • Tue, Mar 10, 2015, 12:12 PM
    FYI...I installed the plugin from the forum here and it didn't work...it installed the 2.2 version on my 2.8 version. The 2.7+ version worked perfectly.
  • Fri, Mar 13, 2015, 9:32 AM
    Hi all, I installed the ranking block (version 2014022400) in Moodle 2.8.3+ (Build: 20150205). Then, I logged in as a test student. After this I logged in again and could see the points for the test student. Success! Thanks a lot for your work, Willian.

    I am in the process of gamifying an online class for fall 2015. Is the ranking block in compliance with the Family Educational Rights and Privacy Act (FERPA)? I am just asking as the full name of the student is revealed with the accumulated points (points for graded activity + points for completing an activity).
  • Tue, Mar 17, 2015, 9:33 PM

    I've installed the ranking block (version 2014022400) in Moodle 2.8.5 over PostgreSQL, and added the block to a course with activity completion tracking enabled and some activities marked to be completed to complete the course, but when a student completes some of those the block still shows "No students to show" message.

    I've done a little research and I think that cron does not update the block status as long as:

    - I don't see any scheduled tasks about this ranking block https://docs.moodle.org/28/en/Scheduled_tasks
    - I don't see any trace on the cron log about this block

    I am really interested on trying this plugin, if there is more tests I can do to help, please tell me.

    [Off-topic]: Inside the plugin folder there is a copy of the plugin itself called 'moodle-block_ranking', I think it should be removed.
  • Tue, Mar 17, 2015, 10:01 PM
    Hey Iñigo Zendegi Urzelai, Thanks for your reply. I've uploaded a new version without the subfolder. About the postgres, it is an issue, the block it's not compatible with that SGBD. I'm developing right now a new version of the plugin with new features and totally compatilble. I wish...
  • Tue, Mar 17, 2015, 10:03 PM
    Hartmut Scherer, I did not know about FERPA, i will read about it..
  • Tue, Mar 17, 2015, 10:16 PM
    Thanks for the quick reply, Willian, I'll be waiting for that new version!
Please login to post comments