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 $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 base slug.
*
* 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
*/
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.
*/
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
*
* @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
*
* @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 );
}
/**
* 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
*
* @global object $members_template {@link BP_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 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 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_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.
'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['type'],
$r['page'],
$r['per_page'],
$r['max'],
$r['user_id'],
$r['search_terms'],
$r['include'],
$r['populate_extras'],
$r['exclude'],
$r['meta_key'],
$r['meta_value'],
$r['page_arg'],
$r['member_type'],
$r['member_type__in'],
$r['member_type__not_in']
);
/**
* 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 array $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
*
* @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
*
* @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
*
* @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 {
$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 {
$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 {
$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 {
$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
*
* @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
*
* @return string Member ID.
*/
function bp_get_member_user_id() {
global $members_template;
$member_id = isset( $members_template->member->id ) ? (int) $members_template->member->id : false;
/**
* 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', $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
*
* @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
*
* @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
*
* @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
*
* @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
*
* @return bool
*/
function bp_member_is_loggedin_user() {
global $members_template;
/**
* 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() == $members_template->member->id ? true : false );
}
/**
* 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
*
* @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 $id Currently unused.
* @type bool $no_grav Default: false.
* }
* @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;
$defaults = array(
'type' => 'thumb',
'width' => false,
'height' => false,
'class' => 'avatar',
'id' => false,
'alt' => sprintf( __( 'Profile picture of %s', 'buddypress' ), $fullname )
);
$r = wp_parse_args( $args, $defaults );
extract( $r, EXTR_SKIP );
/**
* Filters a members 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', bp_core_fetch_avatar( array( 'item_id' => $members_template->member->id, 'type' => $type, 'alt' => $alt, 'css_id' => $id, 'class' => $class, 'width' => $width, 'height' => $height, 'email' => $members_template->member->user_email ) ), $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
*
* @return string
*/
function bp_get_member_permalink() {
global $members_template;
/**
* Filters the permalink for the current member in the loop.
*
* @since 1.2.0
*
* @param string $value Permalink for the current member in the loop.
*/
return apply_filters( 'bp_get_member_permalink', bp_core_get_user_domain( $members_template->member->id, $members_template->member->user_nicename, $members_template->member->user_login ) );
}
/**
* 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
*
* @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.
*
* @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'] ) {
$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
*
* @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 = wp_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 );
$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
*
* @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 = wp_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.
*
* @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 = wp_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 );
}
$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.
*/
return apply_filters( 'bp_member_registered', $registered );
}
/**
* Output a random piece of profile data for the current member in the loop.
*
* @since 1.2.0
*/
function bp_member_random_profile_data() {
global $members_template;
if ( bp_is_active( 'xprofile' ) ) { ?>
member->id, true ); ?>
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 int
*/
function bp_get_total_site_member_count() {
/**
* Filters the total site member count.
*
* @since 1.2.0
*
* @param int $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
*
* @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-' . sanitize_file_name( $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.
*/
return bp_locate_template( apply_filters( 'bp_displayed_user_get_front_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
*/
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' ) );
}
/**
* 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;
}