* @copyright Copyright (c) 2008 - 2014, Justin Tadlock * @link http://themehybrid.com/hybrid-core * @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html */ /** * Authors Widget Class * * @since 0.6.0 */ class Hybrid_Widget_Authors 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 1.2.0 * @access public * @return void */ function __construct() { /* Set up the widget options. */ $widget_options = array( 'classname' => 'widget-authors', 'description' => esc_html__( 'An advanced widget that gives you total control over the output of your author lists.', 'hybrid-core' ) ); /* Set up the widget control options. */ $control_options = array( 'width' => 525, 'height' => 350 ); /* Create the widget. */ $this->WP_Widget( 'hybrid-authors', __( 'Authors', 'hybrid-core' ), $widget_options, $control_options ); /* Set up defaults. */ $this->defaults = array( 'title' => esc_attr__( 'Authors', 'hybrid-core' ), 'order' => 'ASC', 'orderby' => 'display_name', 'number' => '', 'include' => '', 'exclude' => '', 'optioncount' => false, 'exclude_admin' => false, 'show_fullname' => true, 'hide_empty' => true, 'style' => 'list', 'html' => true, 'feed' => '', 'feed_image' => '' ); } /** * Outputs the widget based on the arguments input through the widget controls. * * @since 0.6.0 * @access public * @param array $sidebar * @param array $instance * @return void */ function widget( $sidebar, $instance ) { /* Set the $args for wp_list_authors() to the $instance array. */ $args = wp_parse_args( $instance, $this->defaults ); /* Overwrite the $echo argument and set it to false. */ $args['echo'] = false; /* Output the sidebar's $before_widget wrapper. */ echo $sidebar['before_widget']; /* If a title was input by the user, display it. */ if ( !empty( $args['title'] ) ) echo $sidebar['before_title'] . apply_filters( 'widget_title', $args['title'], $instance, $this->id_base ) . $sidebar['after_title']; /* Get the authors list. */ $authors = str_replace( array( "\r", "\n", "\t" ), '', wp_list_authors( $args ) ); /* If 'list' is the style and the output should be HTML, wrap the authors in a
. */ elseif ( 'none' == $args['style'] && $args['html'] ) $authors = '
'; /* Display the authors list. */ echo $authors; /* Close the sidebar's widget wrapper. */ echo $sidebar['after_widget']; } /** * The update callback for the widget control options. This method is used to sanitize and/or * validate the options before saving them into the database. * * @since 0.6.0 * @access public * @param array $new_instance * @param array $old_instance * @return array */ function update( $new_instance, $old_instance ) { /* Strip tags. */ $instance['title'] = strip_tags( $new_instance['title'] ); $instance['feed'] = strip_tags( $new_instance['feed'] ); /* Whitelist options. */ $order = array( 'ASC', 'DESC' ); $orderby = array( 'display_name', 'email', 'ID', 'nicename', 'post_count', 'registered', 'url', 'user_login' ); $style = array( 'list', 'none' ); $instance['order'] = in_array( $new_instance['order'], $order ) ? $new_instance['order'] : 'ASC'; $instance['orderby'] = in_array( $new_instance['orderby'], $orderby ) ? $new_instance['orderby'] : 'display_name'; $instance['style'] = in_array( $new_instance['style'], $style ) ? $new_instance['style'] : 'list'; /* Integers. */ $instance['number'] = intval( $new_instance['number'] ); /* Only allow integers and commas. */ $instance['include'] = preg_replace( '/[^0-9,]/', '', $new_instance['include'] ); $instance['exclude'] = preg_replace( '/[^0-9,]/', '', $new_instance['exclude'] ); /* URLs. */ $instance['feed_image'] = esc_url_raw( $new_instance['feed_image'] ); /* Checkboxes. */ $instance['html'] = isset( $new_instance['html'] ) ? 1 : 0; $instance['optioncount'] = isset( $new_instance['optioncount'] ) ? 1 : 0; $instance['exclude_admin'] = isset( $new_instance['exclude_admin'] ) ? 1 : 0; $instance['show_fullname'] = isset( $new_instance['show_fullname'] ) ? 1 : 0; $instance['hide_empty'] = isset( $new_instance['hide_empty'] ) ? 1 : 0; /* Return sanitized options. */ return $instance; } /** * Displays the widget control options in the Widgets admin screen. * * @since 0.6.0 * @access public * @param array $instance * @param void */ function form( $instance ) { /* Merge the user-selected arguments with the defaults. */ $instance = wp_parse_args( (array) $instance, $this->defaults ); $order = array( 'ASC' => esc_attr__( 'Ascending', 'hybrid-core' ), 'DESC' => esc_attr__( 'Descending', 'hybrid-core' ) ); $orderby = array( 'display_name' => esc_attr__( 'Display Name', 'hybrid-core' ), 'email' => esc_attr__( 'Email', 'hybrid-core' ), 'ID' => esc_attr__( 'ID', 'hybrid-core' ), 'nicename' => esc_attr__( 'Nice Name', 'hybrid-core' ), 'post_count' => esc_attr__( 'Post Count', 'hybrid-core' ), 'registered' => esc_attr__( 'Registered', 'hybrid-core' ), 'url' => esc_attr__( 'URL', 'hybrid-core' ), 'user_login' => esc_attr__( 'Login', 'hybrid-core' ) ); $style = array( 'list' => esc_attr__( 'List', 'hybrid-core'), 'none' => esc_attr__( 'None', 'hybrid-core' ) ); ?>