BP_Core_Members_Widget::widget( array $args, array $instance )
Display the Members widget.
Description
See also
- WP_Widget::widget(): for description of parameters.
Parameters
- $args
-
(Required) Widget arguments.
- $instance
-
(Required) Widget settings, as saved by the user.
Source
File: bp-members/classes/class-bp-core-members-widget.php
public function widget( $args, $instance ) { global $members_template; // Get widget settings. $settings = $this->parse_settings( $instance ); /** * Filters the title of the Members widget. * * @since BuddyPress 1.8.0 * @since BuddyPress 2.3.0 Added 'instance' and 'id_base' to arguments passed to filter. * * @param string $title The widget title. * @param array $settings The settings for the particular instance of the widget. * @param string $id_base Root ID for all widgets of this type. */ $title = apply_filters( 'widget_title', $settings['title'], $settings, $this->id_base ); $title = $settings['link_title'] ? '<a href="' . bp_get_members_directory_permalink() . '">' . $title . '</a>' : $title; /** * Filters the separator of the member widget links. * * @since BuddyPress 2.4.0 * * @param string $separator Separator string. Default '|'. */ $separator = apply_filters( 'bp_members_widget_separator', '|' ); // Output before widget HTMl, title (and maybe content before & after it). echo $args['before_widget'] . $args['before_title'] . $title . $args['after_title']; // Setup args for querying members. $members_args = array( 'user_id' => 0, 'type' => $settings['member_default'], 'per_page' => $settings['max_members'], 'max' => $settings['max_members'], 'populate_extras' => true, 'search_terms' => false, ); if ( empty($members_args['max']) ) { $members_args['max'] = 5; } // Back up the global. $old_members_template = $members_template; ?> <?php if ( bp_has_members( $members_args ) ) : ?> <div class="item-options" id="members-list-options"> <a href="<?php bp_members_directory_permalink(); ?>" id="newest-members" <?php if ( 'newest' === $settings['member_default'] ) : ?>class="selected"<?php endif; ?>><?php esc_html_e( 'Newest', 'buddyboss' ); ?></a> <span class="bp-separator" role="separator"><?php echo esc_html( $separator ); ?></span> <a href="<?php bp_members_directory_permalink(); ?>" id="recently-active-members" <?php if ( 'active' === $settings['member_default'] ) : ?>class="selected"<?php endif; ?>><?php esc_html_e( 'Active', 'buddyboss' ); ?></a> <?php if ( bp_is_active( 'friends' ) ) : ?> <span class="bp-separator" role="separator"><?php echo esc_html( $separator ); ?></span> <a href="<?php bp_members_directory_permalink(); ?>" id="popular-members" <?php if ( 'popular' === $settings['member_default'] ) : ?>class="selected"<?php endif; ?>><?php esc_html_e( 'Popular', 'buddyboss' ); ?></a> <?php endif; ?> </div> <ul id="members-list" class="item-list" aria-live="polite" aria-relevant="all" aria-atomic="true"> <?php while ( bp_members() ) : bp_the_member(); ?> <li class="vcard"> <div class="item-avatar"> <a href="<?php bp_member_permalink() ?>"> <?php bp_member_avatar(); ?> <?php $current_time = current_time( 'mysql', 1 ); $diff = strtotime( $current_time ) - strtotime( $members_template->member->last_activity ); if ( $diff < 300 ) { // 5 minutes = 5 * 60 ?> <span class="member-status online"></span> <?php } ?> </a> </div> <div class="item"> <div class="item-title fn"><a href="<?php bp_member_permalink(); ?>"><?php bp_member_name(); ?></a></div> <div class="item-meta"> <?php if ( 'newest' == $settings['member_default'] ) : ?> <span class="activity" data-livestamp="<?php bp_core_iso8601_date( bp_get_member_registered( array( 'relative' => false ) ) ); ?>"><?php bp_member_registered(); ?></span> <?php elseif ( 'active' == $settings['member_default'] ) : ?> <span class="activity" data-livestamp="<?php bp_core_iso8601_date( bp_get_member_last_active( array( 'relative' => false ) ) ); ?>"><?php bp_member_last_active(); ?></span> <?php else : ?> <span class="activity"><?php bp_member_total_friend_count(); ?></span> <?php endif; ?> </div> </div> </li> <?php endwhile; ?> </ul> <?php wp_nonce_field( 'bp_core_widget_members', '_wpnonce-members', false ); ?> <input type="hidden" name="members_widget_max" id="members_widget_max" value="<?php echo esc_attr( $settings['max_members'] ); ?>" /> <div class="more-block"><a href="<?php bp_members_directory_permalink(); ?>" class="count-more">More<i class="bb-icon-angle-right"></i></a></div> <?php else: ?> <div class="widget-error"> <?php esc_html_e( 'No one has signed up yet!', 'buddyboss' ); ?> </div> <?php endif; ?> <?php echo $args['after_widget']; // Restore the global. $members_template = $old_members_template; }
Changelog
Version | Description |
---|---|
BuddyPress 1.0.3 | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.