=== ProWoos Posts Grid ===
Contributors: rafael.minuesa
Tags: posts grid, blog grid, shortcode, responsive grid, post cards
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight shortcode plugin that displays WordPress posts in a responsive card grid with featured images, titles, excerpts, and dates.

== Description ==

ProWoos Posts Grid provides a simple `[prowoos_posts_grid]` shortcode that outputs a responsive card-style post grid. It works with any theme and page builder, including Elementor Free.

Drop the shortcode into any page, post, or widget area to display a grid of your latest blog posts — no premium page builder widgets needed.

== Usage ==

= Basic =

    [prowoos_posts_grid]

Displays 6 posts in a 3-column grid (2 on tablet, 1 on mobile).

= With Options =

    [prowoos_posts_grid posts="9" columns="3" category="blog" excerpt_length="15"]

= All Available Attributes =

| Attribute        | Default        | Values                          | Description                          |
|------------------|----------------|---------------------------------|--------------------------------------|
| posts            | 6              | Any number                      | Number of posts to display           |
| columns          | 3              | 1–4                             | Desktop columns                      |
| columns_tablet   | 2              | 1–3                             | Tablet columns (mobile is always 1)  |
| category         | (all)          | Any category slug               | Filter by category slug              |
| excerpt_length   | 20             | Any number                      | Number of words in excerpt           |
| orderby          | date           | date, title, rand, modified     | Sort field                           |
| order            | DESC           | ASC, DESC                       | Sort direction                       |
| offset           | 0              | Any number                      | Skip this many posts                 |
| show_date        | yes            | yes, no                         | Show or hide post date               |
| show_excerpt     | yes            | yes, no                         | Show or hide excerpt                 |
| show_readmore    | yes            | yes, no                         | Show or hide "Read More" link        |
| readmore_text    | Read More →    | Any text/HTML                   | Custom read more link text           |

= Using with Elementor =

1. Add an **HTML** or **Shortcode** widget to your page.
2. Paste the shortcode.
3. Save and preview.

= Examples =

Show 4 posts in 2 columns, no excerpt:

    [prowoos_posts_grid posts="4" columns="2" show_excerpt="no"]

Show posts from "tutorials" category, sorted by title:

    [prowoos_posts_grid category="tutorials" orderby="title" order="ASC"]

Show 12 posts in 4 columns with short excerpts:

    [prowoos_posts_grid posts="12" columns="4" excerpt_length="10"]

== Changelog ==

= 1.0.0 =
* Initial release.