Contents

Code Reference Functions messages_screen_conversation()

messages_screen_conversation()

Load an individual conversation screen.

Description

Return

(false|null) False on failure.

Source

File: bp-messages/screens/view.php

16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
function messages_screen_conversation() {
 
    // Bail if not viewing a single message.
    if ( ! bp_is_messages_component() || ! bp_is_current_action( 'view' ) ) {
        return false;
    }
 
    $thread_id = (int) bp_action_variable( 0 );
 
    if ( empty( $thread_id ) || ! messages_is_valid_thread( $thread_id ) ) {
        if ( is_user_logged_in() ) {
            bp_core_add_message( __( 'The conversation you tried to access is no longer available', 'buddyboss' ), 'error' );
        }
 
        bp_core_redirect( trailingslashit( bp_displayed_user_domain() . bp_get_messages_slug() ) );
    }
 
    // No access.
    if ( ( ! messages_check_thread_access( $thread_id ) || ! bp_is_my_profile() ) && ! bp_current_user_can( 'bp_moderate' ) ) {
        // If not logged in, prompt for login.
        if ( ! is_user_logged_in() ) {
            bp_core_no_access();
            return;
 
        // Redirect away.
        } else {
            bp_core_add_message( __( 'You do not have access to that conversation.', 'buddyboss' ), 'error' );
            bp_core_redirect( trailingslashit( bp_loggedin_user_domain() . bp_get_messages_slug() ) );
        }
    }
 
    // Load up BuddyPress one time.
    $bp = buddypress();
 
    // Decrease the unread count in the nav before it's rendered.
    $count    = bp_get_total_unread_messages_count();
    $class    = ( 0 === $count ) ? 'no-count' : 'count';
    $nav_name = sprintf( __( 'Messages <span class="%s">%s</span>', 'buddyboss' ), esc_attr( $class ), bp_core_number_format( $count ) );
 
    // Edit the Navigation name.
    $bp->members->nav->edit_nav( array(
        'name' => $nav_name,
    ), $bp->messages->slug );
 
    /**
     * Fires right before the loading of the Messages view screen template file.
     *
     * @since BuddyPress 1.7.0
     */
    do_action( 'messages_screen_conversation' );
 
    /**
     * Filters the template to load for the Messages view screen.
     *
     * @since BuddyPress 1.0.0
     *
     * @param string $template Path to the messages template to load.
     */
    bp_core_load_template( apply_filters( 'messages_template_view_message', 'members/single/home' ) );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
BuddyPress 1.0.0 Introduced.

Uses

Uses
Uses Description
bp-loader.php: buddypress()

The main function responsible for returning the one true BuddyBoss Instance to functions everywhere.
bp-messages/screens/view.php: messages_screen_conversation

Fires right before the loading of the Messages view screen template file.
bp-messages/screens/view.php: messages_template_view_message

Filters the template to load for the Messages view screen.
bp-messages/bp-messages-template.php: bp_get_messages_slug()

Return the messages component slug.
bp-messages/bp-messages-template.php: bp_get_total_unread_messages_count()

Get the unread messages count for the current inbox.
bp-messages/bp-messages-functions.php: messages_is_valid_thread()

Check whether a message thread exists.
bp-messages/bp-messages-functions.php: messages_check_thread_access()

Check whether a user has access to a thread.
bp-members/bp-members-template.php: bp_displayed_user_domain()

Generate the link for the displayed user’s profile.
bp-members/bp-members-template.php: bp_loggedin_user_domain()

Generate the link for the logged-in user’s profile.
bp-core/bp-core-template.php: bp_is_my_profile()

Is the current page part of the profile of the logged-in user?
bp-core/bp-core-template.php: bp_is_messages_component()

Check whether the current page is part of the Messages component.
bp-core/bp-core-template.php: bp_is_current_action()

Check to see whether the current page matches a given action.
bp-core/bp-core-template.php: bp_action_variable()

Return the value of a given action variable.
bp-core/bp-core-functions.php: bp_core_add_message()

Add a feedback (error/success) message to the WP cookie so it can be displayed after the page reloads.
bp-core/bp-core-functions.php: bp_core_redirect()

Perform a status-safe wp_redirect() that is compatible with BP’s URI parser.
bp-core/bp-core-functions.php: bp_core_number_format()

Format numbers the BuddyPress way.
bp-core/bp-core-catchuri.php: bp_core_no_access()

Redirect a user to log in for BP pages that require access control.
bp-core/bp-core-catchuri.php: bp_core_load_template()

Load a specific template file with fallback support.
Show 13 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.