This Day In History

This is a This Day In History management plugin and widget which you can use to enter and display historic events.

Author:BrokenCrust (profile at wordpress.org)
WordPress version required:4.4
WordPress version tested:6.2
Plugin version:3.10.1
Added to WordPress repository:10-01-2012
Last updated:22-03-2023
Rating, %:90
Rated by:24
Plugin URI:
Total downloads:36 606
Active installs:1 000+
plugin download
Click to start download

This plugin allows you to enter and manage different kinds of events that you then display in via a widget or shortcodes.

Shortcodes

There are two shortcodes. [tdih] shows output as a list similar to the widget and [tdih_tab] shows output as a table.

tdih

You can add a [tdih] shortcode to any post or page to display a list of events as per the widget.

There are eleven optional attributes for this shortcode

  • show_age (0, 1) – 1 shows the age in years of the event in brackets after the title and 0 does not (default).
  • show_link (0-2) – 0 shows a more link if there is more to show (default), 1 links the title if there is more to show and 2 always links the title.
  • show_type (0, 1) – 1 shows event types (default) and 0 does not.
  • show_year (0, 1) – 1 shows the year of the event (default) and 0 does not.

  • type – enter a type to show only events of that type. Shows all types by default.

  • day (1-31) – enter a day to show only events on that day. Shows all days by default.
  • month (1-12, c) – enter a month to show only events in that month. Shows all months by default.
  • year (-9999 to 9999, 0) – enter a year to show only events in that year. Shows all years by default.
  • period (t, m, y) – show events for today, tomorrow and yesterday. Shows today’s events by default.
  • classes – enter one or more space separated classes which will be added to the table tag.
  • max_rows (1-99) – enter a maximum number of events to show. Shows all events by default.

Example use:

  • [tdih] – This shows year and event types for all event types for today’s events.
  • [tdih show_type=0 type='birth'] – This shows year and event but not type for the event type (slug) of birth.
  • [tdih year=1066 max_rows=5] – This shows year and event types for up to five events that happened on this day in 1066.

tdih_tab

You can add a [tdih_tab] shortcode to any post or page to display a table of events.

There are fourteen optional attributes for this shortcode:

  • show_date (0, 1) – 1 shows the date (default) and 0 does not.
  • show_dow (0, 1) – 1 shows the day of the week and 0 does not (default).
  • show_head (0, 1) – 1 shows a header row (default) and 0 does not.
  • show_link (0, 1, 2) – 0 shows a more link if there is more to show, 1 links the title if there is more to show and 2 always links the title.
  • show_type (0, 1) – 1 shows event types (default) and 0 does not.

  • order_dmy (0, 1) – 0 sorts chronologically by year-month-day (default) and 1 sorts by day-month-year.

  • type – enter a type to show only events of that type. Shows all types by default.
  • day (1-31) – enter a day to show only events on that day. Shows all days by default.
  • month (1-12, c) – enter a month to show only events in that month. Shows all months by default.
  • year (-9999 to 9999, 0) – enter a year to show only events in that year. Shows all years by default.
  • period (a, c, l, m, n, t, w, y) – t, m, y show events for today, tomorrow and yesterday. c, l, n, w show events for current, last, next and ISO week. a show all events. Shows today’s events by default.
  • period_days (1-99) – enter the number of days to show for t, m, y periods only. Shows only one day by default.
  • date_format – enter a custom php date format to display the date. Uses the tdih admin setting by default.
  • classes – enter one or more space separated classes which will be added to the table tag.

NB:

  • day of the week will never be shown if the date is not shown.
  • Setting date_format will override the tdih admin format and the day of the week setting.
  • Setting period will override any values for day, month and year.
  • day, month and year can be combined.
  • year=0 will display events with no year
  • month=c will display the current month
  • period=c, l or n show a seven day period with the current day as the middle, last or first day.

Example use:

  • [tdih_tab period='a'] – This shows a full list of events in date order and includes the event type.
  • [tdih_tab show_types=0 type='birth' classes='content dark'] – This shows events but not type for the event type (slug) of birth. ” content dark” will be added to the table’s class.
  • [tdih_tab day=20 month=8 date_format='Y'] – This shows events on 20th August in any year. Format the date to only show the four digit year.