Note: You are currently viewing documentation for Moodle 3.6. Up-to-date documentation for the latest stable version of Moodle is likely available here: Managing badges.

Managing badges: Difference between revisions

From MoodleDocs
(Earning badges - content transferred from https://docs.moodle.org/dev/OpenBadges_User_Documentation)
Line 40: Line 40:
'''Only badges with enabled access are available to users and can be earned!'''
'''Only badges with enabled access are available to users and can be earned!'''


[[File:7 activate.png]]
[[File:Badge enable access.png]]


Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.
Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.


[[File:11_email.png||border]]
[[File:Earning a badge.png||border]]


Badges that have manual award among their criteria can be issued by one user to another. Users who issue a badge must have "moodle/badges:awardbadge" capability. Site administrators can choose their role when issuing a badge.
Badges that have manual award among their criteria can be issued by one user to another. Users who issue a badge must have "moodle/badges:awardbadge" capability. Site administrators can choose their role when issuing a badge.


[[File:10_award.png]]
[[File:Badge_recipients2.png]]


'''Important Note''': Currently once a badge has been issued it cannot be revoked. So make sure that you are giving a badge to the correct users.
'''Important Note''': Currently once a badge has been issued it cannot be revoked. So make sure that you are giving a badge to the correct users.

Revision as of 20:11, 15 April 2013

On "Manage badges" page in course or site administration, all existing badges are displayed in a table showing current badge image, name, status, criteria, how many users have already earned this badge and a set of available actions.

Managing badges.png

Depending on user role and permissions, the following actions are available in badge management:

Badge actions.png

Note: Availability of enable and disable access actions depends on the current status of a badge (e.g. if a badge is available to users, "disable access" icon will be shown).

Before a badge has been issued to at least one user, all its details and settings can be edited. Use "Edit badge" action icon to access badge editing options.

To set up badge criteria, navigate to "Criteria" tab and select a required option. Criteria are added one at a time with additional options available for each criteria.

Badge criteria.png

For example, when a user selects "Manual issue by a role" requirement, they will be prompted to select which roles can award the badge and what rules apply to this requirement.

Badge add criterion.png

After criterion is set and added, it will be displayed among current badge criteria.

Badge criteria2.png

To edit a body and subject of a message which users get upon earning the badge, go to "Message" tab.

Among additional options here are "Attach badge to message" which allows adding an image file to an email and "Notify badge creator" selector which allows to set frequency of notifications sent to badge creator when this badge is issued to users.

Badge message.png

"Recipients" tab displays a list of users who have already earned this badges.

Badge recipients.png

Earning badges

Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

Only badges with enabled access are available to users and can be earned!

Badge enable access.png

Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

Earning a badge.png

Badges that have manual award among their criteria can be issued by one user to another. Users who issue a badge must have "moodle/badges:awardbadge" capability. Site administrators can choose their role when issuing a badge.

Badge recipients2.png

Important Note: Currently once a badge has been issued it cannot be revoked. So make sure that you are giving a badge to the correct users.