Blocks: Level up!
Frédéric Massart
Our website dedicated to Level up! is here.
Please support this plugin: add it to your favourites, star it on GitHub, or purchase the add-on!
What's new?
Level up! is GDPR ready and conforms with the API requirements recently added to Moodle (requires Moodle 3.3.5, Moodle 3.4.2 or greater).
Moodle Mobile app support is available for Moodle 3.1 and greater through Level up! Plus.
Feature request and bug reports
Please report the issues you find, problems you experience or any feature request on the issue tracker. Thanks!
Features
- Automatically attributes points to students for their actions
- Block that displays current level and progress towards next level
- Report for teachers to get an overview of their students' levels
- Notifications to congratulate students as they level up
- A leaderboard to display the ranking of the students
- Ability to customise the number of levels, the points they require and their appearance
- Total control over the points earned per action
- Unlock content when a certain level is reached
- Experience points earned per course, or for the entire site
- Support for shortcodes to include in content
Level up ! Plus add-on features
Purchasing the Level up! Plus add-on unlocks these features:
- Mobile app support
- Activity completion support
- Course completion support
- Resilient cheat guard
- Limit learners rewards in time frame
- Additional default level badges
- Substitute experience points for other symbols
- Download the report
- Email support
Visit our website for more information on Level up! Plus.
How are experience points calculated?
This block listens to events triggered in Moodle and captures some according to pre-defined rules. It then attributes experience points based on the information contained in the event. For more information about the events, refer to the documentation.
Only the users with the capability block/xp:earnxp can earn experience points. This capability is given by default to students. Also, actions triggered by guests, non-logged in users or administrators are ignored.
The following events are always ignored:
- Events from another context than course or module
- Events having another educational level than participating
- Events flagged as anonymous, e.g. in an anonymous Feedback
The rest is up to you. By default, the plugin comes with a minimal set of rules to attribute experience points to actions, and to ignore some redundant ones. Visit the Rules page in the plugin itself to view or override them.
Note: Repeated actions within a short time interval are ignored to prevent cheating.
How to use one block for all courses?
In order to gather experience points from all the courses a student is participating in, you have to set the admin setting Where are experience points used? to 'For the whole site'. This setting is located under "Site administration > Plugins > Blocks > Level up! > General settings". Once set, any block newly or previously added will display the total experience points of your students.
How to unlock content at a certain level?
Use the availability plugin: Level up! Availability.
How to unlock a course at a certain level?
Use the enrolment plugin: Level up! Enrolment.
Shortcodes supported
What are those? Shortcodes can be used in editors throughout Moodle to include or modify the content. The plugin Shortcodes must be installed to enable them.
xpbadge
Displays the badge matching the level of current user.
[xpbadge]
xpiflevel
Displays the content within its brackets according to the user's level. When a level is stricly specified, the content will be displayed regardless of the other rules. The greater and less than rules must all match for the content to be displayed, watch out as that may sometimes result in the content to never be displayed! Note that teachers, or otherwise users with editing capabilities, will always see everything.
[xpiflevel 1 3 5]
Displayed if the user's level is exactly 1, 3 or 5.
[/xpiflevel]
[xpiflevel >3]
Displayed if the user's level is greater than 3.
[/xpiflevel]
[xpiflevel >=3]
Displayed if the user's level is greater or equal to 3.
[/xpiflevel]
[xpiflevel >=10 <20 30]
Displayed if the user's level is greater or equal to 10 AND is strictly less than 20
OR is exactly equal to 30.
[/xpiflevel]
[xpiflevel <=10 >=20]
Never displayed because the user's level can never be less or equal to 10 AND more or equal to 20.
[/xpiflevel]
Note that these shortcodes CANNOT be nested within one another.
xpprogressbar
Displays the current user's progress bar towards the next level.
xpprogressbar
Provided by
Sets
Useful links
Screenshots
I would like to change the avatar in animation (.gif) but the upload function is not support this file type. Could you please suggest?
Thank you.
i.e. you get 10 xp for adding a wiki page, but the max is 40, so you can only add 4 wiki pages.
Onno
I am trying this plugin on Moodle 3.4.2 installed on windows and the database is MSSQL.
I added the block to a course and when pressing any link including ladder and settings I got the below error
Coding error detected, it must be fixed by a programmer: Controller for route not found.
More information about this error
×Debug info:
Error code: codingerror
×Stack trace:
line 95 of \blocks\xp\classes\local\routing\router.php: coding_exception thrown
line 79 of \blocks\xp\classes\local\routing\router.php: call to block_xp\local\routing\router->get_controller_from_request()
line 38 of \blocks\xp\index.php: call to block_xp\local\routing\router->dispatch()
This must be caused by a misconfiguration of nginx, please refer to the following thread: https://github.com/FMCorz/moodle-block_xp/issues/79
Cheers,
Fred
Thank you for your response, I will follow up the link and will update you,
I followed the URL but I can't see any guides for windows and IIS, do you have a direct link on how to apply this in windows and IIS?
I had applied the URL rewrite rule and restarted the IIS, but still having the same error.
a screenshot of what I did here https://taifedusa-my.sharepoint.com/:i:/g/personal/matia_tu_edu_sa/EbifsmWODXJJnFqICuKzDUIBp12uK1hbya0wJZtiFuDANQ?e=MiGjs3
any Idea how to troubleshoot this?
I created a new rewrite rule you can check it here https://1drv.ms/u/s!Amdk-vbboLpgh0qcGTN2p81i8R60 and I also made a test pattern shown in the screenshot is that the expected values for the rewrite?
It is now working fine for me
the pattern should be ^(blocks\/xp\/[^\?]+?\.php)(\/.+)$
and the rewrite URL should be {R:1}?_r={R:2}
screenshot below show the correct rule for the workaround
https://1drv.ms/u/s!Amdk-vbboLpgh0taTJqtwiOcaXFE
Thank you for your help
this rewrite {R:1}\?_r={R:2} is not correct