File: /home/ukqcurpj/public_html/wp-content/plugins/buddypress/bp-friends/bp-friends-template.php
<?php
/**
* BuddyPress Friends Template Functions.
*
* @package BuddyPress
* @subpackage FriendsTemplate
* @since 1.5.0
*/
// Exit if accessed directly.
defined( 'ABSPATH' ) || exit;
/**
* Output the friends component slug.
*
* @since 1.5.0
*/
function bp_friends_slug() {
echo esc_attr( bp_get_friends_slug() );
}
/**
* Return the friends component slug.
*
* @since 1.5.0
*
* @return string
*/
function bp_get_friends_slug() {
/**
* Filters the friends component slug.
*
* @since 1.5.0
*
* @param string $value Friends component slug.
*/
return apply_filters( 'bp_get_friends_slug', buddypress()->friends->slug );
}
/**
* Output the friends component root slug.
*
* @since 1.5.0
*/
function bp_friends_root_slug() {
echo esc_attr( bp_get_friends_root_slug() );
}
/**
* Return the friends component root slug.
*
* @since 1.5.0
*
* @return string
*/
function bp_get_friends_root_slug() {
/**
* Filters the friends component root slug.
*
* @since 1.5.0
*
* @param string $value Friends component root slug.
*/
return apply_filters( 'bp_get_friends_root_slug', buddypress()->friends->root_slug );
}
/**
* Output the "Add Friend" button in the member loop.
*
* @since 1.2.6
*/
function bp_member_add_friend_button() {
bp_add_friend_button( bp_get_member_user_id() );
}
add_action( 'bp_directory_members_actions', 'bp_member_add_friend_button' );
/**
* Output the friend count for the current member in the loop.
*
* @since 1.2.0
*/
function bp_member_total_friend_count() {
echo esc_html( bp_get_member_total_friend_count() );
}
/**
* Return the friend count for the current member in the loop.
*
* Return value is a string of the form "x friends".
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template The main member template loop class.
*
* @return string A string of the form "x friends".
*/
function bp_get_member_total_friend_count() {
global $members_template;
$total_friend_count = (int) $members_template->member->total_friend_count;
/**
* Filters text used to denote total friend count.
*
* @since 1.2.0
*
* @param string $value String of the form "x friends".
* @param int $value Total friend count for current member in the loop.
*/
return apply_filters(
'bp_get_member_total_friend_count',
/* translators: %d: total friend count */
sprintf( _n( '%d friend', '%d friends', $total_friend_count, 'buddypress' ), number_format_i18n( $total_friend_count ) )
);
}
/**
* Output the ID of the current user in the friend request loop.
*
* @since 1.2.6
*
* @see bp_get_potential_friend_id() for a description of arguments.
*
* @param int $user_id See {@link bp_get_potential_friend_id()}.
*/
function bp_potential_friend_id( $user_id = 0 ) {
echo intval( bp_get_potential_friend_id( $user_id ) );
}
/**
* Return the ID of current user in the friend request loop.
*
* @since 1.2.6
*
* @global object $friends_template
*
* @param int $user_id Optional. If provided, the function will simply
* return this value.
* @return int ID of potential friend.
*/
function bp_get_potential_friend_id( $user_id = 0 ) {
global $friends_template;
if ( empty( $user_id ) && isset( $friends_template->friendship->friend ) ) {
$user_id = $friends_template->friendship->friend->id;
} elseif ( empty( $user_id ) && ! isset( $friends_template->friendship->friend ) ) {
$user_id = bp_displayed_user_id();
}
/**
* Filters the ID of current user in the friend request loop.
*
* @since 1.2.10
*
* @param int $user_id ID of current user in the friend request loop.
*/
return apply_filters( 'bp_get_potential_friend_id', (int) $user_id );
}
/**
* Check whether a given user is a friend of the logged-in user.
*
* Returns - 'is_friend', 'not_friends', 'pending'.
*
* @since 1.2.6
*
* @param int $user_id ID of the potential friend. Default: the value of
* {@link bp_get_potential_friend_id()}.
* @return bool|string 'is_friend', 'not_friends', or 'pending'.
*/
function bp_is_friend( $user_id = 0 ) {
if ( ! is_user_logged_in() ) {
return false;
}
if ( empty( $user_id ) ) {
$user_id = bp_get_potential_friend_id( $user_id );
}
if ( bp_loggedin_user_id() === $user_id ) {
return false;
}
/**
* Filters the status of friendship between logged in user and given user.
*
* @since 1.2.10
*
* @param string $value String status of friendship. Possible values are 'is_friend', 'not_friends', 'pending'.
* @param int $user_id ID of the potential friend.
*/
return apply_filters( 'bp_is_friend', friends_check_friendship_status( bp_loggedin_user_id(), $user_id ), $user_id );
}
/**
* Output the Add Friend button.
*
* @since 1.0.0
*
* @see bp_get_add_friend_button() for information on arguments.
*
* @param int $potential_friend_id See {@link bp_get_add_friend_button()}.
* @param int|bool $friend_status See {@link bp_get_add_friend_button()}.
*/
function bp_add_friend_button( $potential_friend_id = 0, $friend_status = false ) {
// Escaping is done in `BP_Core_HTML_Element()`.
// phpcs:ignore WordPress.Security.EscapeOutput
echo bp_get_add_friend_button( $potential_friend_id, $friend_status );
}
/**
* Build friend button arguments.
*
* @since 11.0.0
*
* @param int $potential_friend_id The user ID of the potential friend.
* @return array The friend button arguments.
*/
function bp_get_add_friend_button_args( $potential_friend_id = 0 ) {
$button_args = array();
if ( empty( $potential_friend_id ) ) {
$potential_friend_id = bp_get_potential_friend_id( $potential_friend_id );
}
$friendship_status = bp_is_friend( $potential_friend_id );
$friends_slug = bp_get_friends_slug();
if ( empty( $friendship_status ) ) {
return $button_args;
}
switch ( $friendship_status ) {
case 'pending':
$button_args = array(
'id' => 'pending',
'component' => 'friends',
'must_be_logged_in' => true,
'block_self' => true,
'wrapper_class' => 'friendship-button pending_friend',
'wrapper_id' => 'friendship-button-' . $potential_friend_id,
'link_href' => wp_nonce_url(
bp_loggedin_user_url( bp_members_get_path_chunks( array( $friends_slug, 'requests', array( 'cancel', $potential_friend_id ) ) ) ),
'friends_withdraw_friendship'
),
'link_text' => __( 'Cancel Friendship Request', 'buddypress' ),
'link_title' => __( 'Cancel Friendship Requested', 'buddypress' ),
'link_id' => 'friend-' . $potential_friend_id,
'link_rel' => 'remove',
'link_class' => 'friendship-button pending_friend requested',
);
break;
case 'awaiting_response':
$button_args = array(
'id' => 'awaiting_response',
'component' => 'friends',
'must_be_logged_in' => true,
'block_self' => true,
'wrapper_class' => 'friendship-button awaiting_response_friend',
'wrapper_id' => 'friendship-button-' . $potential_friend_id,
'link_href' => bp_loggedin_user_url( bp_members_get_path_chunks( array( $friends_slug, 'requests' ) ) ),
'link_text' => __( 'Friendship Requested', 'buddypress' ),
'link_title' => __( 'Friendship Requested', 'buddypress' ),
'link_id' => 'friend-' . $potential_friend_id,
'link_rel' => 'remove',
'link_class' => 'friendship-button awaiting_response_friend requested',
);
break;
case 'is_friend':
$button_args = array(
'id' => 'is_friend',
'component' => 'friends',
'must_be_logged_in' => true,
'block_self' => false,
'wrapper_class' => 'friendship-button is_friend',
'wrapper_id' => 'friendship-button-' . $potential_friend_id,
'link_href' => wp_nonce_url(
bp_loggedin_user_url( bp_members_get_path_chunks( array( $friends_slug, 'remove-friend', array( $potential_friend_id ) ) ) ),
'friends_remove_friend'
),
'link_text' => __( 'Cancel Friendship', 'buddypress' ),
'link_title' => __( 'Cancel Friendship', 'buddypress' ),
'link_id' => 'friend-' . $potential_friend_id,
'link_rel' => 'remove',
'link_class' => 'friendship-button is_friend remove',
);
break;
default:
$button_args = array(
'id' => 'not_friends',
'component' => 'friends',
'must_be_logged_in' => true,
'block_self' => true,
'wrapper_class' => 'friendship-button not_friends',
'wrapper_id' => 'friendship-button-' . $potential_friend_id,
'link_href' => wp_nonce_url(
bp_loggedin_user_url( bp_members_get_path_chunks( array( $friends_slug, 'add-friend', array( $potential_friend_id ) ) ) ),
'friends_add_friend'
),
'link_text' => __( 'Add Friend', 'buddypress' ),
'link_title' => __( 'Add Friend', 'buddypress' ),
'link_id' => 'friend-' . $potential_friend_id,
'link_rel' => 'add',
'link_class' => 'friendship-button not_friends add',
);
break;
}
/**
* Filters the HTML for the add friend button.
*
* @since 1.1.0
*
* @param array $button_args Button arguments for add friend button.
*/
return (array) apply_filters( 'bp_get_add_friend_button', $button_args );
}
/**
* Create the Add Friend button.
*
* @since 1.1.0
* @since 11.0.0 uses `bp_get_add_friend_button_args()`.
*
* @param int $potential_friend_id ID of the user to whom the button
* applies. Default: value of {@link bp_get_potential_friend_id()}.
* @param bool $friend_status Not currently used.
* @return bool|string HTML for the Add Friend button. False if already friends.
*/
function bp_get_add_friend_button( $potential_friend_id = 0, $friend_status = false ) {
$button_args = bp_get_add_friend_button_args( $potential_friend_id );
if ( ! array_filter( $button_args ) ) {
return false;
}
return bp_get_button( $button_args );
}
/**
* Get a comma-separated list of IDs of a user's friends.
*
* @since 1.2.0
*
* @param int $user_id Optional. Default: the displayed user's ID, or the
* logged-in user's ID.
* @return bool|string A comma-separated list of friend IDs if any are found,
* otherwise false.
*/
function bp_get_friend_ids( $user_id = 0 ) {
if ( empty( $user_id ) ) {
$user_id = ( bp_displayed_user_id() ) ? bp_displayed_user_id() : bp_loggedin_user_id();
}
$friend_ids = friends_get_friend_user_ids( $user_id );
if ( empty( $friend_ids ) ) {
return false;
}
return implode( ',', friends_get_friend_user_ids( $user_id ) );
}
/**
* Get a user's friendship requests.
*
* Note that we return a 0 if no pending requests are found. This is necessary
* because of the structure of the $include parameter in bp_has_members().
*
* @since 1.2.0
*
* @param int $user_id ID of the user whose requests are being retrieved.
* Defaults to displayed user.
* @return array|int An array of user IDs if found, or a 0 if none are found.
*/
function bp_get_friendship_requests( $user_id = 0 ) {
if ( ! $user_id ) {
$user_id = bp_displayed_user_id();
}
if ( ! $user_id ) {
return 0;
}
$requests = friends_get_friendship_request_user_ids( $user_id );
if ( ! empty( $requests ) ) {
$requests = implode( ',', (array) $requests );
} else {
$requests = 0;
}
/**
* Filters the total pending friendship requests for a user.
*
* @since 1.2.0
* @since 2.6.0 Added the `$user_id` parameter.
*
* @param array|int $requests An array of user IDs if found, or a 0 if none are found.
* @param int $user_id ID of the queried user.
*/
return apply_filters( 'bp_get_friendship_requests', $requests, $user_id );
}
/**
* Output the ID of the friendship between the logged-in user and the current user in the loop.
*
* @since 1.2.0
*/
function bp_friend_friendship_id() {
echo intval( bp_get_friend_friendship_id() );
}
/**
* Return the ID of the friendship between the logged-in user and the current user in the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template The main member template loop class.
*
* @return int ID of the friendship.
*/
function bp_get_friend_friendship_id() {
global $members_template;
if ( ! $friendship_id = wp_cache_get( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), 'bp' ) ) {
$friendship_id = friends_get_friendship_id( $members_template->member->id, bp_loggedin_user_id() );
wp_cache_set( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), $friendship_id, 'bp' );
}
/**
* Filters the ID of the friendship between the logged in user and the current user in the loop.
*
* @since 1.2.0
*
* @param int $friendship_id ID of the friendship.
*/
return apply_filters( 'bp_get_friend_friendship_id', $friendship_id );
}
/**
* Output the URL for accepting the current friendship request in the loop.
*
* @since 1.0.0
*/
function bp_friend_accept_request_link() {
echo esc_url( bp_get_friend_accept_request_link() );
}
/**
* Return the URL for accepting the current friendship request in the loop.
*
* @since 1.0.0
*
* @global BP_Core_Members_Template $members_template The main member template loop class.
*
* @return string accept-friendship URL.
*/
function bp_get_friend_accept_request_link() {
global $members_template;
if ( ! $friendship_id = wp_cache_get( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), 'bp' ) ) {
$friendship_id = friends_get_friendship_id( $members_template->member->id, bp_loggedin_user_id() );
wp_cache_set( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), $friendship_id, 'bp' );
}
$url = wp_nonce_url(
bp_loggedin_user_url( bp_members_get_path_chunks( array( bp_get_friends_slug(), 'requests', array( 'accept', $friendship_id ) ) ) ),
'friends_accept_friendship'
);
/**
* Filters the URL for accepting the current friendship request in the loop.
*
* @since 1.0.0
* @since 2.6.0 Added the `$friendship_id` parameter.
*
* @param string $url Accept-friendship URL.
* @param int $friendship_id ID of the friendship.
*/
return apply_filters( 'bp_get_friend_accept_request_link', $url, $friendship_id );
}
/**
* Output the URL for rejecting the current friendship request in the loop.
*
* @since 1.0.0
*/
function bp_friend_reject_request_link() {
echo esc_url( bp_get_friend_reject_request_link() );
}
/**
* Return the URL for rejecting the current friendship request in the loop.
*
* @since 1.0.0
*
* @global BP_Core_Members_Template $members_template The main member template loop class.
*
* @return string reject-friendship URL.
*/
function bp_get_friend_reject_request_link() {
global $members_template;
if ( ! $friendship_id = wp_cache_get( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), 'bp' ) ) {
$friendship_id = friends_get_friendship_id( $members_template->member->id, bp_loggedin_user_id() );
wp_cache_set( 'friendship_id_' . $members_template->member->id . '_' . bp_loggedin_user_id(), $friendship_id, 'bp' );
}
$url = wp_nonce_url(
bp_loggedin_user_url( bp_members_get_path_chunks( array( bp_get_friends_slug(), 'requests', array( 'reject', $friendship_id ) ) ) ),
'friends_reject_friendship'
);
/**
* Filters the URL for rejecting the current friendship request in the loop.
*
* @since 1.0.0
* @since 2.6.0 Added the `$friendship_id` parameter.
*
* @param string $url Reject-friendship URL.
* @param int $friendship_id ID of the friendship.
*/
return apply_filters( 'bp_get_friend_reject_request_link', $url, $friendship_id );
}
/**
* Output the total friend count for a given user.
*
* @since 1.2.0
*
* @param int $user_id See {@link friends_get_total_friend_count()}.
*/
function bp_total_friend_count( $user_id = 0 ) {
echo intval( bp_get_total_friend_count( $user_id ) );
}
/**
* Return the total friend count for a given user.
*
* @since 1.2.0
*
* @param int $user_id See {@link friends_get_total_friend_count()}.
* @return int Total friend count.
*/
function bp_get_total_friend_count( $user_id = 0 ) {
/**
* Filters the total friend count for a given user.
*
* @since 1.2.0
* @since 2.6.0 Added the `$user_id` parameter.
*
* @param int $value Total friend count.
* @param int $user_id ID of the queried user.
*/
return apply_filters( 'bp_get_total_friend_count', friends_get_total_friend_count( $user_id ), $user_id );
}
/**
* Output the total friendship request count for a given user.
*
* @since 1.2.0
*
* @param int $user_id ID of the user whose requests are being counted.
* Default: ID of the logged-in user.
*/
function bp_friend_total_requests_count( $user_id = 0 ) {
echo intval( bp_friend_get_total_requests_count( $user_id ) );
}
/**
* Return the total friendship request count for a given user.
*
* @since 1.2.0
*
* @param int $user_id ID of the user whose requests are being counted.
* Default: ID of the logged-in user.
* @return int Friend count.
*/
function bp_friend_get_total_requests_count( $user_id = 0 ) {
if ( empty( $user_id ) ) {
$user_id = bp_loggedin_user_id();
}
/**
* Filters the total friendship request count for a given user.
*
* @since 1.2.0
* @since 2.6.0 Added the `$user_id` parameter.
*
* @param int $value Friendship request count.
* @param int $user_id ID of the queried user.
*/
return apply_filters( 'bp_friend_get_total_requests_count', count( BP_Friends_Friendship::get_friend_user_ids( $user_id, true ) ), $user_id );
}
/** Stats **********************************************************************/
/**
* Display the number of friends in user's profile.
*
* @since 2.0.0
*
* @param array|string $args before|after|user_id.
*/
function bp_friends_profile_stats( $args = '' ) {
echo wp_kses(
bp_friends_get_profile_stats( $args ),
array(
'li' => array( 'class' => true ),
'div' => array( 'class' => true ),
'strong' => true,
'a' => array( 'href' => true ),
)
);
}
add_action( 'bp_members_admin_user_stats', 'bp_friends_profile_stats', 7, 1 );
/**
* Return the number of friends in user's profile.
*
* @since 2.0.0
*
* @param array|string $args before|after|user_id.
* @return string HTML for stats output.
*/
function bp_friends_get_profile_stats( $args = '' ) {
// Parse the args.
$r = bp_parse_args(
$args,
array(
'before' => '<li class="bp-friends-profile-stats">',
'after' => '</li>',
'user_id' => bp_displayed_user_id(),
'friends' => 0,
'output' => '',
),
'friends_get_profile_stats'
);
// Allow completely overloaded output.
if ( empty( $r['output'] ) ) {
// Only proceed if a user ID was passed.
if ( ! empty( $r['user_id'] ) ) {
// Get the user's friends.
if ( empty( $r['friends'] ) ) {
$r['friends'] = absint( friends_get_total_friend_count( $r['user_id'] ) );
}
// If friends exist, show some formatted output.
$r['output'] = $r['before'];
/* translators: %s: total friend count */
$r['output'] .= sprintf( _n( '%s friend', '%s friends', $r['friends'], 'buddypress' ), '<strong>' . number_format_i18n( $r['friends'] ) . '</strong>' );
$r['output'] .= $r['after'];
}
}
/**
* Filters the number of friends in user's profile.
*
* @since 2.0.0
*
* @param string $value Formatted string displaying total friends count.
* @param array $r Array of arguments for string formatting and output.
*/
return apply_filters( 'bp_friends_get_profile_stats', $r['output'], $r );
}