widget-popular.php

<?php
/**
 * Core Functionality Plugin
 * 
 * @package    CoreFunctionality
 * @since      1.0.0
 * @copyright  Copyright (c) 2014, Bill Erickson & Jared Atchison
 * @license    GPL-2.0+
 */

/**
 * Popular Posts Widget
 *
 * @since 1.0.0
 */
class EA_Popular_Widget extends WP_Widget {

	/**
	 * Holds widget settings defaults, populated in constructor.
	 *
	 * @since 1.0.0
	 * @var array
	 */
	protected $defaults;

	/**
	 * Constructor
	 *
	 * @since 1.0.0
	 */
	function __construct() {

		// widget defaults
		$this->defaults = array(
			'title'          => '',
			'count'          => 3,
		);
		
		// Widget Slug
		$widget_slug = 'widget_popular';

		// widget basics
		$widget_ops = array(
			'classname'   => $widget_slug,
			'description' => 'Displays popular posts based on share count.'
		);

		// widget controls
		$control_ops = array(
			'id_base' => $widget_slug,
			//'width'   => '400',
		);

		// load widget
		parent::__construct( $widget_slug, 'Popular Posts Widget', $widget_ops, $control_ops );		

	}

	/**
	 * Outputs the HTML for this widget.
	 *
	 * @since 1.0.0
	 * @param array $args An array of standard parameters for widgets in this theme 
	 * @param array $instance An array of settings for this widget instance 
	 */
	function widget( $args, $instance ) {

		extract( $args );

		// Merge with defaults
		$instance = wp_parse_args( (array) $instance, $this->defaults );

		echo $before_widget;
			
		$count = $instance['count'] ? (int) esc_attr( $instance['count'] ) : 3;
		$loop = new WP_Query( array( 
			'posts_per_page' => $count,
			'orderby'        => 'meta_value_num',
			'meta_key'       => 'ea_share_count_total',
		) );
		if( $loop->have_posts() ):

			if ( !empty( $instance['title'] ) ) { 
				echo $before_title . apply_filters( 'widget_title', $instance['title'] ) . $after_title;
			}
			
			echo '<ul>';
			while( $loop->have_posts() ): $loop->the_post();
			
				// Format the post output however you like
				echo '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';			
				
			endwhile;

		endif;
		wp_reset_postdata();

		echo $after_widget;
	}

	/**
	 * Deals with the settings when they are saved by the admin. Here is
	 * where any validation should be dealt with.
	 *
	 * @since 1.0.0
	 * @param array $new_instance An array of new settings as submitted by the admin
	 * @param array $old_instance An array of the previous settings 
	 * @return array The validated and (if necessary) amended settings
	 */
	function update( $new_instance, $old_instance ) {

		$new_instance['title']           = strip_tags( $new_instance['title'] );
		$new_instance['count']           = (int) esc_attr( $new_instance['count'] );

		return $new_instance;
	}

	/**
	 * Displays the form for this widget on the Widgets page of the WP Admin area.
	 *
	 * @since 1.0.0
	 * @param array $instance An array of the current settings for this widget
	 */
	function form( $instance ) {

		// Merge with defaults
		$instance = wp_parse_args( (array) $instance, $this->defaults );
		?>
		<p>
			<label for="<?php echo $this->get_field_id( 'title' ); ?>">Title:</label>
			<input type="text" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" value="<?php echo esc_attr( $instance['title'] ); ?>" class="widefat" />
		</p>
		<p>
			<label for="<?php echo $this->get_field_id( 'count' ); ?>">How Many Posts:</label>
			<input type="text" id="<?php echo $this->get_field_id( 'count' ); ?>" name="<?php echo $this->get_field_name( 'count' ); ?>" value="<?php echo esc_attr( $instance['count'] ); ?>" class="widefat" />
		</p>
		<?php
	}
}
add_action( 'widgets_init', create_function( '', "register_widget('EA_Popular_Widget');" ) );