Hooks to award points?

Not quite following. At least majority of the time, points are just associated with other achievements, and as a user earns the achievements, their point total increases as well. However, we do have the available minimal point total step requirement, which I believe simply checks the user’s point total and if the total is enough, the achievement itself gets awarded.

Not sure how easily it’d be to associate points with specific steps, but I have to believe it wouldn’t be impossible, since steps are their own post type.

Otherwise, I may need more concrete examples to mull over to help get more pointed answers.

Hi Michael –

Thank you for your quick response.

What I meant to ask is what hooks will award achievements – either through something in the ‘Earned By’ drop down, or something in the steps section?

What code is required to make sure something is recorded?

Thank you!

A more concrete example is the LearnDash plugin. What hooks are required to award points once something is complete in LearnDash? Would you be able to walk me through the PHP code? I am not seeing where points are specifically added nor where the ‘Marking Complete’ will trigger something in BadgeOS to award an achievement.

Thanks so much!

I would recommend looking through the following 3 files: triggers.php, rules-engine.php, and points-functions.php. Those are where most of the logic takes place for achievement awarding.

Going with the provided examples, in the points-functions.php file at the bottom, we have a callback hooked onto the badgeos_award_achievement hook, which fires when an achievement is awarded :D. The callback gets the user’s ID and the achievement ID. It then checks if the achievement has any point values associated, and if so, it passes the user ID, earned point value, and achievement ID into badgeos_update_users_points

It’s a big codebase that is definitely complex. I am regularly re-tracing my way through it myself, as I expect everyone would. Do note while I’m the lead support person with it, I am not the original developer. Many hands have played their parts with it.