| 1 |
=== Category Posts Block === |
| 2 |
Contributors: mark-k, kometschuh, mkrdip |
| 3 |
Donate link: https://wordpress.org/support/plugin/category-posts/reviews/ |
| 4 |
Tags: block, category, categories, posts, recent posts |
| 5 |
Requires at least: 2.8 |
| 6 |
Tested up to: 7.1 |
| 7 |
Stable tag: 5.1.0 |
| 8 |
Requires PHP: 5.3 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Adds a block that shows the most recent posts from a single category. |
| 13 |
|
| 14 |
== Description == |
| 15 |
Category Posts Block is a light block designed to do one thing and do it well: display the most recent posts from a certain category. |
| 16 |
|
| 17 |
= Category Posts Block = |
| 18 |
Use the "Category Posts" block in the Gutenberg editor to place the post list anywhere in your content. All options are available in the block sidebar panels: Title, Filter, Details, Thumbnail, Excerpt, Footer, Load more and General. Several blocks can be used on the same page, each with its own settings. |
| 19 |
|
| 20 |
= Term and Category based Posts Block = |
| 21 |
A premium version of that free block available at [tiptoppress.com](https://tiptoppress.com/) created for big Wordpress sites. |
| 22 |
|
| 23 |
= Premium features = |
| 24 |
* Auto-sizing Grid layout |
| 25 |
* Custom field support in the Template |
| 26 |
* Shortcode support in the Template |
| 27 |
* Image-Slider (or News-Ticker) |
| 28 |
* Asymmetrical list layouts |
| 29 |
* Full background images |
| 30 |
* Masonry responsive grid layout |
| 31 |
* More complex filter (ANY, NOT, AND, ...) |
| 32 |
* Custom Post Types, Events, Products support |
| 33 |
* All free features |
| 34 |
* E-Mail support |
| 35 |
* More examples on the [demo pages](https://demo.tiptoppress.com/) |
| 36 |
|
| 37 |
= Features = |
| 38 |
* Block for the block editor and Site Editor. |
| 39 |
* [Template](https://tiptoppress.com/template-arrange-post-details/) to arrange the post details. |
| 40 |
* The Template text can be a post details placeholder, plain text, HTML or a font-icons. |
| 41 |
* Font-icon support |
| 42 |
* 'Load more' button / Ajax API |
| 43 |
* Item Title heading level buttons |
| 44 |
* Excerpt length and item title in lines (line-clamp) |
| 45 |
* Date range filter |
| 46 |
* New date format: Time since plublished |
| 47 |
* Filter by post status: Published, scheduled, private |
| 48 |
* Add option for post offset (use two or more widgets after another) |
| 49 |
* Admin UI: Buttons in the editor toolbar to insert shortcode |
| 50 |
* Option to touch device friendly "everything is a link" |
| 51 |
* Set thumbnail width & height / image crop with CSS (object-fit) |
| 52 |
* Fluid images (max-width in %) |
| 53 |
* One thumb dimension can be left empty |
| 54 |
* Option to set mouse hover effects for post thumbnail |
| 55 |
* Set a default thumbnail |
| 56 |
* Hide widget text or text, if there is no post |
| 57 |
* Option to hide posts which have no thumbnail |
| 58 |
* Option exclude current post |
| 59 |
* Option show post author, comment's count, post date |
| 60 |
* Admin UI: Set / find thumbnail size buttons: +, ¼, ½, 2x, -, ratio and Media sizes |
| 61 |
* Admin UI: Buttons to easy add post details placeholder |
| 62 |
|
| 63 |
= Documentation = |
| 64 |
* Full [documentation](https://tiptoppress.com/category-posts-widget/documentation-5-0) |
| 65 |
* Formatting date and time: See <a target="_blank" href="https://codex.wordpress.org/Formatting_Date_and_Time">Formatting Date and Time</a> |
| 66 |
|
| 67 |
= Contribute = |
| 68 |
While using this plugin if you find any bug or any conflict, please submit an issue at |
| 69 |
[Github](https://github.com/DanielFloeter/category-posts-widget) (If possible with a pull request). |
| 70 |
|
| 71 |
== Installation == |
| 72 |
= Automatic installation = |
| 73 |
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of Category Posts Block |
| 74 |
|
| 75 |
1. Log in to your WordPress dashboard, navigate to the Plugins menu and click Add New. |
| 76 |
2. In the search field type “Category Posts Block” and click Search Plugins. |
| 77 |
3. Once you’ve found plugin, you can install it by simply clicking “Install Now”. |
| 78 |
4. Then, go to plugins page of WordPress admin activate the plugin. |
| 79 |
5. Add the "Category Posts Block" to a post, page or template in the editor. |
| 80 |
|
| 81 |
= Manual installation = |
| 82 |
1. Download the plugin. |
| 83 |
2. Upload it to the plugins folder of your blog. |
| 84 |
3. Activate the plugin through the 'Plugins' menu in WordPress |
| 85 |
4. Add the "Category Posts Block" to a post, page or template in the editor. |
| 86 |
|
| 87 |
== Frequently Asked Questions == |
| 88 |
= Template, placeholder and post detail = |
| 89 |
Here You can control the [Post Detail parts](https://tiptoppress.com/category-posts-widget/documentation-5-0/#Post_details), which appears as part of the post item. All post detail will placed as placeholder. The text in the Template area can be a post details placeholder, plain text, HTML or HTML for SVG icons. |
| 90 |
|
| 91 |
[How it works? and examples.](https://tiptoppress.com/template-arrange-post-details/) |
| 92 |
|
| 93 |
For more layout options please try our premium widget: [Term and Category based Posts Widget](https://tiptoppress.com/term-and-category-based-posts-widget/). |
| 94 |
|
| 95 |
= Use SVG icons = |
| 96 |
For SVG font-icon HTML we recommend the [WordPress Dashicons](https://developer.wordpress.org/resource/dashicons/), which are included as default and can be used without any font-icon including. |
| 97 |
|
| 98 |
= The font-size is different from that of other widgets or Theme elements? = |
| 99 |
Use the option: 'Disable only font style' in the General panel. |
| 100 |
|
| 101 |
= I want the title as a link pointing to the selected Categorie page? = |
| 102 |
Is just a single category selected in the Filter panel: Enable the check box "Make widget title link". |
| 103 |
Is 'All categories' selected in the Filter panel: Use the text field 'Title link URL'. |
| 104 |
|
| 105 |
== Screenshots == |
| 106 |
1. Front end of the widget with SVG font-icon support for post formats, hover effects and the Template text-area. |
| 107 |
2. Widget behaviour settings for each user. |
| 108 |
3. The Category Posts block and its Template to arrange the post details with placeholders. |
| 109 |
|
| 110 |
== Changelog == |
| 111 |
[Read more on our blog ...](https://tiptoppress.com/category/category-posts-widget) |
| 112 |
|
| 113 |
= 5.1.0 - September 12th 2026 = |
| 114 |
* Show the whole image for logos |
| 115 |
* Bugfix Block-supports classes |
| 116 |
* Bugfix Wrap text around image |
| 117 |
|
| 118 |
= 5.0.0 - August 18th 2026 = |
| 119 |
* Category Posts Block for the Gutenberg editor |
| 120 |
|
| 121 |
= 4.9.22 - July 26th 2025 = |
| 122 |
* Calculate the attachment size |
| 123 |
|
| 124 |
= 4.9.21 - June 20th 2025 = |
| 125 |
* Replace classnames with clsx |
| 126 |
|
| 127 |
= 4.9.20 - April 2rd 2025 = |
| 128 |
* Fixed Sanitizes content |
| 129 |
* Fixed Error load more |
| 130 |
|
| 131 |
= 4.9.19 - March 10th 2025 = |
| 132 |
* Fixed Escap data |
| 133 |
|
| 134 |
= 4.9.18 - Oct 12th 2024 = |
| 135 |
* Fixed Sanitize Number fields |
| 136 |
|
| 137 |
= 4.9.17 - Juli 08th 2024 = |
| 138 |
* Fixed Sanitize text field |
| 139 |
|
| 140 |
= 4.9.16 - March 26th 2024 = |
| 141 |
* Fixed Deletion failed |
| 142 |
|
| 143 |
= 4.9.15 - May 2 2023 = |
| 144 |
* Fixed Image size |
| 145 |
|
| 146 |
= 4.9.14 - May 1 2023 = |
| 147 |
* Fixed Array string keys |
| 148 |
* Fixed Date since published |
| 149 |
|
| 150 |
= 4.9.13 - July 22 2021 = |
| 151 |
* Fixed Line number with WordPress 5.8 |
| 152 |
|
| 153 |
= 4.9.12 - July 20 2021 = |
| 154 |
* Deprecated jQuery warnings |
| 155 |
|
| 156 |
= 4.9.11 - April 15th 2021 = |
| 157 |
* Wiget title heading level buttons |
| 158 |
* Add sticky posts at start |
| 159 |
|
| 160 |
= 4.9.10 - December 15th 2020 = |
| 161 |
* Fixed Missing load more button |
| 162 |
|
| 163 |
= 4.9.9 - December 9th 2020 = |
| 164 |
* Load more placeholders |
| 165 |
|
| 166 |
= 4.9.8 - November 30th 2020 = |
| 167 |
* Date since published for n-days |
| 168 |
|
| 169 |
= 4.9.7 - November 21th 2020 = |
| 170 |
* Item title in lines (line-clamp) |
| 171 |
* Fixed Column layout |
| 172 |
* Fixed Image Html rendering |
| 173 |
|
| 174 |
= 4.9.6 - November 16th 2020 = |
| 175 |
* Item title heading level buttons |
| 176 |
* Excerpt-more link placeholder |
| 177 |
* Native WordPress filter CSS classes |
| 178 |
* Rework thumb handling |
| 179 |
|
| 180 |
= 4.9.5 - May 12th 2020 = |
| 181 |
* Fixed Widget_Title filter missing parameters |
| 182 |
|
| 183 |
= 4.9.4 - March 2th 2020 = |
| 184 |
* Fixed Delete global click event |
| 185 |
|
| 186 |
= 4.9.3 - March 18th 2020 = |
| 187 |
* Fixed Mouse hover icon and post format indication |
| 188 |
|
| 189 |
= 4.9.2 - Mai 23th 2019 = |
| 190 |
* Fixed Starts with post |
| 191 |
* Fixed Replace the figure-element |
| 192 |
|
| 193 |
= 4.9.1 - Mai 17th 2019 = |
| 194 |
* 'Load more' button / Ajax API |
| 195 |
* Data range filter |
| 196 |
* Text, if there is no post |
| 197 |
* Excerpt length in lines (line-clamp) |
| 198 |
* Image crop with CSS (object-fit) |
| 199 |
* Fluid images (max-width in %). |
| 200 |
* One thumb dimension can be left empty |
| 201 |
* Admin UI: Button to easy add post details placeholder |
| 202 |
* Admin UI: Set / find thumbnail size buttons: +, ¼, ½, 2x, -, ratio and Media sizes |
| 203 |
|
| 204 |
= 4.8.5 - April 02nd 2018 = |
| 205 |
* Fixed Tabs not working |
| 206 |
|
| 207 |
= 4.8.4 - April 02nd 2018 = |
| 208 |
* Fixed Make widget SiteOrigin Page Builder Compatible |
| 209 |
|
| 210 |
= 4.8.3 - March 03th 2018 = |
| 211 |
* Fixed Updated widget with zero for the thumb dimensions caused a JavaScript error |
| 212 |
|
| 213 |
= 4.8.2 - January 30th 2018 = |
| 214 |
* Fixed Adding the widget with the customizer only the title is shown |
| 215 |
* Fixed Recognize "Empty lines" > Next line is a paragraph in the Template in widget areas |
| 216 |
|
| 217 |
= 4.8.1 - January 25th 2018 = |
| 218 |
* Fixed Recognize "Empty lines" > Next line is a paragraph in the Template |
| 219 |
|
| 220 |
= 4.8 - January 22th 2018 = |
| 221 |
* SVG font-icon support for post formats |
| 222 |
* Template to arrange the post details |
| 223 |
* Premade Templates |
| 224 |
* Date format: Time since plublished |
| 225 |
* Filter by post status: Published, scheduled, private |
| 226 |
* Hover effect: SVG font-icon |
| 227 |
|
| 228 |
= 4.7.4 - October 21th 2017 = |
| 229 |
* Bugfix for filter by post status (note private) |
| 230 |
|
| 231 |
= 4.7.3 - October 10th 2017 = |
| 232 |
* Add option to filter by post status |
| 233 |
* Fixed footer section do not change when switching to and from "all posts" |
| 234 |
|
| 235 |
= 4.7.2 - February 25th 2017 = |
| 236 |
* Add option to disable only the font styles |
| 237 |
* Fixed if option 'Everything is a link' no closing anchor tag |
| 238 |
* Fixed if option 'Everyting is a link' wrong layout |
| 239 |
* Fixed when a manual excerpt is provided, use it instead of generating an automatic one |
| 240 |
* Fixed if option 'Disable the built-in CSS' the thumbnail client-side cropping isn't disabled |
| 241 |
* Fixed if option 'Disable the built-in CSS' title class is not rendered |
| 242 |
* Fixed when having multi shortcodes, clicking on a checkbox label marks in any of them selects the one in the "first" |
| 243 |
* Fixed if option 'CSS crop to requested size' for multi shortcodes |
| 244 |
* Fixed for CSS animation |
| 245 |
|
| 246 |
= 4.7.1 - December 20th 2016 = |
| 247 |
* Support multiple shortcodes in content |
| 248 |
* Add option for post offset (use two or more widgets after another) |
| 249 |
* Fluid images for Responsive Layouts |
| 250 |
* Set a thumbnail as default thumbnail |
| 251 |
* Add option to enable excerpt filters from Themes and plugins |
| 252 |
* Add option to disable social buttons, banner, ... in the excerpt |
| 253 |
* Add dropdownbox entry for 'all' categories |
| 254 |
* Add option to disable subcategories |
| 255 |
* Add insert shortcode buttons to the editor toolbar |
| 256 |
* Use WP user profile for settings ('auto close' and if the shortcode button appears in the editor toolbar) |
| 257 |
* Simple API for external use |
| 258 |
* Support localization with translate.wordpress.org: Portuguese (Brazil) thank you [Henrique Vianna](https://profiles.wordpress.org/hvianna/) and German by [Daniel Floeter](https://profiles.wordpress.org/kometschuh/) |
| 259 |
* Remove allow_html option (Instead we recommend to use the [manual excerpt](https://codex.wordpress.org/Excerpt#How_to_add_excerpts_to_posts) or we support this option furthermore in the [Term Posts Excerpt Extension](https://github.com/tiptoppress/term-posts-excerpt-extension) for the premium version) |
| 260 |
|
| 261 |
= 4.6.2 - August 28th 2016 = |
| 262 |
* Fixed only five widget instances can be costumized with shortcodes. |
| 263 |
* For editing shortcode adds a customizer link to the admin-bar if page/post is in edit mode. |
| 264 |
|
| 265 |
= 4.6.1 - June 5th 2016 = |
| 266 |
* Add shortcode [catposts] edit options only in the customizer |
| 267 |
* Keep panels open after save. |
| 268 |
* Option to hide social buttons on output. |
| 269 |
|
| 270 |
= 4.1.9 - May 5th 2016 = |
| 271 |
* Fixed undefined constant. |
| 272 |
|
| 273 |
= 4.1.8 - May 3th 2016 = |
| 274 |
* Add mouse hover effects: blur |
| 275 |
* Add option to choose allowed HTML in the excerpt |
| 276 |
* Add Jetpack 'Sharing - Show buttons on posts' support |
| 277 |
* Fixed division by zero bug (for small uploaded images) |
| 278 |
|
| 279 |
= 4.1.7 - April 14th 2016 = |
| 280 |
* Fixed division by zero bug. |
| 281 |
|
| 282 |
= 4.1.6 - April 13th 2016 = |
| 283 |
* Add option CSS cropping for thumbnails. |
| 284 |
* Add option to set mouse hover effects for post thumbnail. |
| 285 |
* Add option to change the excerpt more text. |
| 286 |
* Add option to allow links in the excerpt |
| 287 |
* Add filter 'widget_title' for the title |
| 288 |
* Add option to hide post titles. |
| 289 |
|
| 290 |
= 4.1.5 - February 4th 2016 = |
| 291 |
* Support for multi sites. |
| 292 |
* Support for localization. |
| 293 |
* Area UI. |
| 294 |
* Meet new plugin author [mark-k](https://profiles.wordpress.org/mark-k/) |
| 295 |
|
| 296 |
= 4.1.4 = |
| 297 |
* Added option exclude current post. |
| 298 |
* Added option to hide posts which have no thumbnail. |
| 299 |
* Added option to make the widget date link to the category page. |
| 300 |
* Added option to link to the category page below posts list. |
| 301 |
* Added option show post author. |
| 302 |
* Added option to format the outputted date string. |
| 303 |
|
| 304 |
= 4.1.3 = |
| 305 |
* Added option to hide widget, if category have currently no posts. |
| 306 |
|
| 307 |
= 4.1.2 = |
| 308 |
* Fixed hide title bug. |
| 309 |
|
| 310 |
= 4.1.1 = |
| 311 |
* Added option to put thumbnail on top. |
| 312 |
* Added option to show/hide the title. |
| 313 |
* Fixed no background bug. |
| 314 |
|
| 315 |
= 4.1.0 = |
| 316 |
* Added PHP5 Constructor. |
| 317 |
* Added Option to allow/disallow widget CSS. |
| 318 |
* Now, compatible with WordPress 4.3. |
| 319 |
* Meet new plugin author [kometschuh](https://profiles.wordpress.org/kometschuh) |
| 320 |
|
| 321 |
= 4.0 = |
| 322 |
* Added CSS file for post styling. |
| 323 |
* Now compatible with latest versions of WordPress. |
| 324 |
|
| 325 |
= 3.3 = |
| 326 |
* Fixed random sort bug. |
| 327 |
|
| 328 |
= 3.2 = |
| 329 |
* Added option to change ordering of posts. Defaults to showing newest posts first. |
| 330 |
|
| 331 |
= 3.1 = |
| 332 |
* Fixed a bug in the thumbnail size registration routine. |
| 333 |
|
| 334 |
= 3.0 = |
| 335 |
* Added support for WP 2.9's post thumbnail feature. |
| 336 |
* Removed support for Simple Post Thumbnails plugin. |
| 337 |
* Added option to show the post date. |
| 338 |
* Added option to set the excerpt length. |
| 339 |
* Added option to show the number of comments. |
| 340 |
|
| 341 |
= 2.3 = |
| 342 |
* Really tried to fix bug where wp_query global was getting over written by manually instantiating a WP_Query object. |
| 343 |
|
| 344 |
= 2.1 = |
| 345 |
* Fixed bug where wp_query global was getting over written. |
| 346 |
|
| 347 |
= 2.0 = |
| 348 |
* Updated to use the WP 2.8 widget API. |
| 349 |
* Added support for [Simple Post Thumbnails plugin](http://wordpress.org/extend/plugins/simple-post-thumbnails/). |
| 350 |
|
