Plugin / This Day In History

Description

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 ten 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.

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_tab

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

There are eleven 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.

• 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.
• 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 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] – 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] – This shows events on 20th August in any year.