Contents

Code Reference Functions friends_get_newest()

friends_get_newest( int $user_id, int $per_page, int $page, string $filter = '' )

Get a user’s friends, in the order in which they joined the site.

Description

See also

Parameters

$user_id

(Required) ID of the user whose friends are being retrieved.

$per_page

(Optional) Number of results to return per page. Default: 0 (no pagination; show all results).

$page

(Optional) Number of the page of results to return. Default: 0 (no pagination; show all results).

$filter

(Optional) Limit results to those matching a search string.

Default value: ''

Return

(array) See BP_Core_User::get_users().

Source

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

504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
function friends_get_newest( $user_id, $per_page = 0, $page = 0, $filter = '' ) {
    $friends = bp_core_get_users( array(
        'type'         => 'newest',
        'per_page'     => $per_page,
        'page'         => $page,
        'user_id'      => $user_id,
        'search_terms' => $filter,
    ) );
 
    /**
     * Filters a user's friends listed from newest to oldest.
     *
     * @since BuddyPress 1.2.0
     *
     * @param array $friends {
     *     @type int   $total_users Total number of users matched by query params.
     *     @type array $paged_users The current page of users matched by query params.
     * }
     */
    return apply_filters( 'friends_get_newest', $friends );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
BuddyPress 1.0.0 Introduced.

Uses

Uses
Uses Description
bp-members/bp-members-functions.php: bp_core_get_users()

Fetch an array of users based on the parameters passed.
bp-friends/bp-friends-functions.php: friends_get_newest

Filters a user’s friends listed from newest to oldest.

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.