No email notifications for admin-awarded achievements

Looks like we simply do not do any emailing for admin-awarded achievements. The spot you saw in submission-actions.php is specific to submissions/nominations.

The user you point out likely hooked into this:

do_action( 'badgeos_award_achievement', $user_id, $achievement_id, $this_trigger, $site_id, $args );

which fires after each achievement is awarded, including admin-awarded achievements, and used the provided user ID and achievement ID values to construct an email to the user.

Not sure how much of a coder/developer you are, for that to make any sense.

Thanks for your answer. Could you please also confirm the following:

There is no email notification after an achievement is earned by completing all the required steps.

Would the action you mentioned in your response also trigger when an achievement earned by steps is completed?

Thanks,
NBl

The action listed above is going to trigger whenever an achievement is awarded, regardless of how it was earned or what steps were required to trigger it.

Just wanted to verify that there is currently no notification sent out when all steps of an achievement have been completed. My test showed that behavior.

Also if I use the badgeos_award_achievement action can I exclude completed achievements as the users already get a notification for those. Won’t they get duplicates if this action is used?

Correct, the only type of achievements that get any sort of email are the submission/nomination based ones.

Adding an add_action() on this hook and setting up email notifications will only run on achievements that are newly triggered/earned. Achievements a user has already earned, won’t have emails sent out regarding them. It’s not retroactive.

Calling the action hook in my theme’s functions.php worked.
Here is what I used:

add_action( 'badgeos_award_achievement', 'super_badge_notification', 10, 2 );

function super_badge_notification( $user_id, $achievement_id ) {

	if($achievement_id == 12 || $achievement_id == 13 ||  $achievement_id == 54 || $achievement_id == 66 || $achievement_id == 156) {

		$user_data = get_userdata( $user_id );
		$email = $user_data->user_email;

		if($achievement_id == 12 || $achievement_id == 13 ||  $achievement_id == 54){
		$subject = sprintf( __( 'Badge Awarded: %s', 'badgeos' ), get_the_title( $achievement_id ) );

		// set the email message
		$message = sprintf( __( 'You have completed all steps to receive your AISD World Language badge:

Badge awarded: %1$s
Awarded to: %2$s
%3$s

Visit %4$s (Your Account) to see all steps and completed badges you have received.
Be sure to check the "AISD WL Badges" tab to see your completed badges.', 'badgeos' ),
			get_the_title( $achievement_id ),
			$user_data->display_name,
			get_permalink( $achievement_id ),
			get_site_url( '/' ) . '/members/' . $user_data->user_nicename . '/achievements/'
		);
		}

		$message = array(
			'email' => $email,
			'subject' => $subject,
			'message' => $message
		);

		$default_message = array(
		'email' => '',
		'subject' => '',
		'message' => '',
		'headers' => '',
		'attachments' => array()
		);

		$email_message = wp_parse_args( $message, $default_message );

		if ( ! empty( $email ) && ! empty( $email_message[ 'subject' ] ) && ! empty( $email_message[ 'message' ] ) && badgeos_can_notify_user( $user_id ) ) 	{
			call_user_func_array( 'wp_mail', array_values( $email_message ) );
		}

	}

}

Awesome to hear you got it working. The following are just suggestions to help try and clean things up and make it easier to understand.

Instead of

if($achievement_id == 12 || $achievement_id == 13 ||  $achievement_id == 54 || $achievement_id == 66 || $achievement_id == 156)

perhaps try

$desired_achievements = array( 12, 13, 54, 66, 156 );
if ( in_array( $achievement_id, $desired_achievements ) )

you can repeat as well with that inner if statement that sets the message/subject. Otherwise looks good.