Backpacks: Difference between revisions

From MoodleDocs
(removing note about active external backpack as it's not needed in 3.11, removing section for sites upgrading from 3.5 or 3.6)
(Connecting to an OB v 2.1 compliant backpack)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Badges}}
{{Badges}}
Enabling users to connect to an external backpack means they can add badges from their Moodle site to their backpack and also display badges from other sites in their Moodle profile.
Enabling users to connect to an external backpack means they can add badges from their Moodle site to their backpack and also display badges from other sites in their Moodle profile.
 
[[File:ManageBackPacks.png|thumb|Manage backpacks]]
==Site administration settings==
==Site administration settings==
The backpack badgr.io is provided by default. Admins can add additional backpacks, for users with an account on eu.badgr.io, ca.badgr.io or au.badgr.io.


The backpack badgr.io is provided by default. Additional backpacks, for users with an account on eu.badgr.io, ca.badgr.io or au.badgr.io, may be added as follows:
For example, to add the eu.badgr.io follow the steps:
 
# Go to Site administration / Badges / Manage backpacks.
# Go to Site administration / Badges / Manage backpacks.
# Click the button 'Add a new backpack'.
# Click the button 'Add a new backpack'.
# Create this backpack with the following details:
# Create this backpack with the following details:
#* Backpack API URL - https://api.eu.badgr.io/v2
#* Backpack API URL - https://api.eu.badgr.io/v2  
#* Backpack URL - https://eu.badgr.io
#* Backpack URL - https://eu.badgr.io
#* API version - Open Badges v2.0
#* API version - Open Badges v2.0
#* (Leave 'Include authentication details with the backpack' unticked.)
#* (Leave 'Include authentication details with the backpack' unticked.)
Follow the same process for ca.badgr.io and au.badgr.io changing only the region letters (the ''eu'' in the above URLs to ''ca'' or ''au'').


Note the admin can set the order in which backpacks are listed for users.
==Individual user settings==
==Individual user settings==
You can connect to your backpack as follows:
You can connect to your backpack as follows:
# In the user menu (top right), select Preferences, then 'Backpack settings' under Badges.
# In the user menu (top right), select Preferences, then 'Backpack settings' under Badges.
# If necessary, select your backpack provider.
# If necessary, select your backpack provider.
# Enter your Badgr user account email and password.
# Enter your Badgr user account email and password.
# Look in your mailbox for a verification email and copy and paste the link to verify your connection to the backpack.
# Look in your mailbox for a verification email and copy and paste the link to verify your connection to the backpack.
After the backpack connection is successfully established, badges from your backpack can be displayed on your badges page and your profile page. Go to Manage badges (via Preferences / Badges) and click the icon to add your badge to your backpack.
After the backpack connection is successfully established, badges from your backpack can be displayed on your badges page and your profile page. Go to Manage badges (via Preferences / Badges) and click the icon to add your badge to your backpack.


You can also select collections of badges from your backpack that you would like to display in your profile.
You can also select collections of badges from your backpack that you would like to display in your profile.
==Open Badges v 2.1==
Moodle is Open Badges v 2.1 compliant and a new [[OAuth 2 Open Badges service]] enables users to connect to their OB v 2.1 compliant backpack without having to enter their credentials into Moodle.
To connect to an OB v 2.1 compliant backpack such as badgr.com
# Go to Site administration / Badges / Manage backpacks.
# Click the button 'Add a new backpack'.
# Create this backpack with the following details:
#* API version - Open Badges v2.1
#* Backpack URL - https://badgr.com
When you connect to an OB v 2.1 compliant backpack, a Badges service in [[OAuth 2 services]] is created automatically.


[[es:Mochilas]]
[[es:Mochilas]]
[[de:Backpacks]]

Latest revision as of 07:25, 19 June 2023

Enabling users to connect to an external backpack means they can add badges from their Moodle site to their backpack and also display badges from other sites in their Moodle profile.

Manage backpacks

Site administration settings

The backpack badgr.io is provided by default. Admins can add additional backpacks, for users with an account on eu.badgr.io, ca.badgr.io or au.badgr.io.

For example, to add the eu.badgr.io follow the steps:

  1. Go to Site administration / Badges / Manage backpacks.
  2. Click the button 'Add a new backpack'.
  3. Create this backpack with the following details:

Follow the same process for ca.badgr.io and au.badgr.io changing only the region letters (the eu in the above URLs to ca or au).

Note the admin can set the order in which backpacks are listed for users.

Individual user settings

You can connect to your backpack as follows:

  1. In the user menu (top right), select Preferences, then 'Backpack settings' under Badges.
  2. If necessary, select your backpack provider.
  3. Enter your Badgr user account email and password.
  4. Look in your mailbox for a verification email and copy and paste the link to verify your connection to the backpack.

After the backpack connection is successfully established, badges from your backpack can be displayed on your badges page and your profile page. Go to Manage badges (via Preferences / Badges) and click the icon to add your badge to your backpack.

You can also select collections of badges from your backpack that you would like to display in your profile.

Open Badges v 2.1

Moodle is Open Badges v 2.1 compliant and a new OAuth 2 Open Badges service enables users to connect to their OB v 2.1 compliant backpack without having to enter their credentials into Moodle.

To connect to an OB v 2.1 compliant backpack such as badgr.com

  1. Go to Site administration / Badges / Manage backpacks.
  2. Click the button 'Add a new backpack'.
  3. Create this backpack with the following details:

When you connect to an OB v 2.1 compliant backpack, a Badges service in OAuth 2 services is created automatically.