Submissions & Nominations
As we mentioned in the Gamification with BadgeOS lesson, there are different ways to award badges. We’ll cover submissions and nominations, and show you how to set up a submission/nomination box and display a review listing in this lesson.
Submission Box
Use the shortcode [badgeos_submission] to add a submission box tied to a specific achievement on any post or page. This shortcode is automatically added on the single BadgeOS-generated post for that achievement. (The achievement specified must be set to be awarded by Submission.)
Example: [badgeos_submission achievement_id=35]
Nomination Box
Use the shortcode [badgeos_nomination] to add a nomination box tied to a specific achievement on any post or page. This shortcode is automatically added on the single BadgeOS-generated post for that achievement. (The achievement specified must be set to be awarded by Nomination.)
Example: [badgeos_nomination achievement_id=35]
Submissions Review Listing
Use the shortcode [badgeos_submissions] to place a list of pending, accepted and/or denied achievement submissions on any page or post. Note the shortcode is role dependent. If a user has the privilege to review incoming BadgeOS submissions, the listing will include all user submissions and the ability to accept or deny. It the current user does not have the ability to review Submissions, they will instead see just their own submissions. In this way, this shortcode lets you essentially set up an inbox/outbox on the front-end of your site so users and reviewers alike can track progress for achievements requiring interaction between site admin and site members.
Available parameters:
- “limit” — Number of submissions to display per page. Default: 10
- “status” — Which Approval Status type to show on initial page load. (Accepts: all, pending, auto-approved, approved, denied) Default: all
- “show_filter” — Display the filter select input. (Accepts: true, false) Default: true
- “show_search” — Display the search form. (Accepts: true, false) Default: true
- “show_attachments” — Display attachments connected to the submission. (Accepts: true, false) Default: true
- “show_comments” — Display comments associated with the submission. Default: true
Example: [badgeos_submissions status=pending limit=15]
Nominations Review Listing
Use this shortcode [badgeos_nominations] to place a list of pending, accepted and/or denied achievement nominations on any page or post. The shortcode is role dependent. If a user has BadgeOS review privileges to review incoming BadgeOS Nominations, the listing will include all user Nominations and the ability to accept or deny. It the current user does not have the ability to review Nominations, they will instead see just their own Nominations.
Available parameters:
- “limit” — Number of nominations to display per page. Default: 10
- “status” — Which Approval Status type to show on initial page load. (Accepts: all, pending, approved, denied) Default: all
- “show_filter” — Display the filter select input. (Accepts: true, false) Default: true
- “show_search” — Display the search form. (Accepts: true, false) Default: true
Example: [badgeos_nominations show_search=false limit=20]
