=== BadgeOS Community Add-on ===
Contributors: learningtimes, badgeos, credly, asahitechnologies
Donate link: http://badgeos.org/contribute/donate/
Tags: badge, badges, openbadges, credly, OBI, mozilla, open badges, achievement, award, reward, engagement, submission, nomination, buddypress, community, API, open credit, credit, bbpress, plugin
Requires at least: WordPress 3.6.0, BuddyPress 1.7.0 & BadgeOS 1.4.0
Tested up to: 4.3
Stable tag: 1.2.2
License: GNU AGPLv3
License URI: http://www.gnu.org/licenses/agpl-3.0.html

Adds BadgeOS features to BuddyPress and bbPress. Earn badges based on community activity, and display them on user profiles and activity feeds.

== Description ==

The "BadgeOS Community Add-on" integrates BadgeOS features into BuddyPress and bbPress. Site members complete achievements and earn badges based on a range of community activity and triggers. This add-on to BadgeOS also includes the ability to display badges and achievements on user profiles and activity feeds.

**Note:** You will need to install the free [BadgeOS plugin](http://wordpress.org/extend/plugins/badgeos/ "BadgeOS")™ (version 1.2 or higher) to use the BadgeOS Community Add-on. You will also need the [BuddyPress plugin](http://wordpress.org/extend/plugins/buddypress/ "BadgeOS") v1.7 or higher installed.

[Get the BadgeOS plugin](http://wordpress.org/extend/plugins/badgeos/ "BadgeOS").

[BadgeOS](http://badgeos.org "BadgeOS")™ turns your WordPress site into an achievement and badging system. And with BuddyPress enabled on your site, achievements are not only awarded by demonstrating skills and knowledge, but also by participating in community activities. Define the achievements, organize the badge requirements any way you like, and choose from and combine a range of assessment and community activity options to determine whether each task or requirement has been achieved.

Earned badges are Mozilla OBI compatible and sharable via [Credly](https://credly.com/ "Credly.com"), the free web service for recognizing and displaying lifelong achievement.

**New ways to define achievements and give badges for community activity**

In addition to all of the out-of-the-box features in BadgeOS core, this add-on allows you to award badges based on these additional triggers:

*   **Profile Updates:**

   *   Activated Account
   *   Change Profile Avatar
   *   Update Profile information

* **Social Actions:**

   *   Write an Activity Stream message
   *   Write a Group Activity Stream message
   *   Reply to an item in an Activity Stream
   *   Favorite an Activity Stream item
   *   Send a Friendship Request
   *   Accept a Friendship Request
   *   Send/reply to a Private Message

*   **Group Actions:**

   *   Create a Group
   *   Join a Group
   *   Join a Specific Group
   *   Invite Someone to Join a Group
   *   Get Promoted to Group Moderator/Administrator
   *   Promote another Group Member to Group Moderator/Administrator

*   **Discussion Forum Actions:**

   *   Add a New Forum Topic
   *   Reply to a Forum Topic

**Social Display of Badges and Achievements:**

*   Display earned badges and achievements of any kind on user profiles
*   Add activity updates to user Activity Stream when badges and achievements are earned
*   Each user may share his or her earned badges on social networks via Credly

**User and BadgeOS Settings:**

*   BadgeOSadmin setting to select which custom BadgeOS achievement types should be displayed on user profiles
*   BadgeOSadmin setting to select which custom BadgeOS achievement types should be displayed in Activity Streams
*   User can adjust Credly sharing settings from community profile settings

**Combine Community Steps with BadgeOS Steps in Defining Achievements**

*   Simple interface for defining the "Required Steps" for any badge or achievement seamlessly integrates community actions
*   Easily define achievements that rely on both BadgeOS required steps and community actions
*   Easily link together one or more triggers, steps or actions into the conditions needed to earn any badge or mark an achievement.

**Community Badges are Sharable with Credly Integration**

*   As with the BadgeOS core plugin, community badges are Mozilla Open Badge (OBI) compatible through integration of the "Open Credit" API by [Credly](https://credly.com/ "Credly.com"), the free web service for issuing, earning and sharing badges.
*   Badges you create in BadgeOS automatically appear and update on Credly
*   Use Credly iOS app to issue community badges you created on your WordPress/BuddyPress/BadgeOS site.
*   As badges are earned on WordPress/BuddyPress, they can be automatically sent to Credly for easy sharing on Facebook, LinkedIn, Twitter, Mozilla Backpack, the earner's own web site, blog, or Credly profile.

**Filter Submission Lists by BuddyPress Group**
The core BadgeOS Submissions lists can now be filtered by BuddyPress user group. This makes it much easier for administrators to moderate submissions group by group.

This filter compounds with the existing Submission Status and Search filters, making it possible to refine the submission list even further.


= Extensibility and Additional BadgeOS Add-ons =

* BadgeOS is designed to be a true operating system for turning any WordPress site into an engagement management application.
* Built with expandability in mind to allow virtually anything to trigger and recognize achievement.
* BadgeOS plans to continue to release a range of Add-Ons to the plugin -- like the BadgeOS Community Add-on -- that enhance core functionality with specialized functions.
* Check out some of the [BadgeOS customizations](http://badgeos.org/services/badgeos-customization/ "We'll help you customize your BadgeOS site") we've already implemented to get a sense for what you might expect.


= Stay Connected / Helpful Links =

BadgeOS is made available by [LearningTimes, LLC](http://www.learningtimes.com/ "LearningTimes web site"). Here are some ways to stay connected and to see what else we are up to:

* [BadgeOS.org](http://badgeos.org/ "BadgeOS web site") - Contact Us, Video Tutorials, Examples, News
* [LearningTimes](http://www.learningtimes.com "LearningTimes web site") - Producers of online learning events, programs and applications
* [Credly.com](https://credly.com/ "Credly web site") - Issue, manage, share and collect lifelong credentials and digital badges
* [Credly Knowledgebase](http://support.credly.com/ "Credly FAQ and Support") - Credly FAQ
* [Facebook](https://www.facebook.com/Credly "Credly on Facebook") - Credly on Facebook
* [Twitter](https://twitter.com/credly "Credly on Facebook") - Credly Tweets
* [E-Mailing List](https://http://badgeos.org/join-list/ "BadgeOS Occasional Mailing List - No spam!") - Occasional updates via e-mail
* [GitHub](https://github.com/opencredit/badgeos "BadgeOS on GitHub") - Report issues, contribute code


== Installation ==


1. Upload, activate and configure the free [BadgeOS plugin](http://wordpress.org/extend/plugins/badgeos/ "BadgeOS") to WordPress.
2. Upload, activate and configure the free [BuddyPress plugin](http://wordpress.org/extend/plugins/buddypress/ "BadgeOS") to WordPress.
3. Upload 'badgeos-community' to the '/wp-content/plugins/' directory
4. Activate the plugin through the 'Plugins' menu in WordPress
5. Add community action requirements to any new or existing achievement item using the “Earn by” menu for any achievement.
6. Edit “Achievement Types” to select options for display of earned badges in BuddyPress activity feeds and profiles.
7. Ensure that you have entered the Credly credentials for the badge Issuer in the Credly Integration settings of BadgeOS core to enable badge sharing.

== Frequently Asked Questions ==


= Any ideas for making badge images? =

Yes! You can start at [Credly.com](https://credly.com/ "Badge Builder Tool") and use the badge builder there to create beautiful looking badges.

= Can you help us design custom badge images? =

Yes, our designers are available to create custom badges that represent your brand, the kind of achievements you recognize, and the audience you are reaching.  From a single badge to a complete constellation, our team of professional badge designers get to know your needs through a tested Badge Design Process which consistently produces successful and delightful results.

See examples and learn more at: [http://badgeos.org/services/badge-design/](http://badgeos.org/services/badge-design/ "Badge Design")

= Do you offer services to help us design, build or customize our BadgeOS site? =

Yes, we do. We especially enjoy working on innovative projects with forward-thinking teams extending achievement recognition into new environments and surfacing achievement in new ways. See [examples](http://badgeos.org/about/sample-sites/ "Sample pojects") and learn more at: [http://badgeos.org/services/badgeos-customization/](http://badgeos.org/services/badgeos-customization/ "BadgeOS Customization").

= Where should I report issues or bugs? =

The ideal place for bug and issue reporting is on the [GitHub](https://github.com/opencredit/badgeos "BadgeOS on GitHub") site for the BadgeOS project.

= Where should I contribute code back to the project? =

Thanks for asking!  Please do share back code modifications or enhancements you make for inclusion in BadgeOS core or as add-ons. (Functions that are specialized for just some users are likely best as add-on plugins to BadgeOS. We can help figure that out with you.) Visit us on [GitHub](https://github.com/opencredit/badgeos "BadgeOS on GitHub") to share your code with the BadgeOS community.

= Credly is really cool. How can I learn more about it? =

[Credly](https://credly.com/ "Credly web site") is the universal way to recognize, store and share life's achievements. We've integrated Credly into BadgeOS because it's downright the easiest, most fun way to collect evidence of all your achievements in one place and then share them out when and where it matters most. There are a rapidly growing number of platforms and apps that are using the Credly "Open Credit" API to enable sharable badges; the BadgeOS WordPress integration is just one great example! Visit us [Credly.com](https://credly.com "Credly on the Web") to learn more or [contact](https://credly.com/contact "Contact us") us for guidance with using the free Open Credit API in your own projects or applications.


== Screenshots ==

1. "Community Activity" joins multiple other BadgeOS methods for awarding and defining achievements.

2. A wide range of BuddyPress and bbPress actions can be selected as required steps towards the completion of any BadgeOS achievement type.

3. Combine BadgeOS Community Add-On actions with any other BadgeOS assessment requirements to customize the required steps for any badge or achievement.

4. Display select or all earned achievements and badges on the BuddyPress Activity Stream and User Profiles.

5. Earned badges on your BadgeOS Community site are "Open Badges" that are sharable via Credly to virtually any social network, site, blog or the Mozilla Backpack.


== Changelog ==

= 1.2.2 =
Fixed: Add groups_join_specific_group triggers for groups that are by request or invite only.

= 1.2.1 =
* Fixed: Prevent activity list items from being flagged as spam due to too many links.
* Fixed: Hide frontend profile "Send to Credly" checkbox if Credly integration is disabled.
* Fixed: Add checks for BuddyPress or bbPress being enabled before able to enable Community Add-on.
* Fixed: Prevent render issues in Steps UI when BuddyPress isn't activated.
* Fixed: Renamed bagdeos_bp_member_achievements filter to badgeos_bp_member_achievements to fix typo.
* Fixed: Textdomain path should now load translations more accurately.
* Fixed: Changed calls from add_action to add_filter to match hook type.
* Fixed: Pass in trigger, site ID, and args into earned achievement check.
* Fixed: Create our own groups_join_specific_group action to allow for awarding of that available trigger.

= 1.2.0 =
* New: Submission lists can now be filtered by Group ID.
* New: Added filter badgeos_award_achievement_bp_activity_details for altering the BuddyPress activity stream data before insertion.

= 1.1.1 =
* Fixed: Show community triggers when either BadgeOS, BuddyPress or this add-on are activated network-wide.
* Updated: Show Achievements menu in BuddyPress profile even if no achievements have been earned on a single network site.

= 1.1.0 =
* New: Show all achievements from across a multisite network in member profile

= 1.0.2 =
* Fix: Fixed bug that prevented unlocking achievements attached to unlocked steps.
* Fix: Check if group component is turned on before querying groups.

= 1.0.1 =
* New: Added .po and .mo files for internationalization
* Updated: Check for BadgeOS version 1.0.2 or higher before activating plugin.
* Fix: Stomped out a bug that prevented certain community triggers from unlocking steps

= 1.0 =
* BadgeOS Community Add-on says "hello buddy", earns "Hello Buddy" badge.


== Upgrade Notice ==

= 1.2.2 =
Fixed: Add groups_join_specific_group triggers for groups that are by request or invite only.

= 1.2.1 =
* Fixed: Prevent activity list items from being flagged as spam due to too many links.
* Fixed: Hide frontend profile "Send to Credly" checkbox if Credly integration is disabled.
* Fixed: Add checks for BuddyPress or bbPress being enabled before able to enable Community Add-on.
* Fixed: Prevent render issues in Steps UI when BuddyPress isn't activated.
* Fixed: Renamed bagdeos_bp_member_achievements filter to badgeos_bp_member_achievements to fix typo.
* Fixed: Textdomain path should now load translations more accurately.
* Fixed: Changed calls from add_action to add_filter to match hook type.
* Fixed: Pass in trigger, site ID, and args into earned achievement check.
* Fixed: Create our own groups_join_specific_group action to allow for awarding of that available trigger.

= 1.2.0 =
* New: Submission lists can now be filtered by Group ID.
* New: Added filter badgeos_award_achievement_bp_activity_details for altering the BuddyPress activity stream data before insertion.

= 1.1.1 =
* Fixed: Show community triggers when either BadgeOS, BuddyPress or this add-on are activated network-wide.
* Updated: Show Achievements menu in BuddyPress profile even if no achievements have been earned on a single network site.

= 1.1.0 =
* New: Show all achievements from across a multisite network in member profile

= 1.0.2 =
* Fix: Fixed bug that prevented unlocking achievements attached to unlocked steps.
* Fix: Check if group component is turned on before querying groups.

= 1.0.1 =
* New: Added .po and .mo files for internationalization
* Updated: Check for BadgeOS version 1.0.2 or higher before activating plugin.
* Fix: Stomped out a bug that prevented certain community triggers from unlocking steps

= 1.0 =
* Initial release