From e053e2923fdcb257241f13c57aea5e443a385b69 Mon Sep 17 00:00:00 2001
From: Jeff Sternberg <jeffsternberg@gmail.com>
Date: Thu, 23 Apr 2015 18:35:16 -0400
Subject: [PATCH 1/3] extendable fn to override zone post widget rendering

---
 widget.zone-posts.php | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/widget.zone-posts.php b/widget.zone-posts.php
index c5b3ba3..7c04c1f 100644
--- a/widget.zone-posts.php
+++ b/widget.zone-posts.php
@@ -60,13 +60,9 @@ function widget( $args, $instance ) {
 		<?php endif; ?>
 
 		<ul>
-			<?php foreach ( $posts as $post ) : ?>
-				<li>
-					<a href="<?php echo esc_url( get_permalink( $post->ID ) ); ?>">
-						<?php echo esc_html( get_the_title( $post->ID ) ); ?>
-					</a>
-				</li>
-			<?php endforeach; ?>
+			<?php foreach ( $posts as $post ) {
+                $this->widget_post( $post );
+            };?>
 		</ul>
 
 		<?php echo wp_kses_post( $args['after_widget'] ); ?>
@@ -81,6 +77,18 @@ function widget( $args, $instance ) {
 		wp_cache_set( 'widget-zone-posts', $cache, 'widget' );
 	}
 
+    // extendable function to render a single post in a zone post widget
+    function widget_post( $post ) {
+        ?>
+        <li>
+            <img src="<?php echo esc_url( wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'single-post-thumbnail' )[0] ); ?>">
+            <a href="<?php echo esc_url( get_permalink( $post->ID ) ); ?>">
+                <?php echo esc_html( get_the_title( $post->ID ) ); ?>
+            </a>
+        </li>
+    <?php
+    }
+
 	function update( $new_instance, $old_instance ) {
 		$instance     = $old_instance;
 		$new_instance = wp_parse_args( (array) $new_instance, array( 'zone_id' => 0, 'show_description' => 0 ) );

From fa6c7d3dc01c19514fc292f755ea6b02324ee6cf Mon Sep 17 00:00:00 2001
From: Jeff Sternberg <jeffsternberg@gmail.com>
Date: Fri, 24 Apr 2015 09:06:06 -0400
Subject: [PATCH 2/3] apply filters for 'widget_zone_posts_renderer' if any

---
 widget.zone-posts.php | 35 ++++++++++++++++++++---------------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/widget.zone-posts.php b/widget.zone-posts.php
index 7c04c1f..10ac49e 100644
--- a/widget.zone-posts.php
+++ b/widget.zone-posts.php
@@ -57,13 +57,15 @@ function widget( $args, $instance ) {
 
 		<?php if ( ! empty( $zone->description ) && $show_description ) : ?>
 			<p class="description"><?php echo esc_html( $zone->description ); ?></p>
-		<?php endif; ?>
-
-		<ul>
-			<?php foreach ( $posts as $post ) {
-                $this->widget_post( $post );
-            };?>
-		</ul>
+		<?php endif;
+
+        if ( has_filter( 'widget_zone_posts_renderer' ) ) {
+            apply_filters('widget_zone_posts_renderer', $posts);
+        }
+        else {
+            $this->widget_posts( $posts );
+        }
+        ?>
 
 		<?php echo wp_kses_post( $args['after_widget'] ); ?>
 		<?php
@@ -77,15 +79,18 @@ function widget( $args, $instance ) {
 		wp_cache_set( 'widget-zone-posts', $cache, 'widget' );
 	}
 
-    // extendable function to render a single post in a zone post widget
-    function widget_post( $post ) {
+    // filterable function to render posts in a zone post widget
+    function widget_posts( $posts ) {
         ?>
-        <li>
-            <img src="<?php echo esc_url( wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'single-post-thumbnail' )[0] ); ?>">
-            <a href="<?php echo esc_url( get_permalink( $post->ID ) ); ?>">
-                <?php echo esc_html( get_the_title( $post->ID ) ); ?>
-            </a>
-        </li>
+        <ul>
+            <?php foreach ( $posts as $post ) : ?>
+                <li>
+                    <a href="<?php echo esc_url( get_permalink( $post->ID ) ); ?>">
+                        <?php echo esc_html( get_the_title( $post->ID ) ); ?>
+                    </a>
+                </li>
+            <?php endforeach; ?>
+        </ul>
     <?php
     }
 

From 6c8e7ea9a3dd0784aabee1de3fb54e817f338aef Mon Sep 17 00:00:00 2001
From: Jeff Sternberg <jeffsternberg@gmail.com>
Date: Mon, 27 Apr 2015 12:05:33 -0400
Subject: [PATCH 3/3] avoid echo in filter function; expect returned html
 instead

---
 widget.zone-posts.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/widget.zone-posts.php b/widget.zone-posts.php
index 10ac49e..6e4c46f 100644
--- a/widget.zone-posts.php
+++ b/widget.zone-posts.php
@@ -59,10 +59,10 @@ function widget( $args, $instance ) {
 			<p class="description"><?php echo esc_html( $zone->description ); ?></p>
 		<?php endif;
 
-        if ( has_filter( 'widget_zone_posts_renderer' ) ) {
-            apply_filters('widget_zone_posts_renderer', $posts);
-        }
-        else {
+        $html = apply_filters( 'widget_zone_posts_override_html', false, $posts );
+        if ( $html !== false ) {
+            echo $html;
+        } else {
             $this->widget_posts( $posts );
         }
         ?>