├── readme.txt
└── widget.php


/readme.txt:
--------------------------------------------------------------------------------
 1 | === Plugin Name ===
 2 | Contributors: twodayslate
 3 | Donate link: http://zac.gorak.us
 4 | Tags: categories, widget, sidebar
 5 | Requires at least: 4.0
 6 | Tested up to: 5.0.3
 7 | Stable tag: 5.0
 8 | License: GPLv2 or later
 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html
10 | 
11 | Show your site's most recently used categories!
12 | 
13 | == Description ==
14 | 
15 | Widget to display your site's most recent categories. 
16 | 
17 | Current options:
18 | 
19 |  * Max number of categories to display
20 |  * Title
21 |  * Display date
22 |  * Icon (if set by [Simple Cateogry Icon](https://wordpress.org/plugins/simple-category-icons/))
23 |  * Display post count
24 | 
25 | GitHub: https://github.com/twodayslate/Recent-Categories-Widget
26 | 
27 | == Installation ==
28 | 
29 | Enable the widget in the sidebar
30 | 
31 | 1. Upload `widget.php` to the `/wp-content/plugins/` directory
32 | 2. Activate the plugin through the 'Plugins' menu in WordPress
33 | 3. Place `<?php the_widget('Recent_Categories_Widget'); ?>` in your templates
34 | 4. Or add the widget to your dynamic sidebar in the dashboard (Appearance -> Widgets).
35 | 
36 | == Frequently Asked Questions ==
37 | 
38 | = What options are there? =
39 | 
40 | You can set the max number of categories to show, the title, display icon, and the date.
41 | 
42 | = How can I contribute? =
43 | Feel free to submit an issue or a pull-request on [GitHub](https://github.com/twodayslate/Recent-Categories-Widget).
44 | 
45 | = What is the best way to contact you? =
46 | Check out [my website](http://zac.gorak.us) for a list of ways to do just that!
47 | 
48 | == Screenshots ==
49 | 
50 | 1. screenshot-1.png widget shown in sidebar of Twenty Fifteen
51 | 
52 | == Changelog ==
53 | 
54 | = 1.0 =
55 | * Initial Release
56 | 
57 | = 1.1 =
58 | * Added support for [Simple Cateogry Icon](https://wordpress.org/plugins/simple-category-icons/)
59 | 
60 | = 1.2 =
61 | * Rewrite
62 | * Added post count option
63 | 
64 | = 1.3 =
65 | * Added before_title and after_title support
66 | * Bug fixes
67 | 
68 | == Upgrade Notice == 
69 | 
70 | = 1.0 =
71 | First release. 
72 | 
73 | = 1.1 = 
74 | If you want icon support it is recommended that you upgrade. 
75 | 
76 | = 1.2 =
77 | Rewrite to add post count option
78 | 
79 | = 1.3 = 
80 | n/a


--------------------------------------------------------------------------------
/widget.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /* 
  3 | Plugin Name: Recent Categories
  4 | Plugin URI: http://zac.gorak.us
  5 | Description: Recently Used Categories
  6 | Author: @twodayslate
  7 | Version: 1.3
  8 | Author URI: http://zac.gorak.us
  9 | */
 10 | 
 11 | // Block direct requests
 12 | if ( !defined('ABSPATH') )
 13 | 	die('-1');
 14 | 	
 15 | 	
 16 | add_action( 'widgets_init', function(){
 17 |      register_widget( 'Recent_Categories_Widget' );
 18 | });	
 19 | 
 20 | /**
 21 |  * Adds My_Widget widget.
 22 |  */
 23 | class Recent_Categories_Widget extends WP_Widget {
 24 | 
 25 | 	/**
 26 | 	 * Register widget with WordPress.
 27 | 	 */
 28 | 
 29 | 
 30 |         function __construct() {
 31 | 
 32 | 
 33 | 
 34 | 		parent::__construct(
 35 | 			'Recent_Categories_Widget', // Base ID
 36 | 			__('Recent Categories', 'text_domain'), // Name
 37 | 			array('description' => __( "You site's most recent categories.", 'text_domain' ),) // Args
 38 | 		);
 39 | 
 40 | 	}
 41 | 
 42 | 	/**
 43 | 	 * Front-end display of widget.
 44 | 	 *
 45 | 	 * @see WP_Widget::widget()
 46 | 	 *
 47 | 	 * @param array $args     Widget arguments.
 48 | 	 * @param array $instance Saved values from database.
 49 | 	 */
 50 | 	public function widget( $args, $instance ) {
 51 | 		
 52 | 		// get the excerpt of the required story
 53 | 		if ( isset( $instance[ 'max_count' ] ) ) {
 54 | 			$max_count = $instance[ 'max_count' ];
 55 | 		}
 56 | 		else {
 57 | 			$max_count = 5;
 58 | 		}
 59 | 
 60 | 		if ( isset( $instance[ 'title' ] ) && !empty($instance['title'] )) {
 61 | 			$title = $instance[ 'title' ];
 62 | 		}
 63 | 		else {
 64 | 			$title = "Recent Categories";
 65 | 		}
 66 | 		if ( isset( $instance[ 'display_date' ] ) ) {
 67 | 			$display_date = $instance[ 'display_date' ] ? true : false;
 68 | 		}
 69 | 		if ( isset( $instance[ 'display_icon' ] ) ) {
 70 | 			$display_icon = $instance[ 'display_icon' ] ? true : false;
 71 | 		}
 72 | 		if ( isset( $instance[ 'display_count' ] ) ) {
 73 | 			$display_count = $instance[ 'display_count' ] ? true : false;
 74 | 		}
 75 | 		
 76 | 		//if ( array_key_exists('before_widget', $args) ) echo $args['before_widget'];
 77 | 
 78 | 		if (array_key_exists('before_widget', $args)) {
 79 |                 echo str_replace('widget_recent_categories_widget', 'widget_recent_categories_widget widget_recent_entries', $args['before_widget']);
 80 |         }
 81 | 		
 82 | 		$post_args = array(
 83 | 	    'numberposts' => $max_count,
 84 | 	    'offset' => 0,
 85 | 	    'orderby' => 'post_date',
 86 | 	    'order' => 'DESC',
 87 | 	    'post_type' => 'post',
 88 | 	    'post_status' => 'publish',
 89 | 	    'suppress_filters' => true );
 90 | 
 91 | 	    $recent_posts = get_posts( $post_args );
 92 | 
 93 | 		if ( array_key_exists('before_title', $args) ) {
 94 | 			echo $args['before_title'];
 95 | 		} else {
 96 | 			echo '<h2 class="widget-title">';
 97 | 		}
 98 | 	    echo $title;
 99 | 	    if ( array_key_exists('after_title', $args) ) {
100 | 			echo $args['after_title'];
101 | 		} else {
102 | 			echo '</h2>';
103 | 		}
104 | 
105 | 	    echo "<ul>";
106 | 	    $listed_categories = array();
107 | 	    foreach ($recent_posts as $apost) {
108 | 	    	$categories = get_the_category($apost->ID);
109 | 			foreach ($categories as $acategory) {
110 | 				if(!array_key_exists($acategory->cat_ID, $listed_categories)){
111 | 					$listed_categories[$acategory->cat_ID] = array("name" => $acategory->cat_name, "count" => 1, "date" => $apost->ID);
112 | 				} else {
113 | 					$listed_categories[$acategory->cat_ID]["count"] = $listed_categories[$acategory->cat_ID]["count"] + 1;
114 | 				}
115 | 			}
116 | 	    }
117 | 		
118 | 		foreach($listed_categories as $key => $value) {
119 | 			echo '<li class="cat-item cat-item-'.$key.'">';
120 | 			echo '<a href="'.get_category_link($key).'" title="' . $value["name"]. '">';
121 | 			if($display_icon) {
122 | 				if (function_exists('the_icon')) {
123 | 					echo the_icon(array('size' => 'small',
124 | 					'class' => 'icon'), $term_type = 'category',$id = $key, $use_term_id = null);
125 | 				}
126 | 			}
127 | 			echo $value["name"].'</a>';
128 | 			if($display_count) {
129 | 				echo ' ('.$value["count"].')';
130 | 			}
131 | 			if($display_date) {
132 | 				echo '<span class="post-date">'.get_the_date(get_option('date_format'),$value["date"]).'</span>';
133 | 			}
134 | 			echo "</li>";
135 | 		}
136 | 		
137 | 	    echo "</ul>";
138 | 
139 | 		if ( array_key_exists('after_widget', $args) ) {
140 | 			echo $args['after_widget'];
141 | 		}
142 | 	}
143 | 
144 | 	/**
145 | 	 * Back-end widget form.
146 | 	 *
147 | 	 * @see WP_Widget::form()
148 | 	 *
149 | 	 * @param array $instance Previously saved values from database.
150 | 	 */
151 | 	public function form( $instance ) {
152 | 		
153 | 		if ( isset( $instance[ 'max_count' ] ) ) {
154 | 			$max_count = $instance[ 'max_count' ];
155 | 		}
156 | 		else {
157 | 			$max_count = 5;
158 | 		}
159 | 
160 | 		if ( isset( $instance[ 'title' ] ) ) {
161 | 			$title = $instance[ 'title' ];
162 | 		}
163 | 
164 | 		?>
165 | 		
166 | 		<p>
167 | 			<label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:' ); ?>
168 | 				<input id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo $title ?>" />
169 | 			</label> 
170 | 		</p>
171 | 
172 | 		<p>
173 | 			<label for="<?php echo $this->get_field_id( 'max_count' ); ?>"><?php _e( 'Max number of categories to show:' ); ?>
174 | 				<input id="<?php echo $this->get_field_id( 'max_count' ); ?>" name="<?php echo $this->get_field_name( 'max_count' ); ?>" type="number" value="<?php echo $max_count ?>" size="3" />
175 | 			</label> 
176 | 		</p>
177 | 		<p>
178 | 			<input id="<?php echo $this->get_field_id( 'display_date' ); ?>" name="<?php echo $this->get_field_name( 'display_date' ); ?>" type="checkbox" <?php checked($instance['display_date'], 'on'); ?> />
179 | 			<label for="<?php echo $this->get_field_id( 'display_date' ); ?>"><?php _e( 'Display category date?' ); ?></label>
180 | 		</p>
181 | 		<p>
182 | 			<input id="<?php echo $this->get_field_id( 'display_count' ); ?>" name="<?php echo $this->get_field_name( 'display_count' ); ?>" type="checkbox" <?php checked($instance['display_count'], 'on'); ?> />
183 | 			<label for="<?php echo $this->get_field_id( 'display_count' ); ?>"><?php _e( 'Show post counts' ); ?></label>
184 | 		</p>
185 | 		<?php if (function_exists('the_icon')) { ?>
186 | 		<p>
187 | 			<input id="<?php echo $this->get_field_id( 'display_icon' ); ?>" name="<?php echo $this->get_field_name( 'display_icon' ); ?>" type="checkbox" <?php checked($instance['display_icon'], 'on'); ?> />
188 | 			<label for="<?php echo $this->get_field_id( 'display_icon' ); ?>"><?php _e( 'Display category icon?' ); ?></label>
189 | 		</p>
190 | 		<?php } ?>
191 | 
192 | 		<?php 
193 | 	}
194 | 
195 | 	/**
196 | 	 * Sanitize widget form values as they are saved.
197 | 	 *
198 | 	 * @see WP_Widget::update()
199 | 	 *
200 | 	 * @param array $new_instance Values just sent to be saved.
201 | 	 * @param array $old_instance Previously saved values from database.
202 | 	 *
203 | 	 * @return array Updated safe values to be saved.
204 | 	 */
205 | 	public function update( $new_instance, $old_instance ) {
206 | 		
207 | 		$instance = $old_instance;
208 | 		$instance['max_count'] = ( ! empty( $new_instance['max_count'] ) ) ? strip_tags( $new_instance['max_count'] ) : 5;
209 | 		$instance['title'] = ( ! empty( $new_instance['title'] ) ) ? strip_tags( $new_instance['title'] ) : '';
210 | 		$instance['display_date'] = $new_instance['display_date'] ;
211 | 		$instance['display_icon'] = $new_instance['display_icon'] ;
212 | 		$instance['display_count'] = $new_instance['display_count'] ;
213 | 
214 | 		return $instance;
215 | 	}
216 | 
217 | } // class My_Widget
218 | 


--------------------------------------------------------------------------------