Contents

Code Reference Classes BP_Messages_Message BP_Messages_Message::send()

BP_Messages_Message::send()

Send a message.

Description

Return

(int|bool) ID of the newly created message on success, false on failure.

Source

File: bp-messages/classes/class-bp-messages-message.php

125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
public function send() {
    global $wpdb;
 
    $bp = buddypress();
 
    $this->sender_id = apply_filters( 'messages_message_sender_id_before_save', $this->sender_id, $this->id );
    $this->thread_id = apply_filters( 'messages_message_thread_id_before_save', $this->thread_id, $this->id );
    $this->subject   = apply_filters( 'messages_message_subject_before_save', $this->subject, $this->id );
    $this->message   = apply_filters( 'messages_message_content_before_save', $this->message, $this->id );
    $this->date_sent = apply_filters( 'messages_message_date_sent_before_save', $this->date_sent, $this->id );
 
    /**
     * Fires before the current message item gets saved.
     *
     * Please use this hook to filter the properties above. Each part will be passed in.
     *
     * @since BuddyPress 1.0.0
     *
     * @param BP_Messages_Message $this Current instance of the message item being saved. Passed by reference.
     */
    do_action_ref_array( 'messages_message_before_save', array( &$this ) );
 
    // Make sure we have at least one recipient before sending.
    if ( empty( $this->recipients ) ) {
        return false;
    }
 
    $new_thread = false;
 
    // If we have no thread_id then this is the first message of a new thread.
    if ( empty( $this->thread_id ) ) {
        $this->thread_id = (int) $wpdb->get_var( "SELECT MAX(thread_id) FROM {$bp->messages->table_name_messages}" ) + 1;
        $new_thread      = true;
    }
 
    // First insert the message into the messages table.
    if ( ! $wpdb->query( $wpdb->prepare( "INSERT INTO {$bp->messages->table_name_messages} ( thread_id, sender_id, subject, message, date_sent ) VALUES ( %d, %d, %s, %s, %s )", $this->thread_id, $this->sender_id, $this->subject, $this->message, $this->date_sent ) ) ) {
        return false;
    }
 
    static::$last_inserted_id = $this->id = $wpdb->insert_id;
 
    $recipient_ids = array();
 
    if ( $new_thread ) {
        // Add an recipient entry for all recipients.
        foreach ( (array) $this->recipients as $recipient ) {
            $wpdb->query( $wpdb->prepare( "INSERT INTO {$bp->messages->table_name_recipients} ( user_id, thread_id, unread_count ) VALUES ( %d, %d, 1 )", $recipient->user_id, $this->thread_id ) );
            $recipient_ids[] = $recipient->user_id;
        }
 
        // Add a sender recipient entry if the sender is not in the list of recipients.
        if ( ! in_array( $this->sender_id, $recipient_ids ) ) {
            $wpdb->query( $wpdb->prepare( "INSERT INTO {$bp->messages->table_name_recipients} ( user_id, thread_id ) VALUES ( %d, %d )", $this->sender_id, $this->thread_id ) );
        }
    } else {
        // Update the unread count for all recipients.
        $wpdb->query( $wpdb->prepare( "UPDATE {$bp->messages->table_name_recipients} SET unread_count = unread_count + 1, is_deleted = 0 WHERE thread_id = %d AND user_id != %d", $this->thread_id, $this->sender_id ) );
    }
 
    messages_remove_callback_values();
 
    /**
     * Fires after the current message item has been saved.
     *
     * @since BuddyPress 1.0.0
     *
     * @param BP_Messages_Message $this Current instance of the message item being saved. Passed by reference.
     */
    do_action_ref_array( 'messages_message_after_save', array( &$this ) );
 
    return $this->id;
}

Expand full source code Collapse full source code

Uses

Uses
Uses Description
bp-messages/classes/class-bp-messages-message.php: BP_Messages_Message::get()

Query for messages
bp-loader.php: buddypress()

The main function responsible for returning the one true BuddyBoss Instance to functions everywhere.
bp-messages/classes/class-bp-messages-message.php: messages_message_before_save

Fires before the current message item gets saved.
bp-messages/classes/class-bp-messages-message.php: messages_message_after_save

Fires after the current message item has been saved.
bp-messages/bp-messages-functions.php: bp_messages_delete_meta()

Delete metadata for a message.
bp-messages/bp-messages-functions.php: messages_remove_callback_values()

Unset messages-related cookies.
Show 1 more use 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.