Gutenberg Block¶
Herodotus includes a native Gutenberg block for the block editor.
Adding the Block¶
- Open any page or post in the block editor.
- Click the + button (block inserter).
- Search for "Herodotus" or "On This Day".
- Click Herodotus Events to insert the block.
Block Settings¶
In the block sidebar (right panel), you can configure:
| Setting | Options | Description |
|---|---|---|
| Layout | List / Compact | Visual layout |
| Limit | Number input | Max events to display |
| Category | Dropdown or text | Filter by category slug |
| Excerpt Words | Number input | Words per excerpt |
| Show Images | Toggle | Show or hide featured images |
| Sort Order | ASC / DESC | Alphabetical sorting direction |
Editor Preview¶
The block shows a preview in the editor so you can see approximately how it will look on the frontend.
Note: The preview in the editor may not show today's actual events — it serves as a layout preview.
When to Use Block vs Shortcode¶
| Use Case | Recommendation |
|---|---|
| Block editor pages | ✅ Use the Gutenberg block |
| Classic editor | Use the [herodotus] shortcode |
| Text widgets | Use the [herodotus] shortcode |
| Page builders | Use the [herodotus] shortcode |
| Programmatic insertion | Use do_shortcode('[herodotus]') |