* @copyright Copyright (c) 2008 - 2012, Justin Tadlock
* @link http://themehybrid.com/hybrid-core
* @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
*/
/**
* Categories Widget Class
*
* @since 0.6.0
*/
class Hybrid_Widget_Categories extends WP_Widget {
/**
* Set up the widget's unique name, ID, class, description, and other options.
*
* @since 1.2.0
*/
function __construct() {
/* Set up the widget options. */
$widget_options = array(
'classname' => 'categories',
'description' => esc_html__( 'An advanced widget that gives you total control over the output of your category links.', 'hybrid-core' )
);
/* Set up the widget control options. */
$control_options = array(
'width' => 800,
'height' => 350
);
/* Create the widget. */
$this->WP_Widget(
'hybrid-categories', // $this->id_base
__( 'Categories', 'hybrid-core' ), // $this->name
$widget_options, // $this->widget_options
$control_options // $this->control_options
);
}
/**
* Outputs the widget based on the arguments input through the widget controls.
*
* @since 0.6.0
*/
function widget( $sidebar, $instance ) {
extract( $sidebar );
/* Set the $args for wp_list_categories() to the $instance array. */
$args = $instance;
/* Set the $title_li and $echo arguments to false. */
$args['title_li'] = false;
$args['echo'] = false;
/* Output the theme's widget wrapper. */
echo $before_widget;
/* If a title was input by the user, display it. */
if ( !empty( $instance['title'] ) )
echo $before_title . apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ) . $after_title;
/* Get the categories list. */
$categories = str_replace( array( "\r", "\n", "\t" ), '', wp_list_categories( $args ) );
/* If 'list' is the user-selected style, wrap the categories in an unordered list. */
if ( 'list' == $args['style'] )
$categories = '
' . $categories . '
';
/* Output the categories list. */
echo $categories;
/* Close the theme's widget wrapper. */
echo $after_widget;
}
/**
* Updates the widget control options for the particular instance of the widget.
*
* @since 0.6.0
*/
function update( $new_instance, $old_instance ) {
$instance = $old_instance;
/* Set the instance to the new instance. */
$instance = $new_instance;
/* If new taxonomy is chosen, reset includes and excludes. */
if ( $instance['taxonomy'] !== $old_instance['taxonomy'] && '' !== $old_instance['taxonomy'] ) {
$instance['include'] = array();
$instance['exclude'] = array();
}
$instance['title'] = strip_tags( $new_instance['title'] );
$instance['taxonomy'] = $new_instance['taxonomy'];
$instance['depth'] = strip_tags( $new_instance['depth'] );
$instance['number'] = strip_tags( $new_instance['number'] );
$instance['child_of'] = strip_tags( $new_instance['child_of'] );
$instance['current_category'] = strip_tags( $new_instance['current_category'] );
$instance['feed'] = strip_tags( $new_instance['feed'] );
$instance['feed_image'] = esc_url( $new_instance['feed_image'] );
$instance['search'] = strip_tags( $new_instance['search'] );
$instance['include'] = preg_replace( '/[^0-9,]/', '', $new_instance['include'] );
$instance['exclude'] = preg_replace( '/[^0-9,]/', '', $new_instance['exclude'] );
$instance['exclude_tree'] = preg_replace( '/[^0-9,]/', '', $new_instance['exclude_tree'] );
$instance['hierarchical'] = ( isset( $new_instance['hierarchical'] ) ? 1 : 0 );
$instance['use_desc_for_title'] = ( isset( $new_instance['use_desc_for_title'] ) ? 1 : 0 );
$instance['show_count'] = ( isset( $new_instance['show_count'] ) ? 1 : 0 );
$instance['hide_empty'] = ( isset( $new_instance['hide_empty'] ) ? 1 : 0 );
return $instance;
}
/**
* Displays the widget control options in the Widgets admin screen.
*
* @since 0.6.0
*/
function form( $instance ) {
/* Set up the default form values. */
$defaults = array(
'title' => esc_attr__( 'Categories', 'hybrid-core' ),
'taxonomy' => 'category',
'style' => 'list',
'include' => '',
'exclude' => '',
'exclude_tree' => '',
'child_of' => '',
'current_category' => '',
'search' => '',
'hierarchical' => true,
'hide_empty' => true,
'order' => 'ASC',
'orderby' => 'name',
'depth' => 0,
'number' => '',
'feed' => '',
'feed_type' => '',
'feed_image' => '',
'use_desc_for_title' => false,
'show_count' => false,
);
/* Merge the user-selected arguments with the defaults. */
$instance = wp_parse_args( (array) $instance, $defaults );
/*