Mark-k

Daniel Floeter

Mrinal Roy

<p>Category Posts Widget is a light widget designed to do one thing and do it well: display the most recent posts from a certain category.</p>
<h4>Term and Category based Posts Widget</h4>
<p>A premium version of that free widget available at <a href="https://tiptoppress.com/" rel="nofollow ugc">tiptoppress.com</a> created for big WordPress sites.</p>
<h4>Premium features</h4>
<ul>
<li>Auto-sizing Grid layout</li>
<li>Custom field support in the Template</li>
<li>Shortcode support in the Template</li>
<li>Image-Slider (or News-Ticker)</li>
<li>Asymmetrical list layouts</li>
<li>Full background images</li>
<li>Masonry responsive grid layout</li>
<li>More complex filter (ANY, NOT, AND, …)</li>
<li>Custom Post Types, Events, Products support</li>
<li>All free features</li>
<li>E-Mail support</li>
<li>More examples on the <a href="https://demo.tiptoppress.com/" rel="nofollow ugc">demo pages</a></li>
</ul>
<h4>Features</h4>
<ul>
<li><a href="https://tiptoppress.com/template-arrange-post-details/" rel="nofollow ugc">Template</a> to arrange the post details.</li>
<li>The Template text can be a post details placeholder, plain text, HTML or a font-icons.</li>
<li>Font-icon support.</li>
<li>‘Load more’ button / Ajax API</li>
<li>Item Title heading level buttons</li>
<li>Excerpt length and item title in lines (line-clamp)</li>
<li>Shortcode (Easily change all Shortcode options in the customizer).</li>
<li>Date range filter</li>
<li>New date format: Time since plublished</li>
<li>Filter by post status: Published, scheduled, private.</li>
<li>Multiple shortcodes at the same site or post.</li>
<li>Add option for post offset (use two or more widgets after another).</li>
<li>Admin UI: Buttons in the editor toolbar to insert shortcode.</li>
<li>Option to touch device friendly “everything is a link”.</li>
<li>For editing shortcode adds a Customizer link to the admin-bar (“With one click to the Customizer”).</li>
<li>Set thumbnail width & height / image crop with CSS (object-fit).</li>
<li>Fluid images (max-width in %).</li>
<li>One thumb dimension can be left empty.</li>
<li>Option to set mouse hover effects for post thumbnail.</li>
<li>Set a default thumbnail.</li>
<li>Hide widget text or text, if there is no post.</li>
<li>Option to hide posts which have no thumbnail.</li>
<li>Option exclude current post.</li>
<li>Option show post author, comment’s count, post date.</li>
<li>Admin UI: Set / find thumbnail size buttons: +, ¼, ½, 2x, -, ratio and Media sizes</li>
<li>Admin UI: Buttons to easy add post details placeholder.</li>
<li>Multi sites support.</li>
</ul>
<h4>Documentation</h4>
<ul>
<li>Full <a href="https://tiptoppress.com/category-posts-widget/documentation-4-9" rel="nofollow ugc">documentation</a></li>
<li>Shortcode: Use [catposts] in the content and <a href="https://tiptoppress.com/use-shortcode-to-add-category-posts-widget-to-the-content/" rel="nofollow ugc">edit in the customizer</a></li>
<li>Formatting date and time: See <a href="https://codex.wordpress.org/Formatting_Date_and_Time" rel="nofollow ugc">Formatting Date and Time</a></li>
</ul>
<h4>Contribute</h4>
<p>While using this plugin if you find any bug or any conflict, please submit an issue at<br />
<a href="https://github.com/DanielFloeter/category-posts-widget" rel="nofollow ugc">Github</a> (If possible with a pull request).</p>


Category Posts Widget

Very easy to customize the view, as a widget or shortcode. Utilizes the customizer to customize the shortcode display. Elegant.

Very useful and works perfect

Adds a widget that shows the most recent posts from a single category.

aryanduntley

<p>With the general posts widget, you can place a list of posts into your widget areas based on any query parameters available in WP_QUERY.  You can generate the latest posts, popular posts (given you have some method of tracking post hits), post types, filter by category or other taxonomy, filter by post meta, etc…  If it’s available in WP_QUERY it’s available to you in the widget.  If there are customizations that the interface does not allow for, there are a number of hooks that allow you to edit and control pretty much any part of the widget from adjusting the query to adjusting the output.</p>
<h4>Please Note</h4>
<p>There is no styling associated with this plugin.  If you wish to style the output, assign a class and/or an ID to the widget and style appropriately in your style.css file.</p>
<blockquote>
<h4>Available Hooks</h4>
<ul>
<li><code>add_filter( 'widget_title', 'my_Func'); function my_Func($title){return $title;}</code></li>
<li><code>add_filter('wpr_adjust_genposts_query','my_Func', 10, 3); function my_Func( $queryargs, $widgetargs, $instance){return $queryargs}</code><br />
  <code>$widgetargs</code> contains things like <code>before_widget</code> and <code>after_widget</code>.  <code>$instance</code> contains the widget params you added in the UI.</li>
<li><code>add_filter('wpr_genposts_titlefilter', 'my_Func', 10, 6); function my_Func($fintitle, $before_title, $title, $after_title, $instance){return $fintitle}</code></li>
<li><code>add_filter</code>(‘wpr_genposts_listloop’, ‘my_Func’, 10, 5); function my_Func($thisprint, $found_posts, $post, $count, $instance){return $thisprint;}<br />
  This filter is within the loop that prints the <code><li>'s</code>.  <code>$thisprint</code> is the final string containing all the html including the <code><li></code> opening and closing tags. This filter will likely be the one used the most.  By default, this outputs the featured image (if one exists) and the title.  That’s all.  In order to edit the output of the loop, you would want to edit your my_Func function to something else, utilizing the $post variable which contains all the post information (title, excerpt, content, permalink, ect…).  This is up to you to customize however you wish.  I’m sure the support area will fill up with questions in regards to outputting the lists in a certain fashion.  Most people will not read or understand this that I wrote here and many examples will likely sprout up in the support section, so stay tuned and read through those (unless you are the very first to ask for support) before posting a support question.  This plugin is free and support should not be expected.  I will have a general support license available at a later time, for all WPR plugins, but for now, don’t expect, but be grateful if I do answer.  I’m usually good about it though.</li>
<li><code>add_filter('wpr_genposts_addtoend', 'my_Func', 10, 2); function my_Func($readingon, $instance){return $readingon;}</code><br />
  This filter allows you to customize the read more link that is shown after all the posts are displayed.  The final text/html is the <code>$readingon</code> variable and the <code>$instance</code> provides you with all the widget instance params you supplied in the widget interface.</li>
<li><code>add_filter('wpr_genposts_list_print', 'my_Func', 10, 6); function my_Func($finalprint, $openprint, $toprint, $closeprint, $instance, $wpQuery){return $finalprint;}</code><br />
  This supplies the final list with the container divs and everything else.  <code>$openprint</code> contains the opening div with the id and class supplied by the widget interface.  It also includes the openieng <code><ul></code> tag.  <code>$closeprint</code> contains all the closure tags for the <code>$openprint</code> as well as the readmore link/text.  <code>$toprint</code> contains everything in between (the result of the query contained in <code><li></code> tags). <code>$wpQuery</code> contains the WP_Query instance, which can be used for pagination or anything else where the data provided could be useful. To add pagination, something like this would work:<br />
  <code>function homeAddPages($finalprint, $openprint, $toprint, $closeprint, $instance, $postsQ){<br />
  $big = 999999999;<br />
  $cpage = get_query_var('paged')?get_query_var('paged'):0;<br />
  if(!isset($cpage) || $cpage == "" || $cpage === 0){<br />
      $cpage = get_query_var('page')?get_query_var('page'):1;<br />
  }<br />
  $addclose = paginate_links( array(<br />
      'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),<br />
      'format' => '?paged=%#%',<br />
      'current' => max( 1, $cpage),<br />
      'total' => $postsQ->max_num_pages<br />
  ) );<br />
  return $openprint . $toprint . $closeprint . '<div class="hpaginator">' . $addclose . '</div>';<br />
  }<br />
  add_filter('wpr_genposts_list_print', 'homeAddPages', 10, 6);</code></li>
<li><code>add_filter('wpr_adjust_genposts_beforewidget', 'my_Func', 10, 3); function my_Func($before_widget, $post_widgeid, $post_widgeclass){return $before_widget;}</code><br />
  This allows you to modify the before widget string which contains the wrapper div with id and class. You have access to the ID and Class you defined within the widget in order to tell instances apart from each other.<br />
  <code>unction wpr_changeBeforeWidget($before_widget, $post_widgeid, $post_widgeclass){<br />
  if($post_widgeid == 'theothers'){<br />
      return str_replace('class="', 'class="theothersblock ', $before_widget);<br />
  }<br />
  if($post_widgeid == 'thefeatured'){<br />
      return str_replace('class="', 'class="thefeaturedblock ', $before_widget);<br />
  }<br />
  return $before_widget;<br />
  }<br />
  add_filter('wpr_adjust_genposts_beforewidget', 'wpr_changeBeforeWidget', 10, 3);</code></li>
<li><code>add_filter('wpr_adjust_genposts_afterwidget', 'my_Func', 10, 3); function my_Func($after_widget, $post_widgeid, $post_widgeclass){return $after_widget;}</code><br />
  This is identical to the wpr_adjust_genposts_beforewidget hook except this one allows you to modify the after widget string. These last two allow you direct control over each individual widget container. These before and after strings are set in the register_sidebar function when creating the sidebars, but they are generic for all widgets in that sidebar and WP does not offer any hooks to modify this directly. There is a workaround to add the action for register_sidebar, get the sidebar object and then adjust the $wp_registered_sidebars global, but in order to do this, you would have to know the order id number of the specific widget. Doing it that way can be problematic.</li>
</ul>
</blockquote>
<blockquote>
<h4>Instance Variables</h4>
<ul>
<li><code>$title = apply_filters( 'widget_title', $instance['title'] );</code></li>
<li><code>$post_amount = $instance['show'];</code> This is the posts per page (total posts to show)</li>
<li><code>$post_orderby = $instance['orderby'];</code></li>
<li><code>$post_order = $instance['order'];</code></li>
<li><code>$post_catin = $instance['catin'];</code> Category In</li>
<li><code>$post_catout = $instance['catout'];</code> Category Exclude</li>
<li><code>$pagecount = $instance['pagecount'];</code> Numer of Posts to show (not used, this is so you can define total posts to query and number to show per tabbed interface which is not implemented in the plugin, but available for hooking)</li>
<li><code>$post_taxis = $instance['taxis'];</code> Taxonamy slug</li>
<li><code>$post_taxterm = $instance['taxterm'];</code> Taxonomy term ids, comma separated list</li>
<li><code>$post_typed = $instance['ptipe'];</code></li>
<li><code>$post_metakey = $instance['metakey'];</code></li>
<li><code>$post_metavalue = $instance['metavalue'];</code></li>
<li><code>$post_comparison = $instance['metacompare'];</code> Meta comparison operator</li>
<li><code>$post_widgeid = $instance['widgetidentifier'];</code> Widget Container ID</li>
<li><code>$post_widgeclass = $instance['widgetclassifier'];</code> Widget Container Class</li>
<li><code>$post_readmoretitle = $instance['readmoretitle'];</code></li>
<li><code>$post_readmorelink = $instance['readmorelink'];</code></li>
</ul>
</blockquote>
<p>Plugin site: <a href="http://worldpressrevolution.com/wpr_myplugins/wpr-general-posts-widget/" title="Aryan Duntley's Worldpress Revolution wordpress tutorials" rel="nofollow ugc">WorldpressRevolution</a></p>


WPR General Posts

Gives you full control of a post listing widget.

Category Posts Widget vs WPR General Posts