.. include:: /shortcuts.rstext .. index:: single: OpenBadges .. _badges: Open Badges ------------- `Open Badges `_ is `Mozilla `_'s open source answer for showing recognition of skills and competencies online. `Moodle 2.5 `_ became a badge issuer in May 2013 and Mahara will become a badge displayer in the future. For the time being, however, there are two ways of displaying your Open Badges: #. Have the plugin `Open Badge Displayer `_ installed (available since 8 August 2013). #. Use an iframe. This method is not recommended any longer as there is no verification of the email address and you could essentially display someone else's badges. .. seealso:: This tip was first published in the blog post "`Open Badges in Mahara: The quick way `_" by `Kristina D.C. Hoeppner `_. Create a collection of badges ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ #. Go to your `Mozilla Backpack `_. You must have already pushed at least one badge to it to complete the following steps. .. note:: You will need to create a Persona account in order to use the Mozilla Backpack. Increasingly, you can connect with Persona to websites. You can also use it as :ref:`authentication method ` in Mahara. #. Click the *Collection* navigation item to enter your badge collection area. #. Drag one of your badges onto a (new) collection space. .. figure:: /images/tips/badges_collection_drag.* :alt: Drag a badge onto a new collection space Drag a badge onto a new collection space #. Give your new collection a title by clicking onto "New collection" and typing your title. #. Tick the check box *public* so others can see your badges. #. Click the *Share* icon. You will be taken to a page where you can see all the badges in the collection that you created. .. figure:: /images/tips/badges_collection_new.* :alt: Create a new collection Create a new collection Select the badge collection in Mahara ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: Follow this section if you have the `Open Badge Displayer `_ plugin installed. .. figure:: /images/tips/badges_block.* :alt: Choose the Open Badges block Choose the Open Badges block .. figure:: /images/tips/badges_configure.* :alt: Configure the Open Badges block Configure the Open Badges block #. Create a page in your portfolio or edit an existing portfolio page where you want to display your badge collection. #. Drag the *Open Badges* block onto your page. This block is only available when you have the plugin installed. #. **Block title**: Choose a title for your block. #. Select the badge collection that you want to display. #. **Retractable**: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the *Retractable* icon |retractable| to just show the heading. #. **Automatically retract**: Tick this checkbox if you want to show only the block's heading when a user views the page. The user can click the *Retracted* icon |retracted| to view the entire block. #. Click the *Save* button to accept your changes, or click the *Cancel* button to leave the block's content as it is. The *Remove* button is shown only when you place the block into the page for the first time. #. You can also click the *Close* button |close| in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is. .. note:: If you do not have the "Open Badge Displayer" plugin installed, you can follow these next steps. Generate an iframe for your badge collection ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ #. Copy the URL of your public collection. #. Create an iframe around it so you can embed it into a Mahara page. .. seealso:: You can use the `Online iFrame generator `_ for example to create your iFrame easily. Or you can copy this iframe code and replace the URL with your own. ```` #. Copy the entire iframe code. Embed your badge collection in a Mahara page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ #. Create a page in your portfolio and :ref:`set the layout to 1 column `. .. note:: For the next steps to work, your site administrator must have added ``backpack.openbadges.org/share`` to the :ref:`list of allowed iFrame sources `. If this URL changes, your site administrator will have to correct it so your badges can still be displayed. Once other badges backpacks become available, each will need to be added as allowed iframe if you store badges there. #. Drag the *External content* block onto your page. #. Paste your iframe into the *URL or embed code* field. #. Give your block a title. #. Save your changes. Your badge collection is now embedded in your page.