group_messages_notification_new_message( array $raw_args = array() )

Email message recipients to alert them of a new unread group message.

Description

Parameters

$raw_args

(Optional)

Default value: array()

Source

File: bp-messages/bp-messages-functions.php

function group_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 = $subject = $email_content = '';
    $sender_id     = $id = 0;
 
    // Barf.
    extract( $args );
 
    if ( empty( $recipients ) ) {
        return;
    }
 
    $sender_name = bp_core_get_user_displayname( $sender_id );
 
    if ( isset( $message ) ) {
        $message = wpautop( $message );
    } else {
        $message = '';
    }
 
    // 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' => 'group-message-email',
        );
 
        $group      = bp_messages_get_meta( $id, 'group_id', true );
        $group_name = bp_get_group_name( groups_get_group( $group ) );
 
        bp_send_email(
            'group-message-email',
            $ud,
            array(
                'tokens' => array(
                    'message_id'  => $id,
                    'usermessage' => stripslashes( $message ),
                    'message'     => 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 ) ),
                    'group.name'  => $group_name,
                    'unsubscribe' => esc_url( bp_email_get_unsubscribe_link( $unsubscribe_args ) ),
                ),
            )
        );
    }
 
    /**
     * Fires after the sending of a new group message email notification.
     *
     * @since BuddyPress 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( 'group_messages_notification_new_message', $recipients, '', '', $args );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version	Description
BuddyBoss 1.2.9	Introduced.

Uses

Uses
Uses	Description
bp-messages/bp-messages-functions.php: group_messages_notification_new_message	Fires after the sending of a new group message email notification.
bp-messages/bp-messages-template.php: bp_get_messages_slug()	Return the messages component slug.
bp-messages/bp-messages-functions.php: bp_messages_get_meta()	Get a piece of message metadata.
bp-groups/bp-groups-functions.php: groups_get_group()	Fetch a single group object.
bp-groups/bp-groups-template.php: bp_get_group_name()	Get the name of the current group in the loop.
bp-members/bp-members-functions.php: bp_core_get_user_displayname()	Fetch the display name for a user.
bp-members/bp-members-functions.php: bp_core_get_user_domain()	Return the domain for the passed user: e.g. http://example.com/members/andy/.
bp-core/bp-core-functions.php: bp_email_get_unsubscribe_link()	Creates unsubscribe link for notification emails.
bp-core/bp-core-functions.php: bp_send_email()	Send email, similar to WordPress’ wp_mail().
bp-core/bp-core-functions.php: bp_get_user_meta()	Get a piece of usermeta.

Show 5 more uses Hide more uses

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.

Contents