Difference between revisions of "Using badges"

Jump to: navigation, search
m (Adding a course badge)
(adding information)
Line 7: Line 7:
 
==Adding a course badge==
 
==Adding a course badge==
 
*If course badges have been enabled in ''Administration>Site administration>Badges>Badges'' settings then a teacher can add badges from ''Administration>Course administration>Badges>Add a new badge''
 
*If course badges have been enabled in ''Administration>Site administration>Badges>Badges'' settings then a teacher can add badges from ''Administration>Course administration>Badges>Add a new badge''
 +
===Badge details===
 +
Add a name and description and upload your badge here.
 +
===Issuer details===
 +
If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.
 +
===Badge expiry===
 +
Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.
 +
 +
{|
 +
|[[File:firstaiderbadge.png|thumb|Adding a course badge]]
 +
|}
 +
 +
*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge.
 +
*For course badges, the criteria are: Manual completion by role; course completion and activity completion.
 +
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
 +
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.
 +
 +
{|
 +
|[[File:coursebadgecriteria.png|thumb|Choosing criteria for the badge]]
 +
|[[File:Badge_criteria2.png|thumb|Manual issue by role]]
 +
|}
 +
 +
  
 
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.
 
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.
Line 12: Line 34:
 
[[File:Badge criteria.png||border]]
 
[[File:Badge criteria.png||border]]
  
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.
 
  
[[File:Badge add criterion.png]]
 
  
 
After criterion is set and added, it will be displayed among current badge criteria.
 
After criterion is set and added, it will be displayed among current badge criteria.

Revision as of 09:54, 23 April 2013


WORK IN PROGRESS

This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see Managing badges.

Adding a course badge

  • If course badges have been enabled in Administration>Site administration>Badges>Badges settings then a teacher can add badges from Administration>Course administration>Badges>Add a new badge

Badge details

Add a name and description and upload your badge here.

Issuer details

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

Badge expiry

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

Adding a course badge
  • When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge.
  • For course badges, the criteria are: Manual completion by role; course completion and activity completion.
  • When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
  • For badges to be awarded for course or activity completion, Completion tracking must be enabled in the site and the course.
Choosing criteria for the badge
Manual issue by role


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


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).
  • 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.

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

Enabling badge access
Earning 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.

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.