/**
* Check if user has completed an achievement
*
* @since 1.0.0
* @param integer $achievement_id The given achievement ID to verify
* @param integer $user_id The given user's ID
* @param string $this_trigger The trigger
* @param integer $site_id The triggered site id
* @param array $args The triggered args
* @return bool True if user has completed achievement, false otherwise
*/
function badgeos_check_achievement_completion_for_user($achievement_id = 0, $user_id = 0, $this_trigger = '', $site_id = 0, $args = array())
{
// Assume the user has completed the achievement
$return = true;
// Set to current site id
if (!$site_id) {
$site_id = get_current_blog_id();
}
// If the user has not already earned the achievement...
if (!badgeos_get_user_achievements(array('user_id' => absint($user_id), 'achievement_id' => absint($achievement_id), 'since' => 1 + badgeos_achievement_last_user_activity($achievement_id, $user_id)))) {
// Grab our required achievements for this achievement
$required_achievements = badgeos_get_required_achievements_for_achievement($achievement_id);
// If we have requirements, loop through each and make sure they've been completed
if (is_array($required_achievements) && !empty($required_achievements)) {
foreach ($required_achievements as $requirement) {
// Has the user already earned the requirement?
if (!badgeos_get_user_achievements(array('user_id' => $user_id, 'achievement_id' => $requirement->ID, 'since' => badgeos_achievement_last_user_activity($achievement_id, $user_id)))) {
$return = false;
break;
}
}
}
}
// Available filter to support custom earning rules
return apply_filters('user_deserves_achievement', $return, $user_id, $achievement_id, $this_trigger, $site_id, $args);
}
/**
* Render an achievement
*
* @since 1.0.0
* @param integer $achievement The achievement's post ID
* @return string Concatenated markup
*/
function badgeos_render_achievement($achievement = 0)
{
global $user_ID;
// If we were given an ID, get the post
if (is_numeric($achievement)) {
$achievement = get_post($achievement);
}
// make sure our JS and CSS is enqueued
wp_enqueue_script('badgeos-achievements');
wp_enqueue_style('badgeos-widget');
// check if user has earned this Achievement, and add an 'earned' class
$earned_status = badgeos_get_user_achievements(array('user_id' => $user_ID, 'achievement_id' => absint($achievement->ID))) ? 'user-has-earned' : 'user-has-not-earned';
// Setup our credly classes
$credly_class = '';
$credly_ID = '';
// If the achievement is earned and givable, override our credly classes
if ('user-has-earned' == $earned_status && ($giveable = credly_is_achievement_giveable($achievement->ID, $user_ID))) {
$credly_class = ' share-credly addCredly';
$credly_ID = 'data-credlyid="' . absint($achievement->ID) . '"';
}
// Each Achievement
$output = '';
$output .= '<div id="badgeos-achievements-list-item-' . $achievement->ID . '" class="badgeos-achievements-list-item ' . $earned_status . $credly_class . '"' . $credly_ID . '>';
// Achievement Image
$output .= '<div class="badgeos-item-image">';
$output .= '<a href="' . get_permalink($achievement->ID) . '">' . badgeos_get_achievement_post_thumbnail($achievement->ID) . '</a>';
$output .= '</div><!-- .badgeos-item-image -->';
// Achievement Content
$output .= '<div class="badgeos-item-description">';
// Achievement Title
$output .= '<h2 class="badgeos-item-title"><a href="' . get_permalink($achievement->ID) . '">' . get_the_title($achievement->ID) . '</a></h2>';
// Achievement Short Description
$output .= '<div class="badgeos-item-excerpt">';
$output .= badgeos_achievement_points_markup($achievement->ID);
$excerpt = !empty($achievement->post_excerpt) ? $achievement->post_excerpt : $achievement->post_content;
$output .= wpautop(apply_filters('get_the_excerpt', $excerpt));
$output .= '</div><!-- .badgeos-item-excerpt -->';
// Render our Steps
if ($steps = badgeos_get_required_achievements_for_achievement($achievement->ID)) {
$output .= '<div class="badgeos-item-attached">';
$output .= '<div id="show-more-' . $achievement->ID . '" class="badgeos-open-close-switch"><a class="show-hide-open" data-badgeid="' . $achievement->ID . '" data-action="open" href="#">' . __('Show Details', 'badgeos') . '</a></div>';
$output .= '<div id="badgeos_toggle_more_window_' . $achievement->ID . '" class="badgeos-extras-window">' . badgeos_get_required_achievements_for_achievement_list_markup($steps, $achievement->ID) . '</div><!-- .badgeos-extras-window -->';
$output .= '</div><!-- .badgeos-item-attached -->';
}
$output .= '</div><!-- .badgeos-item-description -->';
$output .= '</div><!-- .badgeos-achievements-list-item -->';
// Return our filterable markup
return apply_filters('badgeos_render_achievement', $output, $achievement->ID);
}
