This Day In History

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.