Ticket #5945: bp-messages-template-5945.diff

src/bp-messages/bp-messages-template.php

@@ -251 +251 @@
                 if ( $this->current_thread + 1 < $this->thread_count ) {
                         return true;
                 } elseif ( $this->current_thread + 1 == $this->thread_count ) {
-                        do_action('messages_box_loop_end');
+
+                        /**
+                         * Fires when at the end of threads to iterate over.
+                         *
+                         * @since BuddyPress (1.5.0)
+                         */
+                        do_action( 'messages_box_loop_end' );
                         // Do some cleaning up after the loop
                         $this->rewind_threads();
                 }
@@ -307 +313 @@
 
                 // loop has just started
                 if ( 0 == $this->current_thread ) {
+
+                        /**
+                         * Fires if at the start of the message thread loop.
+                         *
+                         * @since BuddyPress (1.5.0)
+                         */
                         do_action( 'messages_box_loop_start' );
                 }
         }
@@ -377 +389 @@
                 $r['page_arg']
         );
 
+        /**
+         * Filters if there are any message threads to display in inbox/sentbox/notices.
+         *
+         * @since BuddyPress (1.1.0)
+         *
+         * @param bool                     $value             Whether or not the message has threads.
+         * @param BP_Messages_Box_Template $messages_template Current message box template object.
+         * @param array                    $r                 Array of parsed arguments passed into function.
+         */
         return apply_filters( 'bp_has_message_threads', $messages_template->has_threads(), $messages_template, $r );
 }
 
@@ -414 +435 @@
         function bp_get_message_thread_id() {
                 global $messages_template;
 
+                /**
+                 * Filters the ID of the current thread in the loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param int $thread_id ID of the current thread in the loop.
+                 */
                 return apply_filters( 'bp_get_message_thread_id', $messages_template->thread->thread_id );
         }
 
@@ -431 +459 @@
         function bp_get_message_thread_subject() {
                 global $messages_template;
 
+                /**
+                 * Filters the subject of the current thread in the loop.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $value Subject of the current thread in the loop.
+                 */
                 return apply_filters( 'bp_get_message_thread_subject', stripslashes_deep( $messages_template->thread->last_message_subject ) );
         }
 
@@ -448 +483 @@
         function bp_get_message_thread_excerpt() {
                 global $messages_template;
 
+                /**
+                 * Filters the excerpt of the current thread in the loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value Excerpt of the current thread in the loop.
+                 */
                 return apply_filters( 'bp_get_message_thread_excerpt', strip_tags( bp_create_excerpt( $messages_template->thread->last_message_content, 75 ) ) );
         }
 
@@ -480 +522 @@
         function bp_get_message_thread_content() {
                 global $messages_template;
 
+                /**
+                 * Filters the content of the last message in the thread.
+                 *
+                 * @since BuddyPress (2.0.0)
+                 *
+                 * @param string $last_message_content Content of the last message in the thread.
+                 */
                 return apply_filters( 'bp_get_message_thread_content', $messages_template->thread->last_message_content );
         }
 
@@ -497 +546 @@
         function bp_get_message_thread_from() {
                 global $messages_template;
 
+                /**
+                 * Filters the link to the page of the current thread's last author.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value Link to the page of the current thread's last author.
+                 */
                 return apply_filters( 'bp_get_message_thread_from', bp_core_get_userlink( $messages_template->thread->last_sender_id ) );
         }
 
@@ -513 +569 @@
          */
         function bp_get_message_thread_to() {
                 global $messages_template;
+
+                /**
+                 * Filters the HTML links to the pages of the current thread's recipients.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value HTML links to the pages of the current thread's recipients.
+                 */
                 return apply_filters( 'bp_message_thread_to', BP_Messages_Thread::get_recipient_links($messages_template->thread->recipients ) );
         }
 
@@ -541 +605 @@
                         $thread_id = $messages_template->thread->thread_id;
                 }
 
+                /**
+                 * Filters the permalink of a particular thread.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value permalink of a particular thread.
+                 */
                 return apply_filters( 'bp_get_message_thread_view_link', trailingslashit( bp_loggedin_user_domain() . bp_get_messages_slug() . '/view/' . $thread_id ) );
         }
 
@@ -557 +628 @@
          */
         function bp_get_message_thread_delete_link() {
                 global $messages_template;
+
+                /**
+                 * Filters the URL for deleting the current thread.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value URL for deleting the current thread.
+                 * @param string $value Text indicating action being executed.
+                 */
                 return apply_filters( 'bp_get_message_thread_delete_link', wp_nonce_url( trailingslashit( bp_loggedin_user_domain() . bp_get_messages_slug() . '/' . bp_current_action() . '/delete/' . $messages_template->thread->thread_id ), 'messages_delete_thread' ) );
         }
 
@@ -597 +677 @@
                 // Add the nonce.
                 $url = wp_nonce_url( $url, 'bp_message_thread_mark_unread_' . $id );
 
-                // Filter and return.
+                /**
+                 * Filters the URL used for marking a single message thread as unread.
+                 *
+                 * @since BuddyPress (2.2.0)
+                 *
+                 * @param string $url URL used for marking a single message thread as unread.
+                 */
                 return apply_filters( 'bp_get_the_message_thread_mark_unread_url', $url );
         }
 
@@ -638 +724 @@
                 // Add the nonce.
                 $url = wp_nonce_url( $url, 'bp_message_thread_mark_read_' . $id );
 
-                // Filter and return.
+                /**
+                 * Filters the URL used for marking a single message thread as read.
+                 *
+                 * @since BuddyPress (2.2.0)
+                 *
+                 * @param string $url URL used for marking a single message thread as read.
+                 */
                 return apply_filters( 'bp_get_the_message_thread_mark_read_url', $url );
         }
 
@@ -662 +754 @@
                         $class .= 'alt';
                 }
 
+                /**
+                 * Filters the CSS class for the current thread.
+                 *
+                 * @since BuddyPress (1.2.10)
+                 *
+                 * @param string $class Class string to be added to the list of classes.
+                 */
                 return apply_filters( 'bp_get_message_css_class', trim( $class ) );
         }
 
@@ -677 +776 @@
                 ? true
                 : false;
 
+        /**
+         * Filters whether or not a message thread has unread items.
+         *
+         * @since BuddyPress (2.1.0)
+         *
+         * @param bool $retval Whether or not a message thread has unread items.
+         */
         return apply_filters( 'bp_message_thread_has_unread', $retval );
 }
 
@@ -698 +804 @@
                         ? (int) $messages_template->thread->unread_count
                         : false;
 
+                /**
+                 * Filters the current thread's unread count.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param int $count Current thread unread count.
+                 */
                 return apply_filters( 'bp_get_message_thread_unread_count', $count );
         }
 
@@ -734 +847 @@
                         $count = intval( $thread_template->message_count );
                 }
 
+                /**
+                 * Filters the current thread's total message count.
+                 *
+                 * @since BuddyPress (2.2.0)
+                 *
+                 * @param int $count Current thread total message count.
+                 */
                 return apply_filters( 'bp_get_message_thread_total_count', $count );
         }
 
@@ -782 +902 @@
         function bp_get_message_thread_last_post_date_raw() {
                 global $messages_template;
 
+                /**
+                 * Filters the unformatted date of the last post in the current thread.
+                 *
+                 * @since BuddyPress (2.1.0)
+                 *
+                 * @param string $last_message_date Unformatted date of the last post in the current thread.
+                 */
                 return apply_filters( 'bp_get_message_thread_last_message_date', $messages_template->thread->last_message_date );
         }
 
@@ -797 +924 @@
          * @return string
          */
         function bp_get_message_thread_last_post_date() {
+
+                /**
+                 * Filters the nicely formatted date of the last post in the current thread.
+                 *
+                 * @since BuddyPress (2.1.0)
+                 *
+                 * @param string $value Formatted date of the last post in the current thread.
+                 */
                 return apply_filters( 'bp_get_message_thread_last_post_date', bp_format_time( strtotime( bp_get_message_thread_last_post_date_raw() ) ) );
         }
 
@@ -844 +979 @@
                         'alt'    => $alt
                 ) );
 
+                /**
+                 * Filters the avatar for the last sender in the current message thread.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value User avatar string.
+                 */
                 return apply_filters( 'bp_get_message_thread_avatar', bp_core_fetch_avatar( array(
                         'item_id' => $messages_template->thread->last_sender_id,
                         'type'    => $r['type'],
@@ -867 +1009 @@
          * @return int
          */
         function bp_get_total_unread_messages_count() {
+
+                /**
+                 * Filters the unread messages count for the current inbox.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param int $value Unread messages count for the current inbox.
+                 */
                 return apply_filters( 'bp_get_total_unread_messages_count', BP_Messages_Thread::get_inbox_count() );
         }
 
@@ -883 +1033 @@
          */
         function bp_get_messages_pagination() {
                 global $messages_template;
+
+                /**
+                 * Filters the pagination HTML for the current thread loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param int $pag_links Pagination HTML for the current thread loop.
+                 */
                 return apply_filters( 'bp_get_messages_pagination', $messages_template->pag_links );
         }
 
@@ -932 +1090 @@
          * @return string The form action
          */
         function bp_get_messages_form_action() {
+
+                /**
+                 * Filters the form action for Messages HTML forms.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string The form action.
+                 */
                 return apply_filters( 'bp_get_messages_form_action', trailingslashit( bp_loggedin_user_domain() . bp_get_messages_slug() . '/' . bp_current_action() . '/' . bp_action_variable( 0 ) ) );
         }
 
@@ -948 +1114 @@
          */
         function bp_get_messages_username_value() {
                 if ( isset( $_COOKIE['bp_messages_send_to'] ) ) {
+
+                        /**
+                         * Filters the default username for the recipient box.
+                         *
+                         * Value passed into filter is dependent on if the 'bp_messages_send_to'
+                         * cookie or 'r' $_GET parameter is set.
+                         *
+                         * @since BuddyPress (1.0.0)
+                         *
+                         * @param string $value Default user name.
+                         */
                         return apply_filters( 'bp_get_messages_username_value', $_COOKIE['bp_messages_send_to'] );
                 } else if ( isset( $_GET['r'] ) && !isset( $_COOKIE['bp_messages_send_to'] ) ) {
+                        /** This filter is documented in bp-messages-template.php */
                         return apply_filters( 'bp_get_messages_username_value', $_GET['r'] );
                 }
         }
@@ -973 +1151 @@
                         ? $_POST['subject']
                         : '';
 
+                /**
+                 * Filters the default value for the subject field.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $subject The default value for the subject field.
+                 */
                 return apply_filters( 'bp_get_messages_subject_value', $subject );
         }
 
@@ -996 +1181 @@
                         ? $_POST['content']
                         : '';
 
+                /**
+                 * Filters the default value for the content field.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $content The default value for the content field.
+                 */
                 return apply_filters( 'bp_get_messages_content_value', $content );
         }
 
@@ -1058 +1250 @@
                 ? true
                 : false;
 
+        /**
+         * Filters whether or not the notice is currently active.
+         *
+         * @since BuddyPress (2.1.0)
+         *
+         * @param bool $retval Whether or not the notice is currently active.
+         */
         return apply_filters( 'bp_messages_is_active_notice', $retval );
 }
 
@@ -1105 +1304 @@
          */
         function bp_get_message_notice_id() {
                 global $messages_template;
+
+                /**
+                 * Filters the ID of the current notice in the loop.
+                 *
+                 * @since BuddyPress (1.5.0)
+                 *
+                 * @param int $id ID of the current notice in the loop.
+                 */
                 return apply_filters( 'bp_get_message_notice_id', $messages_template->thread->id );
         }
 
@@ -1121 +1328 @@
          */
         function bp_get_message_notice_post_date() {
                 global $messages_template;
+
+                /**
+                 * Filters the post date of the current notice in the loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value Formatted post date of the current notice in the loop.
+                 */
                 return apply_filters( 'bp_get_message_notice_post_date', bp_format_time( strtotime( $messages_template->thread->date_sent ) ) );
         }
 
@@ -1137 +1352 @@
          */
         function bp_get_message_notice_subject() {
                 global $messages_template;
+
+                /**
+                 * Filters the subject of the current notice in the loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $subject Subject of the current notice in the loop.
+                 */
                 return apply_filters( 'bp_get_message_notice_subject', $messages_template->thread->subject );
         }
 
@@ -1153 +1376 @@
          */
         function bp_get_message_notice_text() {
                 global $messages_template;
+
+                /**
+                 * Filters the text of the current notice in the loop.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $message Text for the current notice in the loop.
+                 */
                 return apply_filters( 'bp_get_message_notice_text', $messages_template->thread->message );
         }
 
@@ -1170 +1401 @@
         function bp_get_message_notice_delete_link() {
                 global $messages_template;
 
+                /**
+                 * Filters the URL for deleting the current notice.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value URL for deleting the current notice.
+                 * @param string $value Text indicating action being executed.
+                 */
                 return apply_filters( 'bp_get_message_notice_delete_link', wp_nonce_url( bp_loggedin_user_domain() . bp_get_messages_slug() . '/notices/delete/' . $messages_template->thread->id, 'messages_delete_thread' ) );
         }
 
@@ -1192 +1431 @@
                 } else {
                         $link = wp_nonce_url( trailingslashit( bp_loggedin_user_domain() . bp_get_messages_slug() . '/notices/activate/' . $messages_template->thread->id ), 'messages_activate_notice' );
                 }
+
+                /**
+                 * Filters the URL for deactivating the current notice.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $link URL for deactivating the current notice.
+                 */
                 return apply_filters( 'bp_get_message_activate_deactivate_link', $link );
         }
 
@@ -1202 +1449 @@
         echo bp_get_message_activate_deactivate_text();
 }
         /**
-         * Generate the text ('Deactivate' or 'Activate' for the notice action link.
+         * Generate the text ('Deactivate' or 'Activate') for the notice action link.
          *
          * @return string
          */
@@ -1214 +1461 @@
                 } else {
                         $text = __('Activate', 'buddypress');
                 }
+
+                /**
+                 * Filters the "Deactivate" or "Activate" text for notice action links.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $text Text used for notice action links.
+                 */
                 return apply_filters( 'bp_message_activate_deactivate_text', $text );
         }
 
@@ -1235 +1490 @@
          * @return string
          */
         function bp_get_messages_slug() {
+
+                /**
+                 * Filters the messages component slug.
+                 *
+                 * @since BuddyPress (1.5.0)
+                 *
+                 * @param string $slug Messages component slug.
+                 */
                 return apply_filters( 'bp_get_messages_slug', buddypress()->messages->slug );
         }
 
@@ -1286 +1549 @@
                         return false;
                 }
 
+                /**
+                 * Filters the URL for the Private Message link in member profile headers.
+                 *
+                 * @since BuddyPress (1.2.10)
+                 *
+                 * @param string $value URL for the Private Message link in member profile headers.
+                 */
                 return apply_filters( 'bp_get_send_private_message_link', wp_nonce_url( bp_loggedin_user_domain() . bp_get_messages_slug() . '/compose/?r=' . bp_core_get_username( bp_displayed_user_id() ) ) );
         }
 
@@ -1317 +1587 @@
                 // Note: 'bp_get_send_message_button' is a legacy filter. Use
                 // 'bp_get_send_message_button_args' instead. See #4536
                 return apply_filters( 'bp_get_send_message_button',
+                        /**
+                         * Filters the "Private Message" button for member profile headers.
+                         *
+                         * @since BuddyPress (1.8.0)
+                         *
+                         * @param array $value See {@link BP_Button}.
+                         */
                         bp_get_button( apply_filters( 'bp_get_send_message_button_args', array(
                                 'id'                => 'private_message',
                                 'component'         => 'messages',
@@ -1343 +1620 @@
          * @return string
          */
         function bp_get_message_loading_image_src() {
+
+                /**
+                 * Filters the URL of the Messages AJAX loader gif.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value URL of the Messages AJAX loader gif.
+                 */
                 return apply_filters( 'bp_get_message_loading_image_src', buddypress()->messages->image_base . '/ajax-loader.gif' );
         }
 
@@ -1385 +1670 @@
         function bp_get_message_get_recipient_usernames() {
                 $recipients = isset( $_GET['r'] ) ? stripslashes( $_GET['r'] ) : '';
 
+                /**
+                 * Filters the recipients usernames for prefilling the 'To' field on the Compose screen.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $recipients Recipients usernames for 'To' field prefilling.
+                 */
                 return apply_filters( 'bp_get_message_get_recipient_usernames', $recipients );
         }
 
@@ -1535 +1827 @@
                 if ( ( $this->current_message + 1 ) < $this->message_count ) {
                         return true;
                 } elseif ( ( $this->current_message + 1 ) === $this->message_count ) {
+
+                        /**
+                         * Fires when at the end of messages to iterate over.
+                         *
+                         * @since BuddyPress (1.1.0)
+                         */
                         do_action( 'thread_loop_end' );
                         // Do some cleaning up after the loop
                         $this->rewind_messages();
@@ -1559 +1857 @@
 
                 // loop has just started
                 if ( 0 === $this->current_message ) {
+
+                        /**
+                         * Fires if at the start of the message loop.
+                         *
+                         * @since BuddyPress (1.1.0)
+                         */
                         do_action( 'thread_loop_start' );
                 }
         }
@@ -1652 +1956 @@
         function bp_get_the_thread_id() {
                 global $thread_template;
 
+                /**
+                 * Filters the ID of the thread that the current loop belongs to.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param int $thread_id ID of the thread.
+                 */
                 return apply_filters( 'bp_get_the_thread_id', $thread_template->thread->thread_id );
         }
 
@@ -1669 +1980 @@
         function bp_get_the_thread_subject() {
                 global $thread_template;
 
+                /**
+                 * Filters the subject of the thread currently being iterated over.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @return string $last_message_subject Subject of the thread currently being iterated over.
+                 */
                 return apply_filters( 'bp_get_the_thread_subject', $thread_template->thread->last_message_subject );
         }
 
@@ -1735 +2053 @@
                         }
                 }
 
+                /**
+                 * Filters the HTML links to the profiles of recipients in the current thread.
+                 *
+                 * @since BuddyPress (2.2.0)
+                 *
+                 * @param string $value Comma-separated list of recipient HTML links for current thread.
+                 */
                 return apply_filters( 'bp_get_the_thread_recipients_list', implode( ', ', $recipient_links ) );
         }
 
@@ -1760 +2085 @@
                         ? (int) $thread_template->message->id
                         : null;
 
+                /**
+                 * Filters the ID of the current message in the thread.
+                 *
+                 * @since BuddyPress (1.9.0)
+                 *
+                 * @param int $thread_message_id ID of the current message in the thread.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_id', $thread_message_id );
         }
 
@@ -1794 +2126 @@
                         $classes[] = 'sent-by-me';
                 }
 
+                /**
+                 * Filters the CSS classes for messages within a single thread.
+                 *
+                 * @since BuddyPress (2.1.0)
+                 *
+                 * @param array $classes Array of classes to add to the HTML class attribute.
+                 */
                 $classes = apply_filters( 'bp_get_the_thread_message_css_class', $classes );
 
                 return implode( ' ', $classes );
@@ -1819 +2158 @@
                         $class = 'odd';
                 }
 
+                /**
+                 * Filters the CSS class used for message zebra striping.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $class Class determined to be next for zebra striping effect.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_alt_class', $class );
         }
 
@@ -1844 +2190 @@
                         ? $thread_template->message->sender_id
                         : 0;
 
+                /**
+                 * Filters the ID for message sender within a single thread.
+                 *
+                 * @since BuddyPress (2.1.0)
+                 *
+                 * @param int $user_id ID of the message sender.
+                 */
                 return (int) apply_filters( 'bp_get_the_thread_message_css_class', (int) $user_id );
         }
 
@@ -1877 +2230 @@
                         'height' => false,
                 ) );
 
+                /**
+                 * Filters the avatar for the current message sender.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $value <img> tag containing the avatar value.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_sender_avatar_thumb', bp_core_fetch_avatar( array(
                         'item_id' => $thread_template->message->sender_id,
                         'type'    => $r['type'],
@@ -1900 +2260 @@
         function bp_get_the_thread_message_sender_link() {
                 global $thread_template;
 
+                /**
+                 * Filters the link to the sender of the current message.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $value Link to the sender of the current message.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_sender_link', bp_core_get_userlink( $thread_template->message->sender_id, false, true ) );
         }
 
@@ -1923 +2290 @@
                         $display_name = __( 'Deleted User', 'buddypress' );
                 }
 
+                /**
+                 * Filters the display name of the sender of the current message.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $display_name Display name of the sender of the current message.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_sender_name', $display_name );
         }
 
@@ -1938 +2312 @@
          * @return string URL
          */
         function bp_get_the_thread_delete_link() {
+
+                /**
+                 * Filters the URL for deleting the current thread.
+                 *
+                 * @since BuddyPress (1.0.0)
+                 *
+                 * @param string $value URL for deleting the current thread.
+                 * @param string $value Text indicating action being executed.
+                 */
                 return apply_filters( 'bp_get_message_thread_delete_link', wp_nonce_url( bp_loggedin_user_domain() . bp_get_messages_slug() . '/inbox/delete/' . bp_get_the_thread_id(), 'messages_delete_thread' ) );
         }
 
@@ -1953 +2336 @@
          * @return string
          */
         function bp_get_the_thread_message_time_since() {
+
+                /**
+                 * Filters the 'Sent x hours ago' string for the current message.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $value Default text of 'Sent x hours ago'.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_time_since', sprintf( __( 'Sent %s', 'buddypress' ), bp_core_time_since( bp_get_the_thread_message_date_sent() ) ) );
         }
 
@@ -1975 +2366 @@
         function bp_get_the_thread_message_date_sent() {
                 global $thread_template;
 
+                /**
+                 * Filters the date sent value for the current message as a timestamp.
+                 *
+                 * @since BuddyPress (2.1.0)
+                 *
+                 * @param string $value Timestamp of the date sent value for the current message.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_date_sent', strtotime( $thread_template->message->date_sent ) );
         }
 
@@ -1992 +2390 @@
         function bp_get_the_thread_message_content() {
                 global $thread_template;
 
+                /**
+                 * Filters the content of the current message in the loop.
+                 *
+                 * @since BuddyPress (1.1.0)
+                 *
+                 * @param string $message The content of the current message in the loop.
+                 */
                 return apply_filters( 'bp_get_the_thread_message_content', $thread_template->message->message );
         }