* @copyright Copyright (c) 2009 - 2018, Justin Tadlock
* @link https://themehybrid.com/plugins/members
* @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
*/
namespace Members;
/**
* Users widget archive class.
*
* @since 2.0.0
* @access public
*/
class Widget_Users extends \WP_Widget {
/**
* Default arguments for the widget settings.
*
* @since 2.0.0
* @access public
* @var array
*/
public $defaults = array();
/**
* Set up the widget's unique name, ID, class, description, and other options.
*
* @since 2.0.0
* @access public
* @return void
*/
public function __construct() {
// Set up the widget options.
$widget_options = array(
'classname' => 'users',
'description' => esc_html__( 'Provides the ability to list the users of the site.', 'members' )
);
// Set up the widget control options.
$control_options = array(
'width' => 525,
'height' => 350,
'id_base' => 'members-widget-users'
);
// Create the widget.
parent::__construct( 'members-widget-users', esc_html__( 'Members: Users', 'members' ), $widget_options, $control_options );
// Set up the defaults.
$this->defaults = array(
'title' => esc_attr__( 'Users', 'members' ),
'order' => 'ASC',
'orderby' => 'login',
'role' => '',
'meta_key' => '',
'meta_value' => '',
'include' => '',
'exclude' => '',
'search' => '',
'offset' => '',
'number' => ''
);
}
/**
* Outputs the widget based on the arguments input through the widget controls.
*
* @since 2.0.0
* @access public
* @param array $sidebar
* @param array $instance
* @return void
*/
function widget( $sidebar, $instance ) {
$instance = wp_parse_args( $instance, $this->defaults );
// Set up the arguments for get_users().
$args = array(
'role' => $instance['role'],
'meta_key' => $instance['meta_key'],
'meta_value' => $instance['meta_value'],
'include' => ! empty( $instance['include'] ) ? explode( ',', $instance['include'] ) : '',
'exclude' => ! empty( $instance['exclude'] ) ? explode( ',', $instance['exclude'] ) : '',
'search' => $instance['search'],
'orderby' => $instance['orderby'],
'order' => $instance['order'],
'offset' => ! empty( $instance['offset'] ) ? intval( $instance['offset'] ) : '',
'number' => ! empty( $instance['number'] ) ? intval( $instance['number'] ) : '',
);
// Output the theme's $before_widget wrapper.
echo $sidebar['before_widget'];
// If a title was input by the user, display it.
if ( $instance['title'] )
echo $sidebar['before_title'] . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $sidebar['after_title'];
// Get users.
$users = get_users( $args );
// If users were found.
if ( ! empty( $users ) ) {
echo '
';
// Loop through each available user, creating a list item with a link to the user's archive.
foreach ( $users as $user ) {
$class = sanitize_html_class( "user-{$user->ID}" );
if ( is_author( $user->ID ) )
$class .= ' current-user';
printf(
'