=== Postrix - Recent Posts Widget ===
Contributors: sandya0110
Tags: recent posts, widget, gutenberg, shortcode, post list
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display recent posts filtered by post type, category, tag, or author — as a classic widget, Gutenberg block, or shortcode.

== Description ==

Postrix lets you display a filtered list of recent posts anywhere on your site: in a sidebar widget, as a Gutenberg block, or via shortcode.

**Filters**

* Post Type — posts, pages, or any public custom post type
* Category — include or exclude by category ID
* Tag — include or exclude by tag ID
* Author — include or exclude by author ID
* Order by date, random, or menu order

**Display options**

* Number of posts and offset
* Show/hide thumbnail, date, author, excerpt
* Prioritize sticky posts
* Automatically exclude the current post when viewing it

**Three ways to use it**

* Classic widget (Appearance > Widgets)
* Gutenberg block ("Postrix - Recent Posts Widget" in the block inserter, under Widgets)
* Shortcode: `[postrix_recent_posts number="5" post_type="post" categories="3,12"]`

== Installation ==

1. Upload the `recent-posts-widget-boost` folder to the `/wp-content/plugins/` directory, or install the plugin directly through the WordPress plugin screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Add the "Postrix - Recent Posts Widget" widget from Appearance > Widgets, insert the "Postrix - Recent Posts Widget" block in the block editor, or add the `[postrix_recent_posts]` shortcode to a post or page.

== Frequently Asked Questions ==

= Can I use this with a custom post type? =

Yes. Any public post type registered on your site is available in the Post Type dropdown/field.

= How do I find category, tag, or author IDs? =

Hover over the category/tag/author link in your WordPress admin list screens — the ID appears in the URL (e.g. `tag_ID=12` or `cat=3`).

= Does the shortcode support all the same options as the widget? =

Yes. All settings are available as shortcode attributes, e.g.:
`[postrix_recent_posts number="3" show_excerpt="true" categories="4" orderby="rand"]`

== Screenshots ==

1. Widget settings panel showing post type, category, tag, and author filters

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
