profile->slug );
}
/**
* Output the members component slug.
*
* @since 1.5.0
*/
function bp_members_slug() {
echo bp_get_members_slug();
}
/**
* Return the members component slug.
*
* @since 1.5.0
*
* @return string
*/
function bp_get_members_slug() {
/**
* Filters the Members component slug.
*
* @since 1.5.0
*
* @param string $slug Members component slug.
*/
return apply_filters( 'bp_get_members_slug', buddypress()->members->slug );
}
/**
* Output the members component root slug.
*
* @since 1.5.0
*/
function bp_members_root_slug() {
echo bp_get_members_root_slug();
}
/**
* Return the members component root slug.
*
* @since 1.5.0
*
* @return string
*/
function bp_get_members_root_slug() {
/**
* Filters the Members component root slug.
*
* @since 1.5.0
*
* @param string $root_slug Members component root slug.
*/
return apply_filters( 'bp_get_members_root_slug', buddypress()->members->root_slug );
}
/**
* Output the member type base slug.
*
* @since 2.5.0
*/
function bp_members_member_type_base() {
echo esc_url( bp_get_members_member_type_base() );
}
/**
* Get the member type URL base.
*
* The base slug is the string used as the base prefix when generating member type directory URLs.
* For example, in example.com/members/type/foo/, 'foo' is the member type and 'type' is the
* base slug.
*
* @since 2.5.0
*
* @return string
*/
function bp_get_members_member_type_base() {
/**
* Filters the member type URL base.
*
* @since 2.3.0
*
* @param string $base Base slug for the member type.
*/
return apply_filters( 'bp_members_member_type_base', _x( 'type', 'member type URL base', 'buddypress' ) );
}
/**
* Output member directory permalink.
*
* @since 1.5.0
*/
function bp_members_directory_permalink() {
echo esc_url( bp_get_members_directory_permalink() );
}
/**
* Return member directory permalink.
*
* @since 1.5.0
*
* @return string
*/
function bp_get_members_directory_permalink() {
/**
* Filters the member directory permalink.
*
* @since 1.5.0
*
* @param string $value Members directory permalink.
*/
return apply_filters( 'bp_get_members_directory_permalink', trailingslashit( bp_get_root_domain() . '/' . bp_get_members_root_slug() ) );
}
/**
* Output member type directory permalink.
*
* @since 2.5.0
*
* @param string $member_type Optional. Member type. Defaults to current member type.
*/
function bp_member_type_directory_permalink( $member_type = '' ) {
echo esc_url( bp_get_member_type_directory_permalink( $member_type ) );
}
/**
* Return member type directory permalink.
*
* @since 2.5.0
*
* @param string $member_type Optional. Member type. Defaults to current member type.
* @return string Member type directory URL on success, an empty string on failure.
*/
function bp_get_member_type_directory_permalink( $member_type = '' ) {
if ( $member_type ) {
$_member_type = $member_type;
} else {
// Fall back on the current member type.
$_member_type = bp_get_current_member_type();
}
$type = bp_get_member_type_object( $_member_type );
// Bail when member type is not found or has no directory.
if ( ! $type || ! $type->has_directory ) {
return '';
}
/**
* Filters the member type directory permalink.
*
* @since 2.5.0
*
* @param string $value Member type directory permalink.
* @param object $type Member type object.
* @param string $member_type Member type name, as passed to the function.
*/
return apply_filters( 'bp_get_member_type_directory_permalink', trailingslashit( bp_get_members_directory_permalink() . bp_get_members_member_type_base() . '/' . $type->directory_slug ), $type, $member_type );
}
/**
* Output the sign-up slug.
*
* @since 1.5.0
*/
function bp_signup_slug() {
echo bp_get_signup_slug();
}
/**
* Return the sign-up slug.
*
* @since 1.5.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return string
*/
function bp_get_signup_slug() {
$bp = buddypress();
if ( ! empty( $bp->pages->register->slug ) ) {
$slug = $bp->pages->register->slug;
} elseif ( defined( 'BP_REGISTER_SLUG' ) ) {
$slug = BP_REGISTER_SLUG;
} else {
$slug = 'register';
}
/**
* Filters the sign-up slug.
*
* @since 1.5.0
*
* @param string $slug Sign-up slug.
*/
return apply_filters( 'bp_get_signup_slug', $slug );
}
/**
* Output the activation slug.
*
* @since 1.5.0
*/
function bp_activate_slug() {
echo bp_get_activate_slug();
}
/**
* Return the activation slug.
*
* @since 1.5.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return string
*/
function bp_get_activate_slug() {
$bp = buddypress();
if ( ! empty( $bp->pages->activate->slug ) ) {
$slug = $bp->pages->activate->slug;
} elseif ( defined( 'BP_ACTIVATION_SLUG' ) ) {
$slug = BP_ACTIVATION_SLUG;
} else {
$slug = 'activate';
}
/**
* Filters the activation slug.
*
* @since 1.5.0
*
* @param string $slug Activation slug.
*/
return apply_filters( 'bp_get_activate_slug', $slug );
}
/**
* Output the members invitation pane slug.
*
* @since 8.0.0
*/
function bp_members_invitations_slug() {
echo bp_get_members_invitations_slug();
}
/**
* Return the members invitations root slug.
*
* @since 8.0.0
*
* @return string
*/
function bp_get_members_invitations_slug() {
/**
* Filters the Members invitations pane root slug.
*
* @since 8.0.0
*
* @param string $slug Members invitations pane root slug.
*/
return apply_filters( 'bp_get_members_invitations_slug', _x( 'invitations', 'Member profile invitations pane URL base', 'buddypress' ) );
}
/**
* Initialize the members loop.
*
* Based on the $args passed, bp_has_members() populates the $members_template
* global, enabling the use of BuddyPress templates and template functions to
* display a list of members.
*
* @since 1.2.0
* @since 7.0.0 Added `xprofile_query` parameter. Added `user_ids` parameter.
* @since 10.0.0 Added `date_query` parameter.
*
* @global BP_Core_Members_Template $members_template
*
* @param array|string $args {
* Arguments for limiting the contents of the members loop. Most arguments
* are in the same format as {@link BP_User_Query}. However, because
* the format of the arguments accepted here differs in a number of ways,
* and because bp_has_members() determines some default arguments in a
* dynamic fashion, we list all accepted arguments here as well.
*
* Arguments can be passed as an associative array, or as a URL query
* string (eg, 'user_id=4&per_page=3').
*
* @type int $type Sort order. Accepts 'active', 'random', 'newest', 'popular',
* 'online', 'alphabetical'. Default: 'active'.
* @type int|bool $page Page of results to display. Default: 1.
* @type int|bool $per_page Number of results per page. Default: 20.
* @type int|bool $max Maximum number of results to return. Default: false (unlimited).
* @type string $page_arg The string used as a query parameter in pagination links.
* Default: 'bpage'.
* @type array|int|string|bool $include Limit results by a list of user IDs. Accepts an array, a
* single integer, a comma-separated list of IDs, or false (to
* disable this limiting). Accepts 'active', 'alphabetical',
* 'newest', or 'random'. Default: false.
* @type array|int|string|bool $exclude Exclude users from results by ID. Accepts an array, a single
* integer, a comma-separated list of IDs, or false (to disable
* this limiting). Default: false.
* @type array|string|bool $user_ids An array or comma-separated list of IDs, or false (to
* disable this limiting). Default: false.
* @type int $user_id If provided, results are limited to the friends of the specified
* user. When on a user's Friends page, defaults to the ID of the
* displayed user. Otherwise defaults to 0.
* @type string|array $member_type Array or comma-separated list of member types to limit
* results to.
* @type string|array $member_type__in Array or comma-separated list of member types to limit
* results to.
* @type string|array $member_type__not_in Array or comma-separated list of member types to exclude
* from results.
* @type string $search_terms Limit results by a search term. Default: value of
* `$_REQUEST['members_search']` or `$_REQUEST['s']`, if present.
* Otherwise false.
* @type string $meta_key Limit results by the presence of a usermeta key.
* Default: false.
* @type mixed $meta_value When used with meta_key, limits results by the a matching
* usermeta value. Default: false.
* @type array $xprofile_query Filter results by xprofile data. Requires the xprofile
* component. See {@see BP_XProfile_Query} for details.
* @type array $date_query Filter results by member last activity date. See first parameter of
* {@link WP_Date_Query::__construct()} for syntax. Only applicable if
* $type is either 'active', 'random', 'newest', or 'online'.
* @type bool $populate_extras Whether to fetch optional data, such as friend counts.
* Default: true.
* }
* @return bool Returns true when blogs are found, otherwise false.
*/
function bp_has_members( $args = '' ) {
global $members_template;
// Default user ID.
$user_id = 0;
// User filtering.
if ( bp_is_user_friends() && ! bp_is_user_friend_requests() ) {
$user_id = bp_displayed_user_id();
}
$member_type = bp_get_current_member_type();
if ( ! $member_type && ! empty( $_GET['member_type'] ) ) {
if ( is_array( $_GET['member_type'] ) ) {
$member_type = $_GET['member_type'];
} else {
// Can be a comma-separated list.
$member_type = explode( ',', $_GET['member_type'] );
}
}
$search_terms_default = null;
$search_query_arg = bp_core_get_component_search_query_arg( 'members' );
if ( ! empty( $_REQUEST[ $search_query_arg ] ) ) {
$search_terms_default = stripslashes( $_REQUEST[ $search_query_arg ] );
}
// Type: active ( default ) | random | newest | popular | online | alphabetical.
$r = bp_parse_args(
$args,
array(
'type' => 'active',
'page' => 1,
'per_page' => 20,
'max' => false,
'page_arg' => 'upage', // See https://buddypress.trac.wordpress.org/ticket/3679.
'include' => false, // Pass a user_id or a list (comma-separated or array) of user_ids to only show these users.
'exclude' => false, // Pass a user_id or a list (comma-separated or array) of user_ids to exclude these users.
'user_ids' => false,
'user_id' => $user_id, // Pass a user_id to only show friends of this user.
'member_type' => $member_type,
'member_type__in' => '',
'member_type__not_in' => '',
'search_terms' => $search_terms_default,
'meta_key' => false, // Only return users with this usermeta.
'meta_value' => false, // Only return users where the usermeta value matches. Requires meta_key.
'xprofile_query' => false,
'date_query' => false, // Filter members by last activity.
'populate_extras' => true, // Fetch usermeta? Friend count, last active etc.
),
'has_members'
);
// Pass a filter if ?s= is set.
if ( is_null( $r['search_terms'] ) ) {
if ( !empty( $_REQUEST['s'] ) ) {
$r['search_terms'] = $_REQUEST['s'];
} else {
$r['search_terms'] = false;
}
}
// Set per_page to max if max is larger than per_page.
if ( !empty( $r['max'] ) && ( $r['per_page'] > $r['max'] ) ) {
$r['per_page'] = $r['max'];
}
// Query for members and populate $members_template global.
$members_template = new BP_Core_Members_Template( $r );
/**
* Filters whether or not BuddyPress has members to iterate over.
*
* @since 1.2.4
* @since 2.6.0 Added the `$r` parameter
*
* @param bool $value Whether or not there are members to iterate over.
* @param BP_Core_Members_Template $members_template Populated $members_template global.
* @param array $r Array of arguments passed into the BP_Core_Members_Template class.
*/
return apply_filters( 'bp_has_members', $members_template->has_members(), $members_template, $r );
}
/**
* Set up the current member inside the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return object
*/
function bp_the_member() {
global $members_template;
return $members_template->the_member();
}
/**
* Check whether there are more members to iterate over.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return bool
*/
function bp_members() {
global $members_template;
return $members_template->members();
}
/**
* Output the members pagination count.
*
* @since 1.2.0
*/
function bp_members_pagination_count() {
echo bp_get_members_pagination_count();
}
/**
* Generate the members pagination count.
*
* @since 1.5.0
*
* @global BP_Core_Members_Template $members_template
*
* @return string
*/
function bp_get_members_pagination_count() {
global $members_template;
if ( empty( $members_template->type ) ) {
$members_template->type = '';
}
$start_num = intval( ( $members_template->pag_page - 1 ) * $members_template->pag_num ) + 1;
$from_num = bp_core_number_format( $start_num );
$to_num = bp_core_number_format( ( $start_num + ( $members_template->pag_num - 1 ) > $members_template->total_member_count ) ? $members_template->total_member_count : $start_num + ( $members_template->pag_num - 1 ) );
$total = bp_core_number_format( $members_template->total_member_count );
if ( 'active' == $members_template->type ) {
if ( 1 == $members_template->total_member_count ) {
$pag = __( 'Viewing 1 active member', 'buddypress' );
} else {
/* translators: 1: active member from number. 2: active member to number. 3: total active members. */
$pag = sprintf( _n( 'Viewing %1$s - %2$s of %3$s active member', 'Viewing %1$s - %2$s of %3$s active members', $members_template->total_member_count, 'buddypress' ), $from_num, $to_num, $total );
}
} elseif ( 'popular' == $members_template->type ) {
if ( 1 == $members_template->total_member_count ) {
$pag = __( 'Viewing 1 member with friends', 'buddypress' );
} else {
/* translators: 1: member with friends from number. 2: member with friends to number. 3: total members with friends. */
$pag = sprintf( _n( 'Viewing %1$s - %2$s of %3$s member with friends', 'Viewing %1$s - %2$s of %3$s members with friends', $members_template->total_member_count, 'buddypress' ), $from_num, $to_num, $total );
}
} elseif ( 'online' == $members_template->type ) {
if ( 1 == $members_template->total_member_count ) {
$pag = __( 'Viewing 1 online member', 'buddypress' );
} else {
/* translators: 1: online member from number. 2: online member to number. 3: total online members. */
$pag = sprintf( _n( 'Viewing %1$s - %2$s of %3$s online member', 'Viewing %1$s - %2$s of %3$s online members', $members_template->total_member_count, 'buddypress' ), $from_num, $to_num, $total );
}
} else {
if ( 1 == $members_template->total_member_count ) {
$pag = __( 'Viewing 1 member', 'buddypress' );
} else {
/* translators: 1: member from number. 2: member to number. 3: total members. */
$pag = sprintf( _n( 'Viewing %1$s - %2$s of %3$s member', 'Viewing %1$s - %2$s of %3$s members', $members_template->total_member_count, 'buddypress' ), $from_num, $to_num, $total );
}
}
/**
* Filters the members pagination count.
*
* @since 1.5.0
*
* @param string $pag Pagination count string.
*/
return apply_filters( 'bp_members_pagination_count', $pag );
}
/**
* Output the members pagination links.
*
* @since 1.2.0
*/
function bp_members_pagination_links() {
echo bp_get_members_pagination_links();
}
/**
* Fetch the members pagination links.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return string
*/
function bp_get_members_pagination_links() {
global $members_template;
/**
* Filters the members pagination link.
*
* @since 1.2.0
*
* @param string $pag_links HTML markup for pagination links.
*/
return apply_filters( 'bp_get_members_pagination_links', $members_template->pag_links );
}
/**
* Output the ID of the current member in the loop.
*
* @since 1.2.0
*/
function bp_member_user_id() {
echo bp_get_member_user_id();
}
/**
* Get the ID of the current member in the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return int Member ID.
*/
function bp_get_member_user_id() {
global $members_template;
$member_id = isset( $members_template->member->id )
? (int) $members_template->member->id
: 0;
/**
* Filters the ID of the current member in the loop.
*
* @since 1.2.0
*
* @param int $member_id ID of the member being iterated over.
*/
return apply_filters( 'bp_get_member_user_id', (int) $member_id );
}
/**
* Output the row class of the current member in the loop.
*
* @since 1.7.0
*
* @param array $classes Array of custom classes.
*/
function bp_member_class( $classes = array() ) {
echo bp_get_member_class( $classes );
}
/**
* Return the row class of the current member in the loop.
*
* @since 1.7.0
*
* @global BP_Core_Members_Template $members_template
*
* @param array $classes Array of custom classes.
*
* @return string Row class of the member
*/
function bp_get_member_class( $classes = array() ) {
global $members_template;
// Add even/odd classes, but only if there's more than 1 member.
if ( $members_template->member_count > 1 ) {
$pos_in_loop = (int) $members_template->current_member;
$classes[] = ( $pos_in_loop % 2 ) ? 'even' : 'odd';
// If we've only one member in the loop, don't bother with odd and even.
} else {
$classes[] = 'bp-single-member';
}
// Maybe add 'is-online' class.
if ( ! empty( $members_template->member->last_activity ) ) {
// Calculate some times.
$current_time = bp_core_current_time( true, 'timestamp' );
$last_activity = strtotime( $members_template->member->last_activity );
$still_online = strtotime( '+5 minutes', $last_activity );
// Has the user been active recently?
if ( $current_time <= $still_online ) {
$classes[] = 'is-online';
}
}
// Add current user class.
if ( bp_loggedin_user_id() === (int) $members_template->member->id ) {
$classes[] = 'is-current-user';
}
// Add current user member types.
if ( $member_types = bp_get_member_type( $members_template->member->id, false ) ) {
foreach ( $member_types as $member_type ) {
$classes[] = sprintf( 'member-type-%s', esc_attr( $member_type ) );
}
}
/**
* Filters the determined classes to add to the HTML element.
*
* @since 1.7.0
*
* @param string $classes Classes to be added to the HTML element.
*/
$classes = apply_filters( 'bp_get_member_class', $classes );
$classes = array_merge( $classes, array() );
$retval = 'class="' . join( ' ', $classes ) . '"';
return $retval;
}
/**
* Output nicename of current member in the loop.
*
* @since 1.2.5
*/
function bp_member_user_nicename() {
echo bp_get_member_user_nicename();
}
/**
* Get the nicename of the current member in the loop.
*
* @since 1.2.5
*
* @global BP_Core_Members_Template $members_template
*
* @return string Members nicename.
*/
function bp_get_member_user_nicename() {
global $members_template;
/**
* Filters the nicename of the current member in the loop.
*
* @since 1.2.5
*
* @param string $user_nicename Nicename for the current member.
*/
return apply_filters( 'bp_get_member_user_nicename', $members_template->member->user_nicename );
}
/**
* Output login for current member in the loop.
*
* @since 1.2.5
*/
function bp_member_user_login() {
echo bp_get_member_user_login();
}
/**
* Get the login of the current member in the loop.
*
* @since 1.2.5
*
* @global BP_Core_Members_Template $members_template
*
* @return string Member's login.
*/
function bp_get_member_user_login() {
global $members_template;
/**
* Filters the login of the current member in the loop.
*
* @since 1.2.5
*
* @param string $user_login Login for the current member.
*/
return apply_filters( 'bp_get_member_user_login', $members_template->member->user_login );
}
/**
* Output the email address for the current member in the loop.
*
* @since 1.2.5
*/
function bp_member_user_email() {
echo bp_get_member_user_email();
}
/**
* Get the email address of the current member in the loop.
*
* @since 1.2.5
*
* @global BP_Core_Members_Template $members_template
*
* @return string Member's email address.
*/
function bp_get_member_user_email() {
global $members_template;
/**
* Filters the email address of the current member in the loop.
*
* @since 1.2.5
*
* @param string $user_email Email address for the current member.
*/
return apply_filters( 'bp_get_member_user_email', $members_template->member->user_email );
}
/**
* Check whether the current member in the loop is the logged-in user.
*
* @since 1.2.5
* @since 10.0.0 Updated to get member ID from `bp_get_member_user_id`.
*
* @return bool
*/
function bp_member_is_loggedin_user() {
/**
* Filters whether the current member in the loop is the logged-in user.
*
* @since 1.2.5
*
* @param bool $value Whether current member in the loop is logged in.
*/
return apply_filters( 'bp_member_is_loggedin_user', ( bp_loggedin_user_id() === bp_get_member_user_id() ) );
}
/**
* Output a member's avatar.
*
* @since 1.2.0
*
* @see bp_get_member_avatar() for description of arguments.
*
* @param array|string $args See {@link bp_get_member_avatar()}.
*/
function bp_member_avatar( $args = '' ) {
/**
* Filters a members avatar.
*
* @since 1.2.0
* @since 2.6.0 Added the `$args` parameter.
*
* @param string $value Formatted HTML element, or raw avatar URL based on $html arg.
* @param array|string $args See {@link bp_get_member_avatar()}.
*/
echo apply_filters( 'bp_member_avatar', bp_get_member_avatar( $args ), $args );
}
/**
* Get a member's avatar.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @see bp_core_fetch_avatar() For a description of arguments and
* return values.
*
* @param array|string $args {
* Arguments are listed here with an explanation of their defaults.
* For more information about the arguments, see
* {@link bp_core_fetch_avatar()}.
* @type string $alt Default: 'Profile picture of [user name]'.
* @type string $class Default: 'avatar'.
* @type string $type Default: 'thumb'.
* @type int|bool $width Default: false.
* @type int|bool $height Default: false.
* @type bool $no_grav Default: false.
* @type bool $id Currently unused.
* }
* @return string User avatar string.
*/
function bp_get_member_avatar( $args = '' ) {
global $members_template;
$fullname = ! empty( $members_template->member->fullname )
? $members_template->member->fullname
: $members_template->member->display_name;
$r = bp_parse_args(
$args,
array(
'type' => 'thumb',
'width' => false,
'height' => false,
'class' => 'avatar',
'id' => false,
'no_grav' => false,
/* translators: %s: member name */
'alt' => sprintf( __( 'Profile picture of %s', 'buddypress' ), $fullname ),
)
);
$avatar = bp_core_fetch_avatar(
array(
'email' => bp_get_member_user_email(),
'item_id' => bp_get_member_user_id(),
'type' => $r['type'],
'alt' => $r['alt'],
'no_grav' => $r['no_grav'],
'css_id' => $r['id'],
'class' => $r['class'],
'width' => $r['width'],
'height' => $r['height'],
)
);
/**
* Filters a member's avatar.
*
* @since 1.2.0
* @since 2.6.0 Added the `$r` parameter.
*
* @param string $value Formatted HTML element, or raw avatar URL based on $html arg.
* @param array $r Array of parsed arguments. See {@link bp_get_member_avatar()}.
*/
return apply_filters( 'bp_get_member_avatar', $avatar, $r );
}
/**
* Output the permalink for the current member in the loop.
*
* @since 1.2.0
*/
function bp_member_permalink() {
echo esc_url( bp_get_member_permalink() );
}
/**
* Get the permalink for the current member in the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return string
*/
function bp_get_member_permalink() {
global $members_template;
$permalink = bp_core_get_user_domain(
$members_template->member->id,
$members_template->member->user_nicename,
$members_template->member->user_login
);
/**
* Filters the permalink for the current member in the loop.
*
* @since 1.2.0
*
* @param string $permalink Permalink for the current member in the loop.
*/
return apply_filters( 'bp_get_member_permalink', $permalink );
}
/**
* Alias of {@link bp_member_permalink()}.
*
* @since 1.2.0
*/
function bp_member_link() {
echo esc_url( bp_get_member_permalink() );
}
/**
* Alias of {@link bp_get_member_permalink()}.
*
* @since 1.2.0
*/
function bp_get_member_link() {
return bp_get_member_permalink();
}
/**
* Output display name of current member in the loop.
*
* @since 1.2.0
*/
function bp_member_name() {
/**
* Filters the display name of current member in the loop.
*
* @since 1.2.0
*
* @param string $value Display name for current member.
*/
echo apply_filters( 'bp_member_name', bp_get_member_name() );
}
/**
* Get the display name of the current member in the loop.
*
* Full name is, by default, pulled from xprofile's Full Name field.
* When this field is empty, we try to get an alternative name from the
* WP users table, in the following order of preference: display_name,
* user_nicename, user_login.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @return string The user's fullname for display.
*/
function bp_get_member_name() {
global $members_template;
// Generally, this only fires when xprofile is disabled.
if ( empty( $members_template->member->fullname ) ) {
// Our order of preference for alternative fullnames.
$name_stack = array(
'display_name',
'user_nicename',
'user_login'
);
foreach ( $name_stack as $source ) {
if ( ! empty( $members_template->member->{$source} ) ) {
// When a value is found, set it as fullname and be done with it.
$members_template->member->fullname = $members_template->member->{$source};
break;
}
}
}
/**
* Filters the display name of current member in the loop.
*
* @since 1.2.0
*
* @param string $fullname Display name for current member.
*/
return apply_filters( 'bp_get_member_name', $members_template->member->fullname );
}
add_filter( 'bp_get_member_name', 'wp_filter_kses' );
add_filter( 'bp_get_member_name', 'stripslashes' );
add_filter( 'bp_get_member_name', 'strip_tags' );
add_filter( 'bp_get_member_name', 'esc_html' );
/**
* Output the current member's last active time.
*
* @since 1.2.0
*
* @param array $args {@see bp_get_member_last_active()}.
*/
function bp_member_last_active( $args = array() ) {
echo bp_get_member_last_active( $args );
}
/**
* Return the current member's last active time.
*
* @since 1.2.0
* @since 2.7.0 Added 'relative' as a parameter to $args.
*
* @global BP_Core_Members_Template $members_template
*
* @param array $args {
* Array of optional arguments.
* @type mixed $active_format If true, formatted "active 5 minutes ago". If false, formatted "5 minutes
* ago". If string, should be sprintf'able like 'last seen %s ago'.
* @type bool $relative If true, will return relative time "5 minutes ago". If false, will return
* date from database. Default: true.
* }
* @return string
*/
function bp_get_member_last_active( $args = array() ) {
global $members_template;
// Parse the activity format.
$r = bp_parse_args(
$args,
array(
'active_format' => true,
'relative' => true,
)
);
// Backwards compatibility for anyone forcing a 'true' active_format.
if ( true === $r['active_format'] ) {
/* translators: %s: last activity timestamp (e.g. "Active 1 hour ago") */
$r['active_format'] = __( 'Active %s', 'buddypress' );
}
// Member has logged in at least one time.
if ( isset( $members_template->member->last_activity ) ) {
// We do not want relative time, so return now.
// @todo Should the 'bp_member_last_active' filter be applied here?
if ( ! $r['relative'] ) {
return esc_attr( $members_template->member->last_activity );
}
// Backwards compatibility for pre 1.5 'ago' strings.
$last_activity = ! empty( $r['active_format'] )
? bp_core_get_last_activity( $members_template->member->last_activity, $r['active_format'] )
: bp_core_time_since( $members_template->member->last_activity );
// Member has never logged in or been active.
} else {
$last_activity = __( 'Never active', 'buddypress' );
}
/**
* Filters the current members last active time.
*
* @since 1.2.0
*
* @param string $last_activity Formatted time since last activity.
* @param array $r Array of parsed arguments for query.
*/
return apply_filters( 'bp_member_last_active', $last_activity, $r );
}
/**
* Output the latest update of the current member in the loop.
*
* @since 1.2.0
*
* @param array|string $args {@see bp_get_member_latest_update()}.
*/
function bp_member_latest_update( $args = '' ) {
echo bp_get_member_latest_update( $args );
}
/**
* Get the latest update from the current member in the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @param array|string $args {
* Array of optional arguments.
* @type int $length Truncation length. Default: 225.
* @type bool $view_link Whether to provide a 'View' link for
* truncated entries. Default: false.
* }
* @return string
*/
function bp_get_member_latest_update( $args = '' ) {
global $members_template;
$defaults = array(
'length' => 225,
'view_link' => true,
);
$r = bp_parse_args(
$args,
$defaults
);
extract( $r );
if ( !bp_is_active( 'activity' ) || empty( $members_template->member->latest_update ) || !$update = maybe_unserialize( $members_template->member->latest_update ) )
return false;
/**
* Filters the excerpt of the latest update for current member in the loop.
*
* @since 1.2.5
* @since 2.6.0 Added the `$r` parameter.
*
* @param string $value Excerpt of the latest update for current member in the loop.
* @param array $r Array of parsed arguments.
*/
$update_content = apply_filters( 'bp_get_activity_latest_update_excerpt', trim( strip_tags( bp_create_excerpt( $update['content'], $length ) ) ), $r );
/* translators: %s: the member latest activity update */
$update_content = sprintf( _x( '- "%s"', 'member latest update in member directory', 'buddypress' ), $update_content );
// If $view_link is true and the text returned by bp_create_excerpt() is different from the original text (ie it's
// been truncated), add the "View" link.
if ( $view_link && ( $update_content != $update['content'] ) ) {
$view = __( 'View', 'buddypress' );
$update_content .= '' . $view . '';
}
/**
* Filters the latest update from the current member in the loop.
*
* @since 1.2.0
* @since 2.6.0 Added the `$r` parameter.
*
* @param string $update_content Formatted latest update for current member.
* @param array $r Array of parsed arguments.
*/
return apply_filters( 'bp_get_member_latest_update', $update_content, $r );
}
/**
* Output a piece of user profile data.
*
* @since 1.2.0
*
* @see bp_get_member_profile_data() for a description of params.
*
* @param array|string $args See {@link bp_get_member_profile_data()}.
*/
function bp_member_profile_data( $args = '' ) {
echo bp_get_member_profile_data( $args );
}
/**
* Get a piece of user profile data.
*
* When used in a bp_has_members() loop, this function will attempt
* to fetch profile data cached in the template global. It is also safe
* to use outside of the loop.
*
* @since 1.2.0
*
* @global BP_Core_Members_Template $members_template
*
* @param array|string $args {
* Array of config parameters.
* @type string $field Name of the profile field.
* @type int $user_id ID of the user whose data is being fetched.
* Defaults to the current member in the loop, or if not
* present, to the currently displayed user.
* }
* @return string|bool Profile data if found, otherwise false.
*/
function bp_get_member_profile_data( $args = '' ) {
global $members_template;
if ( ! bp_is_active( 'xprofile' ) ) {
return false;
}
// Declare local variables.
$data = false;
// Guess at default $user_id.
$default_user_id = 0;
if ( ! empty( $members_template->member->id ) ) {
$default_user_id = $members_template->member->id;
} elseif ( bp_displayed_user_id() ) {
$default_user_id = bp_displayed_user_id();
}
$defaults = array(
'field' => false,
'user_id' => $default_user_id,
);
$r = bp_parse_args(
$args,
$defaults
);
// If we're in a members loop, get the data from the global.
if ( ! empty( $members_template->member->profile_data ) ) {
$profile_data = $members_template->member->profile_data;
}
// Otherwise query for the data.
if ( empty( $profile_data ) && method_exists( 'BP_XProfile_ProfileData', 'get_all_for_user' ) ) {
$profile_data = BP_XProfile_ProfileData::get_all_for_user( $r['user_id'] );
}
// If we're in the members loop, but the profile data has not
// been loaded into the global, cache it there for later use.
if ( ! empty( $members_template->member ) && empty( $members_template->member->profile_data ) ) {
$members_template->member->profile_data = $profile_data;
}
// Get the data for the specific field requested.
if ( ! empty( $profile_data ) && ! empty( $profile_data[ $r['field'] ]['field_type'] ) && ! empty( $profile_data[ $r['field'] ]['field_data'] ) ) {
$data = xprofile_format_profile_field( $profile_data[ $r['field'] ]['field_type'], $profile_data[ $r['field'] ]['field_data'] );
}
/**
* Filters resulting piece of member profile data.
*
* @since 1.2.0
* @since 2.6.0 Added the `$r` parameter.
*
* @param string|bool $data Profile data if found, otherwise false.
* @param array $r Array of parsed arguments.
*/
$data = apply_filters( 'bp_get_member_profile_data', $data, $r );
/**
* Filters the resulting piece of member profile data by field type.
*
* This is a dynamic filter based on field type of the current field requested.
*
* @since 2.7.0
*
* @param string|bool $data Profile data if found, otherwise false.
* @param array $r Array of parsed arguments.
*/
if ( ! empty( $profile_data[ $r['field'] ]['field_type'] ) ) {
$data = apply_filters( 'bp_get_member_profile_data_' . $profile_data[ $r['field'] ]['field_type'], $data, $r );
}
return $data;
}
/**
* Output the 'registered [x days ago]' string for the current member.
*
* @since 1.2.0
* @since 2.7.0 Added $args as a parameter.
*
* @param array $args Optional. {@see bp_get_member_registered()}.
*/
function bp_member_registered( $args = array() ) {
echo bp_get_member_registered( $args );
}
/**
* Get the 'registered [x days ago]' string for the current member.
*
* @since 1.2.0
* @since 2.7.0 Added `$args` as a parameter.
*
* @global BP_Core_Members_Template $members_template
*
* @param array $args {
* Array of optional parameters.
* @type bool $relative Optional. If true, returns relative registered date. eg. registered 5 months ago.
* If false, returns registered date value from database.
* }
* @return string
*/
function bp_get_member_registered( $args = array() ) {
global $members_template;
$r = bp_parse_args(
$args,
array(
'relative' => true,
)
);
// We do not want relative time, so return now.
// @todo Should the 'bp_member_registered' filter be applied here?
if ( ! $r['relative'] ) {
return esc_attr( $members_template->member->user_registered );
}
/* translators: %s: last activity timestamp (e.g. "active 1 hour ago") */
$registered = esc_attr( bp_core_get_last_activity( $members_template->member->user_registered, _x( 'registered %s', 'Records the timestamp that the user registered into the activity stream', 'buddypress' ) ) );
/**
* Filters the 'registered [x days ago]' string for the current member.
*
* @since 2.1.0
*
* @param string $registered The 'registered [x days ago]' string.
* @param array $r Array of parsed arguments.
*/
return apply_filters( 'bp_member_registered', $registered, $r );
}
/**
* Output a random piece of profile data for the current member in the loop.
*
* @since 1.2.0
* @since 10.0.0 Updated to get member ID using `bp_get_member_user_id`.
*/
function bp_member_random_profile_data() {
if ( bp_is_active( 'xprofile' ) ) { ?>
name ) ?>
value ) ?>
';
}
if ( isset( $_REQUEST['letter'] ) ) {
echo '';
}
if ( isset( $_REQUEST['members_search'] ) ) {
echo '';
}
}
/**
* Output the Members directory search form.
*
* @since 1.0.0
*/
function bp_directory_members_search_form() {
$query_arg = bp_core_get_component_search_query_arg( 'members' );
if ( ! empty( $_REQUEST[ $query_arg ] ) ) {
$search_value = stripslashes( $_REQUEST[ $query_arg ] );
} else {
$search_value = bp_get_search_default_text( 'members' );
}
$search_form_html = '';
/**
* Filters the Members component search form.
*
* @since 1.9.0
*
* @param string $search_form_html HTML markup for the member search form.
*/
echo apply_filters( 'bp_directory_members_search_form', $search_form_html );
}
/**
* Output the total member count.
*
* @since 1.2.0
*/
function bp_total_site_member_count() {
echo bp_get_total_site_member_count();
}
/**
* Get the total site member count.
*
* @since 1.2.0
*
* @return string
*/
function bp_get_total_site_member_count() {
/**
* Filters the total site member count.
*
* @since 1.2.0
*
* @param string $value Number-formatted total site member count.
*/
return apply_filters( 'bp_get_total_site_member_count', bp_core_number_format( bp_core_get_total_member_count() ) );
}
/** Navigation and other misc template tags ***********************************/
/**
* Render the navigation markup for the logged-in user.
*
* Each component adds to this navigation array within its own
* [component_name]setup_nav() function.
*
* This navigation array is the top level navigation, so it contains items such as:
* [Blog, Profile, Messages, Groups, Friends] ...
*
* The function will also analyze the current component the user is in, to
* determine whether or not to highlight a particular nav item.
*
* @since 1.1.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @todo Move to a back-compat file?
* @deprecated Does not seem to be called anywhere in BP core.
*/
function bp_get_loggedin_user_nav() {
$bp = buddypress();
// Loop through each navigation item.
foreach ( (array) $bp->members->nav->get_primary() as $nav_item ) {
$selected = '';
// If the current component matches the nav item id, then add a highlight CSS class.
if ( ! bp_is_directory() && ! empty( $bp->active_components[ bp_current_component() ] ) && $bp->active_components[ bp_current_component() ] == $nav_item->css_id ) {
$selected = ' class="current selected"';
}
// If we are viewing another person (current_userid does not equal
// loggedin_user->id then check to see if the two users are friends.
// if they are, add a highlight CSS class to the friends nav item
// if it exists.
if ( !bp_is_my_profile() && bp_displayed_user_id() ) {
$selected = '';
if ( bp_is_active( 'friends' ) ) {
if ( $nav_item->css_id == $bp->friends->id ) {
if ( friends_check_friendship( bp_loggedin_user_id(), bp_displayed_user_id() ) ) {
$selected = ' class="current selected"';
}
}
}
}
// Echo out the final list item.
echo apply_filters_ref_array( 'bp_get_loggedin_user_nav_' . $nav_item->css_id, array( '
';
echo apply_filters( 'bp_logout_nav_link', $logout_link );
}
/**
* Output the contents of the current user's home page.
*
* @since 2.6.0
*/
function bp_displayed_user_front_template_part() {
$located = bp_displayed_user_get_front_template();
if ( false !== $located ) {
$slug = str_replace( '.php', '', $located );
$name = null;
/**
* Let plugins adding an action to bp_get_template_part get it from here
*
* @param string $slug Template part slug requested.
* @param string $name Template part name requested.
*/
do_action( 'get_template_part_' . $slug, $slug, $name );
load_template( $located, true );
}
return $located;
}
/**
* Locate a custom user front template if it exists.
*
* @since 2.6.0
*
* @param object|null $displayed_user Optional. Falls back to current user if not passed.
* @return string|bool Path to front template on success; boolean false on failure.
*/
function bp_displayed_user_get_front_template( $displayed_user = null ) {
if ( ! is_object( $displayed_user ) || empty( $displayed_user->id ) ) {
$displayed_user = bp_get_displayed_user();
}
if ( ! isset( $displayed_user->id ) ) {
return false;
}
if ( isset( $displayed_user->front_template ) ) {
return $displayed_user->front_template;
}
// Init the hierarchy.
$template_names = array(
'members/single/front-id-' . (int) $displayed_user->id . '.php',
'members/single/front-nicename-' . sanitize_file_name( $displayed_user->userdata->user_nicename ) . '.php',
);
/**
* Check for member types and add it to the hierarchy
*
* Make sure to register your member
* type using the hook 'bp_register_member_types'
*/
if ( bp_get_member_types() ) {
$displayed_user_member_type = bp_get_member_type( $displayed_user->id );
if ( ! $displayed_user_member_type ) {
$displayed_user_member_type = 'none';
}
$template_names[] = 'members/single/front-member-type-' . sanitize_file_name( $displayed_user_member_type ) . '.php';
}
// Add The generic template to the end of the hierarchy.
$template_names[] = 'members/single/front.php';
/**
* Filters the hierarchy of user front templates corresponding to a specific user.
*
* @since 2.6.0
*
* @param array $template_names Array of template paths.
*/
$template_names = apply_filters( 'bp_displayed_user_get_front_template', $template_names );
return bp_locate_template( $template_names, false, true );
}
/**
* Check if the displayed user has a custom front template.
*
* @since 2.6.0
*/
function bp_displayed_user_has_front_template() {
$displayed_user = bp_get_displayed_user();
return ! empty( $displayed_user->front_template );
}
/**
* Render the navigation markup for the displayed user.
*
* @since 1.1.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*/
function bp_get_displayed_user_nav() {
$bp = buddypress();
foreach ( $bp->members->nav->get_primary() as $user_nav_item ) {
if ( empty( $user_nav_item->show_for_displayed_user ) && ! bp_is_my_profile() ) {
continue;
}
$selected = '';
if ( bp_is_current_component( $user_nav_item->slug ) ) {
$selected = ' class="current selected"';
}
if ( bp_loggedin_user_domain() ) {
$link = str_replace( bp_loggedin_user_domain(), bp_displayed_user_domain(), $user_nav_item->link );
} else {
$link = trailingslashit( bp_displayed_user_domain() . $user_nav_item->link );
}
/**
* Filters the navigation markup for the displayed user.
*
* This is a dynamic filter that is dependent on the navigation tab component being rendered.
*
* @since 1.1.0
*
* @param string $value Markup for the tab list item including link.
* @param array $user_nav_item Array holding parts used to construct tab list item.
* Passed by reference.
*/
echo apply_filters_ref_array( 'bp_get_displayed_user_nav_' . $user_nav_item->css_id, array( '
';
}
/**
* Filters the user avatar during signup.
*
* @since 1.1.0
*
* @param string $gravatar_img Avatar HTML image tag.
* @param array $args Array of parsed args for avatar query.
*/
return apply_filters( 'bp_get_signup_avatar', $gravatar_img, $args );
}
/**
* Output whether signup is allowed.
*
* @since 1.1.0
*
* @todo Remove this function. Echoing a bool is pointless.
*/
function bp_signup_allowed() {
echo bp_get_signup_allowed();
}
/**
* Is user signup allowed?
*
* @since 1.1.0
*
* @return bool
*/
function bp_get_signup_allowed() {
/**
* Filters whether or not new signups are allowed.
*
* @since 1.5.0
*
* @param bool $signup_allowed Whether or not new signups are allowed.
*/
return apply_filters( 'bp_get_signup_allowed', (bool) bp_get_option( 'users_can_register' ) );
}
/**
* Are users allowed to invite users to join this site?
*
* @since 8.0.0
*
* @return bool
*/
function bp_get_members_invitations_allowed() {
/**
* Filters whether or not community invitations are allowed.
*
* @since 8.0.0
*
* @param bool $allowed Whether or not community invitations are allowed.
*/
return apply_filters( 'bp_get_members_invitations_allowed', bp_is_active( 'members', 'invitations' ) && (bool) bp_get_option( 'bp-enable-members-invitations' ) );
}
/**
* Are membership requests required for joining this site?
*
* @since 10.0.0
*
* @param bool $context "raw" to fetch value from database,
* "site" to take "anyone can register" setting into account.
* @return bool
*/
function bp_get_membership_requests_required( $context = 'site' ) {
if ( 'raw' === $context ) {
$retval = bp_is_active( 'members', 'membership_requests' ) && (bool) bp_get_option( 'bp-enable-membership-requests' );
} else {
$retval = bp_is_active( 'members', 'membership_requests' ) && ! bp_get_signup_allowed() && (bool) bp_get_option( 'bp-enable-membership-requests' );
}
/**
* Filters whether or not prospective members may submit network membership requests.
*
* @since 10.0.0
*
* @param bool $retval Whether or not membership requests are required.
* @param bool $retval Whether this is the value stored in the database ('raw')
* or whether the site's "anyone can register" setting is
* being considered ('site' or anything else).
*/
return apply_filters( 'bp_get_membership_requests_required', $retval, $context );
}
/**
* Should the system create and allow access
* to the Register and Activate pages?
*
* @since 10.0.0
*
* @return bool
*/
function bp_allow_access_to_registration_pages() {
$retval = bp_get_signup_allowed() || bp_get_members_invitations_allowed() || bp_get_membership_requests_required();
/**
* Filters whether or not the system should create and allow access
* to the Register and Activate pages.
*
* @since 10.0.0
*
* @param bool $retval Whether or not to allow access to
* the Register and Activate pages.
*/
return apply_filters( 'bp_allow_access_to_registration_pages', $retval );
}
/**
* Hook member activity feed to .
*
* @since 1.5.0
*/
function bp_members_activity_feed() {
if ( !bp_is_active( 'activity' ) || !bp_is_user() )
return; ?>
{$component}->slug . '/' . $action;
} else {
$url = bp_displayed_user_domain() . $bp->{$component}->slug;
}
// Add a slash at the end of our user url.
$url = trailingslashit( $url );
// Add possible query arg.
if ( ! empty( $query_args ) && is_array( $query_args ) ) {
$url = add_query_arg( $query_args, $url );
}
// To nonce, or not to nonce...
if ( true === $nonce ) {
$url = wp_nonce_url( $url );
} elseif ( is_string( $nonce ) ) {
$url = wp_nonce_url( $url, $nonce );
}
// Return the url, if there is one.
if ( ! empty( $url ) ) {
return $url;
}
}
/**
* Render an avatar delete link.
*
* @since 1.1.0
* @since 6.0.0 Moved from /bp-xprofile/bp-xprofile-template.php to this file.
*/
function bp_avatar_delete_link() {
echo bp_get_avatar_delete_link();
}
/**
* Return an avatar delete link.
*
* @since 1.1.0
* @since 6.0.0 Moved from /bp-xprofile/bp-xprofile-template.php to this file.
*
* @return string
*/
function bp_get_avatar_delete_link() {
/**
* Filters the link used for deleting an avatar.
*
* @since 1.1.0
*
* @param string $value Nonced URL used for deleting an avatar.
*/
return apply_filters( 'bp_get_avatar_delete_link', wp_nonce_url( bp_displayed_user_domain() . bp_get_profile_slug() . '/change-avatar/delete-avatar/', 'bp_delete_avatar_link' ) );
}
/** The Members Invitations Loop ******************************************************************/
/**
* Initialize the community invitations loop.
*
* Based on the $args passed, bp_has_invitations() populates
* buddypress()->invitations->query_loop global, enabling the use of BP
* templates and template functions to display a list of invitations.
*
* @since 8.0.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @param array|string $args {
* Arguments for limiting the contents of the invitations loop. Can be
* passed as an associative array, or as a URL query string.
*
* See {@link BP_Invitations_Invitation::get()} for detailed
* information on the arguments. In addition, also supports:
*
* @type int $max Optional. Max items to display. Default: false.
* @type string $page_arg URL argument to use for pagination.
* Default: 'ipage'.
* }
* @return bool
*/
function bp_has_members_invitations( $args = '' ) {
$bp = buddypress();
// Get the user ID.
if ( bp_displayed_user_id() ) {
$user_id = bp_displayed_user_id();
} else {
$user_id = bp_loggedin_user_id();
}
// Set the search terms (by default an empty string to get all notifications).
$search_terms = '';
if ( isset( $_REQUEST['s'] ) ) {
$search_terms = stripslashes( $_REQUEST['s'] );
}
// Parse the args.
$r = bp_parse_args(
$args,
array(
'id' => false,
'inviter_id' => $user_id,
'invitee_email' => false,
'item_id' => false,
'type' => 'invite',
'invite_sent' => 'all',
'accepted' => 'pending',
'search_terms' => $search_terms,
'order_by' => 'date_modified',
'sort_order' => 'DESC',
'page' => 1,
'per_page' => 25,
'fields' => 'all',
// These are additional arguments that are not available in
// BP_Invitations_Invitation::get().
'page_arg' => 'ipage',
),
'has_members_invitations'
);
// Get the notifications.
$query_loop = new BP_Members_Invitations_Template( $r );
// Setup the global query loop.
$bp->members->invitations->query_loop = $query_loop;
/**
* Filters whether or not the user has network invitations to display.
*
* @since 8.0.0
*
* @param bool $value Whether or not there are network invitations to display.
* @param BP_Notifications_Template $query_loop BP_Members_Invitations_Template object instance.
* @param array $r Array of arguments passed into the BP_Members_Invitations_Template class.
*/
return apply_filters( 'bp_has_members_invitations', $query_loop->has_invitations(), $query_loop, $r );
}
/**
* Get the network invitations returned by the template loop.
*
* @since 8.0.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return array List of network invitations.
*/
function bp_the_members_invitations() {
return buddypress()->members->invitations->query_loop->invitations();
}
/**
* Get the current network invitation object in the loop.
*
* @since 8.0.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return object The current network invitation within the loop.
*/
function bp_the_members_invitation() {
return buddypress()->members->invitations->query_loop->the_invitation();
}
/**
* Output the pagination count for the current network invitations loop.
*
* @since 8.0.0
*/
function bp_members_invitations_pagination_count() {
echo bp_get_members_invitations_pagination_count();
}
/**
* Return the pagination count for the current network invitation loop.
*
* @since 8.0.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return string HTML for the pagination count.
*/
function bp_get_members_invitations_pagination_count() {
$bp = buddypress();
$query_loop = $bp->members->invitations->query_loop;
$start_num = intval( ( $query_loop->pag_page - 1 ) * $query_loop->pag_num ) + 1;
$from_num = bp_core_number_format( $start_num );
$to_num = bp_core_number_format( ( $start_num + ( $query_loop->pag_num - 1 ) > $query_loop->total_invitation_count ) ? $query_loop->total_invitation_count : $start_num + ( $query_loop->pag_num - 1 ) );
$total = bp_core_number_format( $query_loop->total_invitation_count );
if ( 1 == $query_loop->total_invitation_count ) {
$pag = __( 'Viewing 1 invitation', 'buddypress' );
} else {
/* translators: 1: Invitations from number. 2: Invitations to number. 3: Total invitations. */
$pag = sprintf( _nx( 'Viewing %1$s - %2$s of %3$s invitation', 'Viewing %1$s - %2$s of %3$s invitations', $query_loop->total_invitation_count, 'Community invites pagination', 'buddypress' ), $from_num, $to_num, $total );
}
/**
* Filters the pagination count for the current network invitation loop.
*
* @since 8.0.0
*
* @param string $pag HTML for the pagination count.
*/
return apply_filters( 'bp_get_members_invitations_pagination_count', $pag );
}
/**
* Output the pagination links for the current network invitation loop.
*
* @since 8.0.0
*/
function bp_members_invitations_pagination_links() {
echo bp_get_members_invitations_pagination_links();
}
/**
* Return the pagination links for the current network invitations loop.
*
* @since 8.0.0
*
* @global BuddyPress $bp The one true BuddyPress instance.
*
* @return string HTML for the pagination links.
*/
function bp_get_members_invitations_pagination_links() {
$bp = buddypress();
/**
* Filters the pagination links for the current network invitations loop.
*
* @since 8.0.0
*
* @param string $pag_links HTML for the pagination links.
*/
return apply_filters( 'bp_get_members_invitations_pagination_links', $bp->members->invitations->query_loop->pag_links );
}
/**
* Output the requested property of the invitation currently being iterated on.
*
* @since 8.0.0
*
* @param string $property The name of the property to display.
* @param string $context The context of display.
* Possible values are 'attribute' and 'html'.
*/
function bp_the_members_invitation_property( $property = '', $context = 'html' ) {
if ( ! $property ) {
return;
}
/**
* Use this filter to sanitize the output.
*
* @since 8.0.0
*
* @param int|string $value The value for the requested property.
* @param string $property The name of the requested property.
* @param string $context The context of display.
*/
echo apply_filters( 'bp_the_members_invitation_property', bp_get_the_members_invitation_property( $property ), $property, $context );
}
/**
* Return the value for a property of the network invitation currently being iterated on.
*
* @since 8.0.0
*
* @return int ID of the current network invitation.
*/
function bp_get_the_members_invitation_property( $property = 'id' ) {
switch ( $property ) {
case 'id':
case 'user_id':
case 'item_id':
case 'secondary_item_id':
case 'invite_sent':
case 'accepted':
$value = 0;
break;
case 'invitee_email':
case 'type':
case 'content':
case 'date_modified':
$value = '';
break;
default:
// A known property has not been specified.
$property = null;
$value = '';
break;
}
if ( isset( buddypress()->members->invitations->query_loop->invitation->{$property} ) ) {
$value = buddypress()->members->invitations->query_loop->invitation->{$property};
}
/**
* Filters the property of the network invitation currently being iterated on.
*
* @since 8.0.0
*
* @param int|string $value Property value of the network invitation being iterated on.
*/
return apply_filters( 'bp_get_the_members_invitation_property_' . $property, $value );
}
/**
* Output the action links for the current invitation.
*
* @since 8.0.0
*
* @param array|string $args Array of arguments.
*/
function bp_the_members_invitation_action_links( $args = '' ) {
echo bp_get_the_members_invitation_action_links( $args );
}
/**
* Return the action links for the current invitation.
*
* @since 8.0.0
*
* @param array|string $args {
* @type string $before HTML before the links.
* @type string $after HTML after the links.
* @type string $sep HTML between the links.
* @type array $links Array of links to implode by 'sep'.
* @type int $user_id User ID to fetch action links for. Defaults to displayed user ID.
* }
* @return string HTML links for actions to take on single notifications.
*/
function bp_get_the_members_invitation_action_links( $args = '' ) {
// Set default user ID to use.
$inviter_id = isset( $args['inviter_id'] ) ? $args['inviter_id'] : bp_displayed_user_id();
// Parse.
$r = bp_parse_args(
$args,
array(
'before' => '',
'after' => '',
'sep' => ' | ',
'links' => array(
bp_get_the_members_invitation_resend_link( $inviter_id ),
bp_get_the_members_invitation_delete_link( $inviter_id )
)
)
);
// Build the links.
$retval = $r['before'] . implode( $r['sep'], $r['links'] ) . $r['after'];
/**
* Filters the action links for the current invitation.
*
* @since 8.0.0
*
* @param string $retval HTML links for actions to take on single invitation.
* @param array $r Array of parsed arguments.
*/
return apply_filters( 'bp_get_the_members_invitation_action_links', $retval, $r );
}
/**
* Output the resend link for the current invitation.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_the_members_invitations_resend_link( $user_id = 0 ) {
echo bp_get_the_members_invitation_delete_link( $user_id );
}
/**
* Return the resend link for the current notification.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
* @return string
*/
function bp_get_the_members_invitation_resend_link( $user_id = 0 ) {
// Set default user ID to use.
$user_id = 0 === $user_id ? bp_displayed_user_id() : $user_id;
// Don't allow resending of accepted invitations.
if ( bp_get_the_members_invitation_property( 'accepted' ) ) {
return;
}
$retval = sprintf( '%2$s', esc_url( bp_get_the_members_invitations_resend_url( $user_id ) ), __( 'Resend', 'buddypress' ) );
/**
* Filters the resend link for the current invitation.
*
* @since 8.0.0
*
* @param string $retval HTML for the delete link for the current notification.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_the_members_invitation_resend_link', $retval, $user_id );
}
/**
* Output the URL used for resending a single invitation.
*
* Since this function directly outputs a URL, it is escaped.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_the_members_invitations_resend_url( $user_id = 0 ) {
echo esc_url( bp_get_the_members_invitations_resend_url( $user_id ) );
}
/**
* Return the URL used for resending a single invitation.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
* @return string
*/
function bp_get_the_members_invitations_resend_url( $user_id = 0 ) {
// Set default user ID to use.
$user_id = 0 === $user_id ? bp_displayed_user_id() : $user_id;
$link = bp_get_members_invitations_list_invites_permalink( $user_id );
// Get the ID.
$id = bp_get_the_members_invitation_property( 'id' );
// Get the args to add to the URL.
$args = array(
'action' => 'resend',
'invitation_id' => $id
);
// Add the args.
$url = add_query_arg( $args, $link );
// Add the nonce.
$url = wp_nonce_url( $url, 'bp_members_invitation_resend_' . $id );
/**
* Filters the URL used for resending a single invitation.
*
* @since 8.0.0
*
* @param string $url URL used for deleting a single invitation.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_the_members_invitations_resend_url', $url, $user_id );
}
/**
* Output the delete link for the current invitation.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_the_members_invitations_delete_link( $user_id = 0 ) {
echo bp_get_the_members_invitation_delete_link( $user_id );
}
/**
* Return the delete link for the current invitation.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
* @return string
*/
function bp_get_the_members_invitation_delete_link( $user_id = 0 ) {
// Set default user ID to use.
$user_id = 0 === $user_id ? bp_displayed_user_id() : $user_id;
// Modify the message for accepted/not accepted invitatons.
if ( bp_get_the_members_invitation_property( 'accepted' ) ) {
$message = __( 'Delete', 'buddypress' );
} else {
$message = __( 'Cancel', 'buddypress' );
}
$retval = sprintf(
'%2$s',
esc_url( bp_get_the_members_invitations_delete_url( $user_id ) ),
esc_html( $message )
);
/**
* Filters the delete link for the current invitation.
*
* @since 8.0.0
*
* @param string $retval HTML for the delete link for the current notification.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_the_members_invitation_delete_link', $retval, $user_id );
}
/**
* Output the URL used for deleting a single invitation.
*
* Since this function directly outputs a URL, it is escaped.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_the_members_invitations_delete_url( $user_id = 0 ) {
echo esc_url( bp_get_the_members_invitations_delete_url( $user_id ) );
}
/**
* Return the URL used for deleting a single invitation.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
* @return string
*/
function bp_get_the_members_invitations_delete_url( $user_id = 0 ) {
// Set default user ID to use.
$user_id = 0 === $user_id ? bp_displayed_user_id() : $user_id;
$link = bp_get_members_invitations_list_invites_permalink( $user_id );
// Get the ID.
$id = bp_get_the_members_invitation_property( 'id' );
// Get the args to add to the URL.
$args = array(
'action' => 'cancel',
'invitation_id' => $id
);
// Add the args.
$url = add_query_arg( $args, $link );
// Add the nonce.
$url = wp_nonce_url( $url, 'bp_members_invitations_cancel_' . $id );
/**
* Filters the URL used for deleting a single invitation.
*
* @since 8.0.0
*
* @param string $url URL used for deleting a single invitation.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_the_members_invitations_delete_url', $url, $user_id );
}
/**
* Output the members invitations list permalink for a user.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_members_invitations_list_invites_permalink( $user_id = 0 ) {
echo bp_get_members_invitations_list_invites_permalink( $user_id );
}
/**
* Return the members invitations list permalink for a user.
*
* @since 8.0.0
*
* @return string Members invitations list permalink for a user.
*/
function bp_get_members_invitations_list_invites_permalink( $user_id = 0 ) {
if ( 0 === $user_id ) {
$user_id = bp_loggedin_user_id();
$domain = bp_loggedin_user_domain();
} else {
$domain = bp_core_get_user_domain( (int) $user_id );
}
$retval = trailingslashit( $domain . bp_get_members_invitations_slug() . '/list-invites' );
/**
* Filters the members invitations list permalink for a user.
*
* @since 8.0.0
*
* @param string $retval Permalink for the sent invitation list screen.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_members_invitations_list_invites_permalink', $retval, $user_id );
}
/**
* Output the send invitation permalink for a user.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
*/
function bp_members_invitations_send_invites_permalink( $user_id = 0 ) {
echo bp_get_members_invitations_send_invites_permalink( $user_id );
}
/**
* Return the send invitations permalink.
*
* @since 8.0.0
*
* @param int $user_id The user ID.
* @return string The send invitations permalink.
*/
function bp_get_members_invitations_send_invites_permalink( $user_id = 0 ) {
if ( 0 === $user_id ) {
$user_id = bp_loggedin_user_id();
$domain = bp_loggedin_user_domain();
} else {
$domain = bp_core_get_user_domain( (int) $user_id );
}
$retval = trailingslashit( $domain . bp_get_members_invitations_slug() . '/send-invites' );
/**
* Filters the send invitations permalink.
*
* @since 8.0.0
*
* @param string $retval Permalink for the sent invitation list screen.
* @param int $user_id The user ID.
*/
return apply_filters( 'bp_get_members_invitations_send_invites_permalink', $retval, $user_id );
}
/**
* Output the dropdown for bulk management of invitations.
*
* @since 8.0.0
*/
function bp_members_invitations_bulk_management_dropdown() {
?>