Herodotus

Pro

Herodotus Pro / Documentation

Examples & Combinations

Detailed Attribute Reference

layout

Controls the visual appearance of the events list.

list (default):

  • Full-width cards
  • Side image, 120 x 150 px on desktop before custom image settings
  • Full excerpt
  • Category label
  • "Read more" link
  • Best for: main content areas, full pages
[herodotus layout="list"]

compact:

  • Small 50 x 65 px thumbnail beside the text
  • Short title and excerpt
  • No category label
  • No "Read more" button
  • Best for: sidebars, widget areas, narrow columns
[herodotus layout="compact"]

limit

Restricts the number of events displayed.

[herodotus limit="3"]

If there are 10 events for today and you set limit="3", only the first 3 (after sorting) will be shown.

category

Filters events by a specific Herodotus category. Use the category slug (not the name).

[herodotus category="science"]

To find the slug: go to Herodotus - On This Day → Categories and look at the "Slug" column.

excerpt_words

Controls how many words appear in the event excerpt.

[herodotus excerpt_words="20"]

This overrides the global setting for this specific shortcode instance.

show_image

When set to false, hides all images (including the default placeholder). Events display only title, excerpt and Read more.

[herodotus show_image="false"]

order

Overrides the global sort order for this shortcode instance.

[herodotus order="DESC"]

Events are grouped by calendar date. Within each date, ASC puts earlier historical years first and DESC puts later years first. Titles break ties in the same direction. With Pro, Priority Events come first within their date.

Combining Attributes

Combine supported attributes for the same listing. Pro attributes require active Pro:

[herodotus layout="compact" category="politics" limit="5" excerpt_words="10" show_image="false"]

Text and Random Examples

[herodotus layout="text" limit="5"]
[herodotus_random layout="compact" limit="1"]

Pro Layout Examples

[herodotus layout="grid-4" show_image="false"]
[herodotus layout="carousel-1" image_shape="16:9" excerpt_words="25"]
[herodotus layout="timeline" excerpt_words="30"]

Pro Dates and Filters

[herodotus date="07-20" category="science,history"]
[herodotus upcoming="7" exclude_category="private-events"]
[herodotus tag="space,astronomy" layout="grid-3"]

Future days in an upcoming range require the event's Upcoming Event flag. Grid date headings start a new group, so three events on one date leave the fourth slot empty in grid-4. See All Attributes and Layouts.