=== OwlDraft Editorial Blocks - Post Grid, List & Hero for News and Magazine Sites ===
Contributors: owldraft
Tags: block, post grid, magazine, news, posts
Requires at least: 6.5
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

Magazine-style blocks for the WordPress editor: post grid, post list, post group, hero and authors. No settings page, no setup.

== Description ==

Magazine and news blocks for the WordPress block editor.

The plugin adds blocks and nothing else. There is no settings page, no dashboard
widget and no onboarding wizard — you add a block, set it up in the sidebar like
any core block, and you are done.

= Blocks =

* **Post Grid** — posts as a grid of cards, with a column count each for desktop,
  tablet and phone.
* **Post List** — posts as a list of rows, each with a thumbnail beside the text.
* **Post Group** — a featured cluster: one lead story with the rest of the posts
  beside it, either as a single rail or as the classic three-column homepage
  layout with the lead left, centre or right.
* **Hero** — one story, shown large, with the image above the text, beside it, or
  behind it.
* **Authors** — a grid of author cards, each with an avatar, bio and latest post.

= Choosing the posts =

Every block picks its posts the same way: by number, category, tag, author, or an
explicit list of post IDs — and each of those can be excluded as well as included.
Post Group and Hero can also take their lead story from somewhere else entirely,
such as your sticky post or the newest post in one category, and the block will
make sure that story does not then repeat further down.

= Notes =

Blocks render on the server, so a block always reflects your posts as they are
right now — editing or publishing a post updates every block that shows it, with
nothing to re-save. It is also the same code that draws the editor preview, so
what you see while editing is what the page will show.

Styling is deliberately minimal. The blocks lay themselves out but inherit fonts,
colours and heading sizes from your theme, so they look native rather than bolted
on.

= Credits =

The comment icon is "message-circle" from [Feather](https://feathericons.com/) by
Cole Bemis, used under the MIT licence.

== Installation ==

1. Upload the plugin through **Plugins → Add New → Upload Plugin**, or install it
   from the WordPress.org plugin directory.
2. Activate it.
3. In the editor, add a block and search for **Post Grid**, **Post List**,
   **Post Group**, **Hero** or **Authors**.

There is no configuration step.

== Frequently Asked Questions ==

= Does this work with any theme? =

Yes. The blocks bring the styling they need and define no colours or sizes of
their own globally, so they cannot clash with your theme. If your theme sets the
CSS variables the blocks look for, they follow it automatically.

= Does it work in the site editor? =

Yes. The blocks work anywhere the block editor does, including templates and
template parts in a block theme.

= Will it slow my site down? =

It shouldn't. There are no page builder libraries, no jQuery and no front-end
JavaScript — a block is plain HTML and a small stylesheet, and a block's
stylesheet is only sent to a page that actually uses it.

== Screenshots ==

1. Post Grid — posts as a grid of cards, with the column count and the parts of a
   card each switched on or off in the sidebar.
2. Post List — posts as a list of rows, each with its thumbnail beside the text.
3. Post Group — a lead story with the rest of the posts listed beside it.
4. Hero — one story shown large, with the image behind the text, and the posts
   narrowed to a single category.
5. Hero — the same block in its split layout, with the image beside the text.
6. Authors — a grid of author cards, each with an avatar, name and bio.

== Changelog ==

= 1.0.0 =
* Initial release.
* Five blocks: Post Grid, Post List, Post Group, Hero and Authors.
* Every block picks its posts by number, category, tag, author or an explicit
  list of post IDs, and each of those can be excluded as well as included.
* Post Group and Hero can take their lead story from somewhere else — a sticky
  post, or the newest post in one category — without it repeating further down.
* An optional comment count on a post card, off by default, hidden on a post
  that has no comments.
