Documentation:OpenBadges/Faculty Guide/Toolkit

From UBC Wiki

In Progress This is a sample toolkit, created to test out the toolkit design and workflow.

Introduction

This toolkit will guide you through the process of setting triggers for your badge. Badge triggers are the required steps that you set in order for a participant to earn a badge. These steps can include:

  • The completion of an activity (e.g. quiz, comments, logins, etc.)
  • The number of times the activity must be completed (e.g. 4 comments)
  • The grade or points needed for the badge to be issued (e.g. 80% on Module 1 quiz.)
  • The number of activities completed for the badge to be issued (e.g. 5 quizes, 4 comments and two posts, etc.)

You should already have your badge trigger map from the “Getting Started” toolkit. Your map should reflect the learning pathway you have designed and the type of engagement you expect from the badge earners.

Review:

  • Badge System Design documentation
  • Getting Started toolkit
  • Earning any or a specific badge

Previous: Create your badge [link]

Next: Set Credly Integration [link]

Getting Started

For all badges, you will begin by going to that badge’s Edit page (BadgeOS → Badges → Edit)

Under Achievement Data, go to Earned by. From the drop-down, select Completing steps.

Under Required Steps, click on Add New Steps

Complete the specific steps for each type of trigger as follows.

Trigger: Login to the Site

This guide will show you how to set up a badge trigger, using a login link for badge earners.

Review:

  • Create Login URL on your website

Video guide:


  1. Select Required Step. A drop down menu will appear. Select [UBC] Login to Website. Set the number of required times of login.
  2. Press Save All Steps
  3. From the menu on the right, click Publish

Trigger: Commenting on a Post or Page

This guide will show you how to set up user comments as a badge trigger.

Review:

  • Display Options/Enabling Comments

Video Guide:

Step by Step

  1. Enable comments on posts and pages on your site. Go to: Dashboard>Appearance > Theme Options > Display Options to enable comments.
  2. Return to "Achievement Data" and "Required Steps" under the relevant badge.
  3. Select Comment on a Post Type. After you select the drop down, another drop down menu will appear, which allows you to select from:
  4. Any Post Type - Badge will be awarded if badge earners comment on any posts, pages, Media or achievements. If you want badge earners to earn a badge only in specific post or pages, you can specify post ID . You can see this documentation to learn how to find out the post ID. You can also specify the numbers of comments required to earn the badge.
  5. Pages- Badge will be awarded if badge earners comment on any pages. If you want badge earners to earn a badge only in specific pages, you can specify page ID . You can see this documentation to learn how to find out the page ID. You can also specify the numbers of comments required to earn the badge.
  6. Media - Badge will be awarded if badge earners comment on any media. If you want badge earners to earn a badge only in specific media, You can specify media ID . You can see this documentation to learn how to find out the media ID. You can also specify the numbers of comments required to earn the badge.
  7. Badges - Badge will be awarded if badge earners comment on any badges.
  8. Click Save All Steps
  9. From the menu on the right, click Publish.

Trigger: Creating a New Page or Post

This guide will show you how to make the creation of a new page or post a badge trigger.

Review:

  • Adding users to your Wordpress site.

Video Guide:

  1. Review badge earner permissions
  2. From Required Steps:
  3. Choose Publish a new page if you want to award a badge user when they post a new page. Choose Publish a new post if you want to award a badge user when they post a new post.
  4. If you want to issue badges for posts or pages published in a specific category, create the category (see here [link]) and then select it from the "Any Category" drop-down list.
  5. If you want the badge to be issued after a specific number of new posts or pages, enter a number in the "times" box.
  6. Click Save All Steps
  7. From the menu on the right, click Publish.

Trigger: Completing a Quiz

This guide will show you how to set the completion of a quiz as a badge trigger.

Review:

  • Creating a quiz in LearnDash

Video Guide:

From Required Steps:

  1. Select LearnDash Activity
  2. After you selected LearnDash Activity, you can select the trigger. You can choose from:
    1. Passed Quiz: When a badge earner pass any quiz or a specific quiz, they will earn the badge.
    2. Minimum % Grade on a Quiz: When a badge earner achieves the minimum grade (in a percent %), they will earn the badge. You can set the minimum % of grade.
    3. Fails Quiz: When a badge earner fails the quiz, they will earn the badge.
  3. After you select the trigger, click on Save All Steps.
  4. From the menu on the right, click Publish.

Trigger: Earning Any or a Specific Badge

This guide will show you how to set a badge trigger when a user earners one or more other badges.

Video Guide:

Award a badge when users earn any badge(s) This feature is useful if you want to award a high-level badge. For example: If you earn 3 badges, you get a Community Badges.

  1. Under Required Steps, select Any Achievements of Type from the drop down menu.
  2. From the second drop down menu beside, select Badges. Then type in the number of badges it requires for badge earners to earn the high-level badge.

Award a badge when users earn a specific badge You can also create a step so that badge earner will earn a badge when they have a specific badge. For example, badge earner will earn Community Badges when they earn Subscriber and Contributor badges.

  1. Under Required Steps, select Specific Achievements of Type from the drop down menu.
  2. From the second drop down menu beside, select Badges. Then choose the badge that you will require badge earners to earn the high-level badge.
  3. Click on Save All Steps