forked from opencredit/badgeos
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
530 lines (416 loc) · 38.4 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
=== BadgeOS ===
Contributors: badgeos, learningtimes, credly, webdevstudios, williamsba1, rzen, jtsternberg, ryanduff, Messenlehner, LisaSabinWilson, tw2113
Donate link: http://badgeos.org/contribute/donate/
Tags: badge, badges, openbadges, learningtimes, credly, OBI, mozilla, open badges, achievement, award, reward, engagement, submission, nomination, API, open credit, credit
Requires at least: 3.6
Tested up to: 4.1
Stable tag: 1.4.4
License: GNU AGPLv3
License URI: http://www.gnu.org/licenses/agpl-3.0.html
BadgeOS turns your site into an achievement and badging system. Easily create badges and set up the steps and achievements users complete to earn them.
== Description ==
[BadgeOS](http://badgeos.org "BadgeOS")™ turns your WordPress site into an achievement, badging and engagement management system. Your users complete steps, demonstrate skills and knowledge, and earn digital badges. Easily define the achievements, organize the badge requirements any way you like, and choose from and combine a range of assessment options to determine whether each task or requirement has been achieved.
Create badges and set up the achievements to earn them. Badges are Mozilla OBI compatible and sharable via [Credly](https://credly.com/ "Credly.com"), the free web service for managing and displaying lifelong credentials.
BadgeOS is extremely powerful and infinitely extensible. Check out some of the out-of-the-box features:
**Many ways to define achievements and give badges**
* Reviewed submissions
* Auto-approving submissions
* Nominations and review
* Site activity (triggers based on publising posts and pages, commenting and logging in to your site)
* Completing specific other achievements one or a specific number of times
* Completing one, select or all achievements of a specific type
* Point thresholds
* Admin Given Badges
* Community Activity (with the powerful [BadgeOS Community Add-on](http://wordpress.org/extend/plugins/badgeos-community-add-on/ "BadgeOS Community Add-on"))
* Activity from other popular WordPress plugins. See growing catalog of [BadgeOS Add-ons](http://badgeos.org/add-ons/ "BadgeOS Add-ons").
**Define an Unlimited Number of Achievement Types**
* Create as many types of achievement as you like
* Name achievement types whatever you wish
* Easily define how they relate to one another using the 'Required Steps' tool
* Set default images for each achievement type or select unique images for every achievement item
**Design Beautiful Badge and Achievement Images from within WordPress**
* Use the integrated Credly "[Badge Builder](https://credly.com/badge-builder-home "Credly tool for designing badge images")" to create professional looking badge images right from within WordPress
* Launch the Badge Builder from any achievement or achievement type editing screen in WordPress admin
* Choose from a variety of badge shapes and border styles
* Select from a library of thousands of Noun Project icons, or upload your own to the center of any badge
* Add or remove a banner with text to your badge
* Full color palette selection for border, fill, icon and banner
* Saves automatically to your WordPress Media Library for easy re-use for other achievements or anywhere else on your site
* Edit previously created badge and achievement images and save new versions to your Media Library
* Simply enter your Credly credentials in the "Credly Integration" settings menu in BadgeOS to enable the Badge Builder. If you don't have a [Credly](https://credly.com/ "Credly lets you create and manage lifelong achievements") account, [create](https://credly.com/#!/create-account "Create a free Credly account") one for free.
**Sharable Badges with Credly Integration**
* Badges are Mozilla Open Badge (OBI) compatible through [integration](http://badgeos.org/about/credly-integration/ "Credly Integration") of the "Open Credit" API by [Credly](https://credly.com/ "Credly.com"), the free web service for issuing, earning and sharing badges.
* Connect your Credly account to your BadgeOS site and voila! You're using WordPress to issue "Open Badges" that can be displayed virtually anywhere.
* Badges you create in BadgeOS automatically appear and update on Credly
* Use Credly iOS app to issue badges you created on your WordPress site.
* As badges are earned on WordPress, 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.
**'Required Steps' Manager**
* Simple yet powerful admin interface for defining the "Required Steps" for any badge or achievement.
* Easily link together one or more triggers, steps or actions into the conditions needed to earn a badge or mark an achievement.
* Extend the Required Steps options using the free [BadgeOS Community Add-on](http://wordpress.org/extend/plugins/badgeos-community-add-on/ "BadgeOS Community Add-on").
* Also extend Required Steps with other [BadgeOS Add-ons](http://badgeos.org/add-ons "BadgeOS Add-ons").
**Reward User Progress**
* Issue badges for any combination of achievements
* Award points for commenting, logging in, making submissions, completing any combination of tasks
* Display a congratulatory message, customizable per Achievement, on each achievement page.
**View and Issue your BadgeOS badges via iOS Mobile App**
* Badges created in BadgeOS are immediately available on the Credly iOS mobile app (with free Credly integration enabled).
* Create badges in WordPress, and then issue them from your iPhone!
* BadgeOS badge earners can receive, accept, view and share their badges from the iOS app (with their profile set to receive badges via Credly).
* Credly app's "ID Card" view essentially turns a BadgeOS badge into an "access pass" for face-to-face activities.
**Earned Achievements Widget**
* Shows logged in users what badges they have earned.
* Option to choose which specific achievement types to display in the widget.
* Set the parameters for the widget to decide how many recent badges to display.
* Option to show logged in users total points they have earned (if you are using BadgeOS points mechanism).
* Members can share their badges right from the widget to their Credly profile and off to their linked social networks or Mozilla Backpack.
**Theme Agnostic, Shortcodes and Shortcode Embedder**
* BadgeOS works with just about any standard WordPress theme.
* No special hooks or theme updates are needed.
* Turn any page or post into a way to display available achievements and for users to track their progress.
* Multiple options and parameters for each shortcode for great flexibility.
* Shortcode WYSIWYG embedder - appears in the toolbar of all WordPress content editor areas, allowing you to transform any page or post into part of your achievement system -- without referencing any of the shortcodes.
* Shortcodes to bring submission and nomination review to the front-end of your site.
* Shortcode to integrate specific available achievements into any post or page of your site.
* Shortcode for Credly "[Custom Assertion Location](http://blog.credly.com/custom-assertion-location/ "Credly Custom Redirection")" for displaying badges issued by Credly Pro users on your site
* [Shortcode documentation](http://badgeos.org/support/shortcodes/ "BadgeOS Shortcodes") in the plugin menu and on BadgeOS.org.
* Just activate BadgeOS and place simple shortcodes on any page or post, and you've got an engagement management system running on your WordPress site!
**Submission and Nomination Review**
* Easily review submissions and nominations from members.
* Approve or deny submissions with one click.
* Shortcodes with multiple options for review of submissions on any page or post on your site.
* Powerful shortcodes to add an achievement submission or nomination form to any post or page.
* Add comments to engage the member and elaborate on your decisions.
* Optional notification emails inform you when people on your site have made submissions or nominated peers.
* Submission Notification Settings: Specify an unlimited number of email addresses for submission admin notifications.
* Notifications for: new submissions, new comments, and submission status changes
* Filter Submissions to only show those from members of specific BuddyPress Groups (requires plugins: [BuddyPress](http://wordpress.org/extend/plugins/buddypress/ "BuddyPress") and [BadgeOS Community Add-on](http://wordpress.org/extend/plugins/badgeos-community-add-on/ "BadgeOS Community Add-on"))
= Extensibility and BadgeOS Add-ons =
* BadgeOS is designed to be a true operating system for turning any WordPress site into an engagement management application.
* BadgeOS offers a growing catalog of [Add-ons](http://badgeos.org/add-ons/ "BadgeOS Add-ons") to the plugin that enhance core functionality with specialized functions.
* Built with expandability in mind to allow virtually anything to trigger and recognize achievement.
* 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 is possible with BadgeOS.
* [Developer Documentation and APIs](http://badgeos.org/developers/ "BadgeOS Developer Resources") are freely available. [Share your own BadgeOS add-ons](http://badgeos.org/developers/share "Share Your BadgeOS Add-Ons") with the community today.
= 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") - Online learning programs, development and expertise
* [Credly.com](https://credly.com/ "Credly web site") - Manage lifelong credentials that matter
* [BadgeOS Developer Resources](http://badgeos.org/developers "BadgeOS Developer Docs and APIs") - Open documentation, APIs and resources for BadgeOS developers.
* [Credly Knowledgebase](http://support.credly.com/ "Credly FAQ and Support") - Credly FAQ
* [Facebook](https://www.facebook.com/Credly "Credly on Facebook") - BadgeOS and Credly on Facebook
* [Twitter](https://twitter.com/credly "Credly on Facebook") - BadgeOS and Credly Tweets
* [E-Mailing List](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
= Developer Documentation: =
BadgeOS is built with expandability in mind to allow virtually anything to trigger and recognize achievement. The [Developer Resources](http://badgeos.org/developers/ "BadgeOS Developers") area of the BadgeOS site provides links to documentation, APIs and guides to extending BadgeOS and integrating it with other plugins and systems. [Share](http://badgeos.org/developers/share/ "Share Yoru Plugins and Add-Ons") your BadgeOS Add-Ons and BadgeOS-compatible plugins.
Want to contribute to BadgeOS core? That's great! Visit our [GitHub site for the project at](https://github.com/opencredit/badgeos/tree/master#contributing "BadgeOS on GitHub").
= License Info =
LearningTimes, LLC licenses BadgeOS to you under the terms of the GNU Affero General Public License, version 3, as published by the Free Software Foundation.
There is NO WARRANTY for this software, express or implied, including the implied warranties of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License, version 3, at [http://www.gnu.org/licenses/agpl-3.0.html](http://www.gnu.org/licenses/agpl-3.0.html "License") for more details.
== Installation ==
1. Upload 'badgeos' to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Visit the BadgeOS menu to add Badges and set up new Achievement Types.
4. Enter Credly credentials for the badge Issuer in the Credly Integration settings to enable the free Credly Badge Builder and badge sharing. (First get a [free account](https://credly.com/#!/create-account "Create a free Credly account") at Credly.com if you do not have one.)
5. Use the BadgeOS Shortcode button available from any content editor in our site to turn any page or post into a part of your achievement or engagement system. For example, add lists of badges or other achievements, submission lists, a single badge and much more. Visit the Help/Support section of the BadgeOS menu for more information on available shortcodes.
6. See video tutorials about BadgeOS at: [http://badgeos.org/support/tutorials/](http://badgeos.org/support/tutorials/ "BadgeOS Tutorials")
== Frequently Asked Questions ==
= Any ideas for making badge images? =
Yes! After installing BadgeOS, enable Credly Integration in the BadgeOS menu. That will seamlessly integrate the Credly "[Badge Builder](https://credly.com/badge-builder-home "Credly tool for designing badge images")" into your WordPress site so you can design your own professional-looking badge images. (First get a [free account](https://credly.com/#!/create-account "Create a free Credly account") at Credly.com if you do not have one.)
= 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. Example of multiple methods for awarding and defining achievements
2. Use BadgeOS to create an unlimited number of achievement types, and easily define how they relate to one another.
3. Earned badges on your BadgeOS site are "Open Badges" that are sharable via Credly to virtually any social network, site, blog or the Mozilla Backpack.
4. Use the integrated Credly Badge Builder to easily create beautiful badge images right from within WordPress. Launch the Badge Builder from any achievement or achievement type editing screen.
5. Choose from a variety of badge shapes and border styles, and adjust the colors of each element.
6. Select from a library of thousands of Noun Project icons, or upload your own to the center of any badge.
7. BadgeOS gives you a simple yet powerful admin interface for defining the "Required Steps" for any badge or achievement.
8. BadgeOS shortcodes make it easy to turn any WordPress page into an achievements page, regardless of the theme you are using.
9. Use the "BadgeOS Shortcode" button available in any WordPress content area to easily configure and insert a shortcode for any BadgeOS component. With just a click or two, you can add custom, dynamic achievement elements (such as lists of badges or other achievements, submission review pages, submission forms, or individual achievements) anywhere on your site.
== Changelog ==
= 1.4.4 =
* Improved checks to prevent achievement type switching when editing achievement types.
* Added a check to ensure multisite is active before calling multisite functions.
* Added internationalization strings and updated pot file.
* Inline documentation improvements.
= 1.4.3 =
* Fix issue with user scores being zero'd out when they save their profile in WP Admin.
* Added French translation files. Credit: http://extremraym.com
* Made it possible for admins to award achievements, that can be earned multiple times, to users via the User's admin profile
* Misc code tweaks.
= 1.4.2 =
* Updated: Achievement Types now support menu ordering.
* Fixed: Eliminated a fatal error in the nomination saving process.
* Fixed: Updated submission manager role setting to correctly show the selected value.
* Fixed: Additional hardening for achievement-type migration so that it doesn't happen prematurely due to autosave.
= 1.4.1 =
* Fixed: Eliminated a critical bug that could cause all posts to be migrated to a brand new achievement type on publish.
= 1.4.0 =
* Added: BadgeOS Shortcode Embedder – Easily add any shortcode to any content area with a few clicks.
* Added: BadgeOS Shortcode registration API – Easily add support for new BadgeOS-related shortcodes and modify existing shortcodes with automatic support for the BOS Shortcode Embedder and help page.
* Added: Submission Manager Role selector – allow users to moderate submissions without granting them full access to BadgeOS administration.
* Added: Submission Notification Admin Settings – Specify an unlimited number of email addresses in a comma-separated list for submission admin notifications.
* Added: Submission Notifications to users who have made a submission.
* Added: Several new submission notification types - new submission, new comment, and submission status change
* Added: User Email Notification Setting - Users can opt-out of email notifications in the profile editor.
* Added: Trigger for commenting on specific posts.
* Added: Many hooks for modifying shortcodes, submission lists, and more.
* Added: Baseline support for renaming achievement types, including the auto-migrating all achievements (and user earnings) from original achievement type to the new.
* Added: Helper functions for checking if user meets BOS management roles.
* Updated: Revised trigger for commenting on posts to only award when comment is approved.
* Updated: Submission status can now be altered on the front-end from approved to denied or back again.
* Updated: Admin area for editing a submission now uses the same approve/deny buttons as the rest of the site.
* Updated: Submission Lists are now highly customizable via WP hooks. The search input, filter inputs, and even the results can be altered programatically.
* Updated: Many, many internationalization enhancements. Help us release BadgeOS in your language!
* Updated: BadgeOS management role selector is hidden on the settings page to non-admins.
* Updated: Badgeos management role selector now excludes contributor and subscriber roles.
* Fixed: Rewrite rules automatically flush when a new achievement type is added (or an existing is renamed).
* Fixed: BadgeOS settings can now be modified by the minimum selected management role.
* Fixed: Prevent users from repeatedly earning auto-approved submissions.
* Fixed: Submissions List status filter now indicates the displayed status on page load.
* Fixed: Lots of other minor bugs.
= 1.3.5 =
* Fixed: Eliminated an error when attempting to use Credly Badge Builder over SSL
* Fixed: Eliminated some PHP warnings
= 1.3.4 =
* Updated: Upgraded bundled CMB library to 1.0.8.
* Updated: Upgraded bundled posts-to-posts library to 1.6.3-alpha.
* Updated: Corrected several outdated PHPDoc comments.
* Updated: Added quotes to all shortcode examples for clarity.
* Fixed: Properly award "all achievements of type" step trigger when triggered.
* Fixed: Prevent awarding a user's triggered triggers to current admin.
* Fixed: Prevent awarding a user's triggered triggers on the incorrect site (in multisite).
* Fixed: Prevent users from incorrectly resubmitting earned achievements to Credly.
* Fixed: Pass explicit user ID on "send to credly" AJAX calls.
* Fixed: Minor CSS tweaks to BadgeOS user profile fields.
= 1.3.3 =
* Added: Spanish language translation.
* Fixed: Eliminated a recursion issue with the badgeos_award_achievement action hook.
* Fixed: Users can send new submissions if previous submisson was denied or approved (until they've reached the maximum earnings for the achievement).
* Fixed: Corrected sort order on front-end step output.
* Fixed: Updated Earned Achievements Widget handling for achievements with spaces and special characters.
= 1.3.2 =
* Fixed: Small issue with Credly Badge Builder API headers.
= 1.3.1 =
* Fixed: Achievement step stort order (in admin).
* Fixed: Prevent duplicate stock achievement thumbnails per achievement type.
* Fixed: Bug with Credly Badge Builder API connection.
= 1.3.0 =
* Added: Credly Badge Builder – Build your own unique badges directly from the post editor (requires Credly account).
* Added: badgeos_is_achievement() to check if a given $post or $post_id is a BadgeOS achievement.
* Added: New [credly_assertion_page] shortcode for Credly Pro users.
* Added: Specify a custom message to include with Credly notification emails
* Updated: badgeos_award_achievement_to_user() now checks that the passed $acheivement_id is a real achievement.
* Updated: New achievements now have a default max earning of 1 (blank for infinite).
* Updated: BadgeOS Help page now links to Github, instead of just mentioning it.
* Updated: Detailed "Credly Sharing" options are only visible on the achievement editor when achievement is set to "send to credly".
* Updated: "Featured Image" text now says "Achievement Image" when working with an achievement post.
* Fixed: Added variable type check to badgeos_get_user_achievements() to prevent PHP warning.
* Fixed: Earned achievements will no longer show "Send to Credly" when setting is disabled.
= 1.2.0 =
* Added: "Add-ons" menu now has a catalog of new plugins to extend BadgeOS in exciting ways.
* Added: Introduced a suite of "user activity" functions for tracking a user's active achievements.
* Updated: Add-Ons admin page now dynamically pulls all available add-ons directly from BadgeOS.org
* Updated: Improved support for WP Multisite installations
* Updated: Earned Achievements widget now sorts achievements with newest-earned first.
* Updated: Earned Achievements widget now supports displaying all OR specific achievement types.
* Updated: [badgeos_achievements_list] shortcode now supports multiple achievement types, using either type="all" or by separating the achievement names with a comma, like: type="badge,quest,level".
* Updated: [badgeos_achievements_list] shortcode now supports "orderby" and "order" parameters so you can control how achievements are sorted.
* Updated: BadgeOS Log Entry functions are now filterable and can be overridden (more on this in 1.3).
* Updated: Added hooks to Help/Support page so add-ons can include their own content.
* Updated: We now set a default thumbnail for new achievements and achievement types.
* Updated: We now display a warning on the Achievement Type editor if a title exceeds 20 characters.
* Updated: Removed some redundant checks in the rules-engine to make process more performant.
* Updated: Relocated a few functions to make codebase easier to navigate.
* Fixed: We now hide the container for an earned achievement's congratulations text if there is no congratulations text.
* Fixed: The Earned Achievements widget and the Send to Credly functionality sanely fall-back to the parent achievement's thumbnail if the given achievement doesn't have one set.
* Fixed: Eliminated a bug with the "Add Media" functionality due to a conflict with the Canvas theme by WooThemes.
* Fixed: Cleared out many minor, but annoying, PHP warnings
= 1.1.0 =
* Added: New triggers for publishing new posts and pages
* Added: [badgeos_achievement] shortcode to display a single achievement on any post/page, see BadgeOS Help/Support for parameter details
* Added: [badgeos_submissions] shortcode to show a filterable/searchable list of submissions, see BadgeOS Help/Support for parameter details
* Added: [badgeos_nominations] shortcode to show a filterable/searchable list of nominations, see BadgeOS Help/Support for parameter details
* Added: New meta box showing attachments for a Submission in the admin dashboard
* Added: Earned achievement message on an achievement single page which shows if a user has earned the achievement
* Added: New widget to display the Credly Credit Issuer badge
* Updated: Achievements widget with option to display user's total points
* Updated: [badgeos_submission] shortcode to accept achievement_id parameter
* Updated: [badgeos_nomination] shortcode to accept achievement_id parameter
* Updated: New filter for controlling whether or not a user is allowed to spring a trigger
* Fixed: Nomination user select field from displaying twice on the page
* Fixed: Nomination listing page from displaying the wrong status for the nomination
* Fixed: Nomination form/listing now displays a user's submitted nomination and limits them to submitting a single nomination
= 1.0.3 =
* Updated: Only show "People Who Have Earned This" when there is at least one earner
* Updated: Localization strings have been updated throughout for easier translating
* Updated: Submissions and Nominations were originally publicly searchable, they are now private
* Fixed: Prevent earning an achievement more times than "max earnings" allows
* Fixed: Prevent earning steps with no parents
* Fixed: Prevent earning unpublished, private or trashed achievements
* Fixed: Inability to earn "any [achievement type]" steps
* Fixed: Inability to earn "all [achievement type]" steps
* Fixed: Filter for "Completed Achievements" (would sometimes show ALL achievements if user had earned none)
* Fixed: A PHP warning that would sometimes appear when manually awarding an achievement via user profile editor
* Fixed: A number of minor behind-the-scenes bugs that annoyed our PHP developers
= 1.0.2 =
* New: Added "Display users who have earned achievement" option to achievements
* Updated: BadgeOS Add-Ons admin page now shows current BadgeOS add-ons
* Updated: [badgeos_achievements_list] shortcode now shows send to Credly link on earned achievements.
= 1.0.1 =
* Fix: The "Award an Achievement" section on the User Profile page now grabs the appropriate custom post type slugs.
* Fix: Updated an incorrectly named function.
* Fix: Stop completed filter from showing all achievements if no achievements have been completed
* Updated: Achievement display and awarding UI improvement.
* Updated: [badgeos_achievements_list] shortcode now supports show_filter and show_search attributes
= 1.0.0 =
* BadgeOS says "hello world", earns "Hello World" badge.
== Upgrade Notice ==
= 1.4.4 =
* Improved checks to prevent achievement type switching when editing achievement types.
* Added a check to ensure multisite is active before calling multisite functions.
* Added internationalization strings and updated pot file.
* Inline documentation improvements.
= 1.4.3 =
* Fix issue with user scores being zero'd out when they save their profile in WP Admin.
* Added French translation files. Credit: http://extremraym.com
* Made it possible for admins to award achievements, that can be earned multiple times, to users via the User's admin profile
* Misc code tweaks.
= 1.4.2 =
* Updated: Achievement Types now support menu ordering.
* Fixed: Eliminated a fatal error in the nomination saving process.
* Fixed: Updated submission manager role setting to correctly show the selected value.
* Fixed: Additional hardening for achievement-type migration so that it doesn't happen prematurely due to autosave.
= 1.4.1 =
* Fixed: Eliminated a critical bug that could cause all posts to be migrated to a brand new achievement type on publish.
= 1.4.0 =
* Added: BadgeOS Shortcode Embedder – Easily add any shortcode to any content area with a few clicks.
* Added: BadgeOS Shortcode registration API – Easily add support for new BadgeOS-related shortcodes and modify existing shortcodes with automatic support for the BOS Shortcode Embedder and help page.
* Added: Submission Manager Role selector – allow users to moderate submissions without granting them full access to BadgeOS administration.
* Added: Submission Notification Admin Settings – Specify an unlimited number of email addresses in a comma-separated list for submission admin notifications.
* Added: Submission Notifications to users who have made a submission.
* Added: Several new submission notification types - new submission, new comment, and submission status change
* Added: User Email Notification Setting - Users can opt-out of email notifications in the profile editor.
* Added: Trigger for commenting on specific posts.
* Added: Many hooks for modifying shortcodes, submission lists, and more.
* Added: Baseline support for renaming achievement types, including the auto-migrating all achievements (and user earnings) from original achievement type to the new.
* Added: Helper functions for checking if user meets BOS management roles.
* Updated: Revised trigger for commenting on posts to only award when comment is approved.
* Updated: Submission status can now be altered on the front-end from approved to denied or back again.
* Updated: Admin area for editing a submission now uses the same approve/deny buttons as the rest of the site.
* Updated: Submission Lists are now highly customizable via WP hooks. The search input, filter inputs, and even the results can be altered programatically.
* Updated: Many, many internationalization enhancements. Help us release BadgeOS in your language!
* Updated: BadgeOS management role selector is hidden on the settings page to non-admins.
* Updated: Badgeos management role selector now excludes contributor and subscriber roles.
* Fixed: Rewrite rules automatically flush when a new achievement type is added (or an existing is renamed).
* Fixed: BadgeOS settings can now be modified by the minimum selected management role.
* Fixed: Prevent users from repeatedly earning auto-approved submissions.
* Fixed: Submissions List status filter now indicates the displayed status on page load.
* Fixed: Lots of other minor bugs.
= 1.3.5 =
* Fixed: Eliminated an error when attempting to use Credly Badge Builder over SSL
* Fixed: Eliminated some PHP warnings
= 1.3.4 =
* Updated: Upgraded bundled CMB library to 1.0.8.
* Updated: Upgraded bundled posts-to-posts library to 1.6.3-alpha.
* Updated: Corrected several outdated PHPDoc comments.
* Updated: Added quotes to all shortcode examples for clarity.
* Fixed: Properly award "all achievements of type" step trigger when triggered.
* Fixed: Prevent awarding a user's triggered triggers to current admin.
* Fixed: Prevent awarding a user's triggered triggers on the incorrect site (in multisite).
* Fixed: Prevent users from incorrectly resubmitting earned achievements to Credly.
* Fixed: Pass explicit user ID on "send to credly" AJAX calls.
* Fixed: Minor CSS tweaks to BadgeOS user profile fields.
= 1.3.3 =
* Added: Spanish language translation.
* Fixed: Eliminated a recursion issue with the badgeos_award_achievement action hook.
* Fixed: Users can send new submissions if previous submisson was denied or approved (until they've reached the maximum earnings for the achievement).
* Fixed: Corrected sort order on front-end step output.
* Fixed: Updated Earned Achievements Widget handling for achievements with spaces and special characters.
= 1.3.2 =
* Fixed: Small issue with Credly Badge Builder API headers.
= 1.3.1 =
* Fixed: Achievement step ordering
* Fixed: Prevent duplicate stock achievement thumbnails per achievement type
* Fixed: Bug with Credly Badge Builder API connection
= 1.3.0 =
* Added: Credly Badge Builder – Build your own unique badges directly from the achievement post editor in WordPress (requires free Credly account).
* Added: badgeos_is_achievement() to check if a given $post or $post_id is a BadgeOS achievement.
* Added: New [credly_assertion_page] shortcode for Credly Pro users.
* Added: Specify a custom message to include with Credly notification emails
* Updated: badgeos_award_achievement_to_user() now checks that the passed $acheivement_id is a real achievement.
* Updated: New achievements now have a default max earning of 1 (blank for infinite).
* Updated: BadgeOS Help page now links to Github, instead of just mentioning it.
* Updated: Detailed "Credly Sharing" options are only visible on the achievement editor when achievement is set to "send to Credly".
* Updated: "Featured Image" text now says "Achievement Image" when working with an achievement post.
* Fixed: Added variable type check to badgeos_get_user_achievements() to prevent PHP warning.
* Fixed: Earned achievements will no longer show "Send to Credly" when setting is disabled.
= 1.2.0 =
* Added: "Add-ons" menu now has a catalog of new plugins to extend BadgeOS in exciting ways.
* Added: Introduced a suite of "user activity" functions for tracking a user's active achievements.
* Updated: Add-Ons admin page now dynamically pulls all available add-ons directly from BadgeOS.org
* Updated: Improved support for WP Multisite installations
* Updated: Earned Achievements widget now sorts achievements with newest-earned first.
* Updated: Earned Achievements widget now supports displaying all OR specific achievement types.
* Updated: [badgeos_achievements_list] shortcode now supports multiple achievement types, using either type="all" or by separating the achievement names with a comma, like: type="badge,quest,level".
* Updated: [badgeos_achievements_list] shortcode now supports "orderby" and "order" parameters so you can control how achievements are sorted.
* Updated: BadgeOS Log Entry functions are now filterable and can be overridden (more on this in 1.3).
* Updated: Added hooks to Help/Support page so add-ons can include their own content.
* Updated: We now set a default thumbnail for new achievements and achievement types.
* Updated: We now display a warning on the Achievement Type editor if a title exceeds 20 characters.
* Updated: Removed some redundant checks in the rules-engine to make process more performant.
* Updated: Relocated a few functions to make codebase easier to navigate.
* Fixed: We now hide the container for an earned achievement's congratulations text if there is no congratulations text.
* Fixed: The Earned Achievements widget and the Send to Credly functionality sanely fall-back to the parent achievement's thumbnail if the given achievement doesn't have one set.
* Fixed: Eliminated a bug with the "Add Media" functionality due to a conflict with the Canvas theme by WooThemes.
* Fixed: Cleared out many minor, but annoying, PHP warnings
= 1.1.0 =
* Added: New widget to display the Credly Credit Issuer badge
* Added: New triggers for publishing new posts and pages
* Added: [badgeos_achievement] shortcode to display a single achievement on any post/page, see BadgeOS Help/Support for parameter details
* Added: [badgeos_submissions] shortcode to show a filterable/searchable list of submissions, see BadgeOS Help/Support for parameter details
* Added: [badgeos_nominations] shortcode to show a filterable/searchable list of nominations, see BadgeOS Help/Support for parameter details
* Added: Earned achievement message on an achievement single page which shows if a user has earned the achievement
* Updated: Achievements widget with option to display user's total points
* Updated: [badgeos_submission] shortcode to accept achievement_id parameter
* Updated: [badgeos_nomination] shortcode to accept achievement_id parameter
* Updated: New filter for controlling whether or not a user is allowed to spring a trigger
* Fixed: Nomination user select field from displaying twice on the page
* Fixed: Nomination listing page from displaying the wrong status for the nomination
* Fixed: Nomination form/listing now displays a user's submitted nomination and limits them to submitting a single nomination
= 1.0.3 =
* Updated: Only show "People Who Have Earned This" when there is at least one earner
* Updated: Localization strings have been updated throughout for easier translating
* Updated: Submissions and Nominations were originally publicly searchable, they are now private
* Fixed: Prevent earning an achievement more times than "max earnings" allows
* Fixed: Prevent earning steps with no parents
* Fixed: Prevent earning unpublished, private or trashed achievements
* Fixed: Inability to earn "any [achievement type]" steps
* Fixed: Inability to earn "all [achievement type]" steps
* Fixed: Filter for "Completed Achievements" (would sometimes show ALL achievements if user had earned none)
* Fixed: A PHP warning that would sometimes appear when manually awarding an achievement via user profile editor
* Fixed: A number of minor behind-the-scenes bugs that annoyed our PHP developers
= 1.0.2 =
* New: Added "Display users who have earned achievement" option to achievements
* Updated: BadgeOS Add-Ons admin page now shows current BadgeOS add-ons
* Updated: [badgeos_achievements_list] shortcode now shows send to Credly link on earned achievements.
= 1.0.1 =
* Fix: The "Award an Achievement" section on the User Profile page now grabs the appropriate custom post type slugs.
* Fix: Updated an incorrectly named function.
* Fix: Stop completed filter from showing all achievements if no achievements have been completed
* Updated: Achievement display and awarding UI improvement.
* Updated: [badgeos_achievements_list] shortcode now supports show_filter and show_search attributes
= 1.0.0 =
* BadgeOS says "hello world", earns "Hello World" badge.