/**
* Notify a member they have been invited to a group.
*
* @since 1.0.0
*
* @param BP_Groups_Group $group Group object.
* @param BP_Groups_Member $member Member object.
* @param int $inviter_user_id ID of the user who sent the invite.
*/
function groups_notification_group_invites(&$group, &$member, $inviter_user_id)
{
// Bail if member has already been invited.
if (!empty($member->invite_sent)) {
return;
}
// @todo $inviter_ud may be used for caching, test without it
$inviter_ud = bp_core_get_core_userdata($inviter_user_id);
$invited_user_id = $member->user_id;
// Trigger a BuddyPress Notification.
if (bp_is_active('notifications')) {
bp_notifications_add_notification(array('user_id' => $invited_user_id, 'item_id' => $group->id, 'component_name' => buddypress()->groups->id, 'component_action' => 'group_invite'));
}
// Bail if member opted out of receiving this email.
if ('no' === bp_get_user_meta($invited_user_id, 'notification_groups_invite', true)) {
return;
}
$invited_link = bp_core_get_user_domain($invited_user_id) . bp_get_groups_slug();
$unsubscribe_args = array('user_id' => $invited_user_id, 'notification_type' => 'groups-invitation');
$args = array('tokens' => array('group' => $group, 'group.url' => bp_get_group_permalink($group), 'group.name' => $group->name, 'inviter.name' => bp_core_get_userlink($inviter_user_id, true, false, true), 'inviter.url' => bp_core_get_user_domain($inviter_user_id), 'inviter.id' => $inviter_user_id, 'invites.url' => esc_url($invited_link . '/invites/'), 'unsubscribe' => esc_url(bp_email_get_unsubscribe_link($unsubscribe_args))));
bp_send_email('groups-invitation', (int) $invited_user_id, $args);
}
/**
* Send email and BP notifications when an activity item receives a comment.
*
* @since 1.2.0
* @since 2.5.0 Updated to use new email APIs.
*
* @param int $comment_id The comment id.
* @param int $commenter_id The ID of the user who posted the comment.
* @param array $params {@link bp_activity_new_comment()}.
*/
function bp_activity_new_comment_notification($comment_id = 0, $commenter_id = 0, $params = array())
{
$original_activity = new BP_Activity_Activity($params['activity_id']);
$poster_name = bp_core_get_user_displayname($commenter_id);
$thread_link = bp_activity_get_permalink($params['activity_id']);
remove_filter('bp_get_activity_content_body', 'convert_smilies');
remove_filter('bp_get_activity_content_body', 'wpautop');
remove_filter('bp_get_activity_content_body', 'bp_activity_truncate_entry', 5);
/** This filter is documented in bp-activity/bp-activity-template.php */
$content = apply_filters('bp_get_activity_content_body', $params['content']);
add_filter('bp_get_activity_content_body', 'convert_smilies');
add_filter('bp_get_activity_content_body', 'wpautop');
add_filter('bp_get_activity_content_body', 'bp_activity_truncate_entry', 5);
if ($original_activity->user_id != $commenter_id) {
// Send an email if the user hasn't opted-out.
if ('no' != bp_get_user_meta($original_activity->user_id, 'notification_activity_new_reply', true)) {
$unsubscribe_args = array('user_id' => $original_activity->user_id, 'notification_type' => 'activity-comment');
$args = array('tokens' => array('comment.id' => $comment_id, 'commenter.id' => $commenter_id, 'usermessage' => wp_strip_all_tags($content), 'original_activity.user_id' => $original_activity->user_id, 'poster.name' => $poster_name, 'thread.url' => esc_url($thread_link), 'unsubscribe' => esc_url(bp_email_get_unsubscribe_link($unsubscribe_args))));
bp_send_email('activity-comment', $original_activity->user_id, $args);
}
/**
* Fires at the point that notifications should be sent for activity comments.
*
* @since 2.6.0
*
* @param BP_Activity_Activity $original_activity The original activity.
* @param int $comment_id ID for the newly received comment.
* @param int $commenter_id ID of the user who made the comment.
* @param array $params Arguments used with the original activity comment.
*/
do_action('bp_activity_sent_reply_to_update_notification', $original_activity, $comment_id, $commenter_id, $params);
}
/*
* If this is a reply to another comment, send an email notification to the
* author of the immediate parent comment.
*/
if (empty($params['parent_id']) || $params['activity_id'] == $params['parent_id']) {
return;
}
$parent_comment = new BP_Activity_Activity($params['parent_id']);
if ($parent_comment->user_id != $commenter_id && $original_activity->user_id != $parent_comment->user_id) {
// Send an email if the user hasn't opted-out.
if ('no' != bp_get_user_meta($parent_comment->user_id, 'notification_activity_new_reply', true)) {
$unsubscribe_args = array('user_id' => $parent_comment->user_id, 'notification_type' => 'activity-comment-author');
$args = array('tokens' => array('comment.id' => $comment_id, 'commenter.id' => $commenter_id, 'usermessage' => wp_strip_all_tags($content), 'parent-comment-user.id' => $parent_comment->user_id, 'poster.name' => $poster_name, 'thread.url' => esc_url($thread_link), 'unsubscribe' => esc_url(bp_email_get_unsubscribe_link($unsubscribe_args))));
bp_send_email('activity-comment-author', $parent_comment->user_id, $args);
}
/**
* Fires at the point that notifications should be sent for comments on activity replies.
*
* @since 2.6.0
*
* @param BP_Activity_Activity $parent_comment The parent activity.
* @param int $comment_id ID for the newly received comment.
* @param int $commenter_id ID of the user who made the comment.
* @param array $params Arguments used with the original activity comment.
*/
do_action('bp_activity_sent_reply_to_reply_notification', $parent_comment, $comment_id, $commenter_id, $params);
}
}
/**
* Send notifications related to the acceptance of a friendship request.
*
* When a friendship request is accepted, an email and a BP notification are
* sent to the user who requested the friendship ($initiator_id).
*
* @since 1.0.0
*
* @param int $friendship_id ID of the friendship object.
* @param int $initiator_id ID of the user who initiated the request.
* @param int $friend_id ID of the request recipient.
*/
function friends_notification_accepted_request($friendship_id, $initiator_id, $friend_id)
{
if ('no' == bp_get_user_meta((int) $initiator_id, 'notification_friends_friendship_accepted', true)) {
return;
}
$unsubscribe_args = array('user_id' => $initiator_id, 'notification_type' => 'friends-request-accepted');
$args = array('tokens' => array('friend.id' => $friend_id, 'friendship.url' => esc_url(bp_core_get_user_domain($friend_id)), 'friend.name' => bp_core_get_user_displayname($friend_id), 'friendship.id' => $friendship_id, 'initiator.id' => $initiator_id, 'unsubscribe' => esc_url(bp_email_get_unsubscribe_link($unsubscribe_args))));
bp_send_email('friends-request-accepted', $initiator_id, $args);
}
/**
* Email message recipients to alert them of a new unread private message.
*
* @since 1.0.0
*
* @param array|BP_Messages_Message $raw_args {
* Array of arguments. Also accepts a BP_Messages_Message object.
* @type array $recipients User IDs of recipients.
* @type string $email_subject Subject line of message.
* @type string $email_content Content of message.
* @type int $sender_id User ID of sender.
* }
*/
function messages_notification_new_message($raw_args = array())
{
if (is_object($raw_args)) {
$args = (array) $raw_args;
} else {
$args = $raw_args;
}
// These should be extracted below.
$recipients = array();
$email_subject = $email_content = '';
$sender_id = 0;
// Barf.
extract($args);
if (empty($recipients)) {
return;
}
$sender_name = bp_core_get_user_displayname($sender_id);
// Send an email to each recipient.
foreach ($recipients as $recipient) {
if ($sender_id == $recipient->user_id || 'no' == bp_get_user_meta($recipient->user_id, 'notification_messages_new_message', true)) {
continue;
}
// User data and links.
$ud = get_userdata($recipient->user_id);
if (empty($ud)) {
continue;
}
$unsubscribe_args = array('user_id' => $recipient->user_id, 'notification_type' => 'messages-unread');
$args = array('tokens' => array('usermessage' => wp_strip_all_tags(stripslashes($message)), 'message.url' => esc_url(bp_core_get_user_domain($recipient->user_id) . bp_get_messages_slug() . '/view/' . $thread_id . '/'), 'sender.name' => $sender_name, 'usersubject' => sanitize_text_field(stripslashes($subject)), 'unsubscribe' => esc_url(bp_email_get_unsubscribe_link($unsubscribe_args))));
bp_send_email('messages-unread', $ud, $args);
}
/**
* Fires after the sending of a new message email notification.
*
* @since 1.5.0
* @deprecated 2.5.0 Use the filters in BP_Email.
* $email_subject and $email_content arguments unset and deprecated.
*
* @param array $recipients User IDs of recipients.
* @param string $email_subject Deprecated in 2.5; now an empty string.
* @param string $email_content Deprecated in 2.5; now an empty string.
* @param array $args Array of originally provided arguments.
*/
do_action('bp_messages_sent_notification_email', $recipients, '', '', $args);
}
