Your Moodle version

Blocks: Ranking block

Maintained by Picture of Willian Mano Willian Mano
A ranking block to improve the gamification into the course.

Moodle Ranking block repository

This block improves gamification into the moodle plataform.

The ranking block works together with the moodle course completion. In the moodle course you configure the criterias to the end of the course. The ranking block monitors these activities and add points to the students based on accomplishing the activities. 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...


First way
  1. Clone this repository into the folder blocks.
  2. Access the notification area in moodle and install
Second way
  1. Download this repository
  2. Extract the content
  3. Put the folder into the folder blocks of your moodle
  4. 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 moodle course completion. In the moodle course you configure the criterias to the end of the course. The ranking block monitors these activities and add points to the students based on accomplishing the activities.

OBS: The ranking block needs the moodle cron configured and working fine. Read the moodle documentation about the cron file (for more information..

How to use the block ranking





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

Comments RSS

Show comments
  • Picture of Shane Edwards
    Sat, Mar 15, 2014, 12:54 PM
    To clarify further, the PHP function EMPTY() in version before PHP 5.5 only allowed variables. As of PHP5.5 the function accepts other entries such as the return value of a function.
  • Picture of Willian Mano
    Tue, Mar 18, 2014, 3:23 AM
    Hey, Shane Edwards. Thanks for your reply.
    I've solved this in the last version.
  • Picture of Xiaoyu Zhu
    Fri, Mar 21, 2014, 2:56 PM
    How to use the block ranking
  • Picture of Maxime Taisne
    Fri, Apr 4, 2014, 10:58 PM

    If you want to be able to add this block on a MS SQL Server powered Moodle, you need to make some little code changes in lib.php:
    1. On line 52-53, replace 'SELECT DISCTINCT' by 'SELECT DISTINCT TOP $limit'
    and replace on line 64 'LIMIT ".$limit;' by '";'

    2. On line 53, replace 'CONCAT(u.firstname, ' ', u.lastname)' by '(u.firstname + ' ' + u.lastname)'

    3. On line 144, replace 'IFNULL' by 'ISNULL'

    Some changes might still be needed by I haven't found any other problem yet (still testing the block).

  • avatar
    Mon, Apr 14, 2014, 5:11 AM

    In my Moodle 2.5.2 the ranking block doesn't add points to completed activities that have grades, for example: hot potatoes quiz, quiz, scorm, etc. Ranking block version: 2014022400.

    Best regards
  • Picture of Iñigo Zendegi Urzelai
    Fri, May 9, 2014, 8:51 PM

    This plugin looks great, but in my Moodle 2.5.5 over PostgreSQL doesn't work (version: 2014022400).

    The plugin is installed normally, but when I try to add the block to a course I get a blank page and doesn't load that course page any more (I have to uninstall the plugin to do so).

    Help will be appreciated.
  • Picture of Eduardo García Blanco
    Fri, May 23, 2014, 5:21 PM
    Using Moodle 2.7. Instaled block, activated. One user added to course. Course completion atcivated, Activities on the course (Quizzes, Scorm, links and documents), all of them must be marked as completed by user. Cron activated ("Processing cron function for ranking....... No new points to be computed") and block displays "No students to show".
  • avatar
    Sat, May 24, 2014, 4:29 PM
    Does anyone maintains this plugin? It seems to be abandoned. What a shame!
  • Picture of Willian Mano
    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.
  • Picture of Iñigo Zendegi Urzelai
    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:
  • Picture of Thiago Henrique Ornelas Costa
    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!
  • Picture of Juan Lara
    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.
  • Picture of Luis Paulo Justino
    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?
  • Picture of Georg Wiesinger
    Sat, Feb 7, 2015, 1:04 AM
    Hi! Is there any chance to see this nice plugin updated for moodle 2.8?
  • Picture of Willian Mano
    Sat, Feb 7, 2015, 1:42 AM
    Yes, i will upload a new version tomorrow. ;)
1 2
Please login to post comments