Timeline Express – Date – Time Add-On

Description

When active, the Timeline Express – Date – Time Add-On will hide the default announcement date field, and generate a date and time field for you to use.

Multiple announcements that have the same date & time will fallback to use the published date to dictate order on the timeline.

Developers

Filters:
timeline_express_date_time_formats – Add your own date formats to the announcement.

Example:

/**
 * Assign a custom date format to the announcements.
 *
 * @param array $date_formats The original date formats array.
 */
function timeline_express_demo_custom_date_format( $date_formats ) {

    $date_formats['custom'] = 'Y-m-d'; // eg: 2018-10-02

}
add_filter( 'timeline_express_date_time_formats', 'timeline_express_demo_custom_date_format' );

timeline_express_date_time_query_args – Filter the query run for the date time add-on.

Example:

/**
 * Filter the announcement date time add-on query.
 * Fall back to post titles instead of published date when announcements contain the same date-time values.
 *
 * @param array $query_args The original date time add-on query arguments.
 */
function timeline_express_demo_filter_query_args( $query_args ) {

    unset( $query_args['orderby'] );

    $query_args['orderby'] = 'meta_value_num title';

    return $query_args;

}
add_filter( 'timeline_express_date_time_query_args', 'timeline_express_demo_filter_query_args' );

Screenshots

  • Announcement Date & Time Selector
  • Front End Date & Time on the Timeline

Installation

  1. Upload the entire timeline-express-date-time-add-on folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. If you previously had announcements setup, follow the migration steps.
  4. Create a new announcement set a date & time and set the date format for each announcement.

FAQ

What if multiple announcements have the same dates?

If multiple announcements use the same date and time, then the announcement ‘published’ date will be used to dictate the order. The published date can be adjusted just above the ‘Publish’ button in the right hand sidebar on the announcement creation/edit screen in the dashboard.

Can I set the display format? I don’t want to display the time on some announcements.

Yes! For each announcement you have the ability to choose how the dates are displayed. Out of the box you can display the dates in the following formats:

  • Full Date (ie: 02/10/2018 1:00 PM)
  • Year Only (ie: 2018)
  • Date Only (ie: 02/10/2018)
  • Time Only (ie: 1:00 PM)

Reviews

මැයි 11, 2021
Does not work at all, no date picker shows up, in fact, you have to deactivate this plugin to get the default announcement date dialog to show up! The help documentation for this is lacking more explanation, do I add this code to my functions.php?
අප්‍රේල් 21, 2018
Great add-on to Timeline Express base plugin. Worked as advertised. I've used it to create a timeline of events for an upcoming conference with talks at certain times on the same day. Worked well - thanks.
මාර්තු 23, 2018 2 replies
The promised date format picker doesn't show up. There's a line there, but nothing to choose from.
Read all 3 reviews

Contributors & Developers

“Timeline Express – Date – Time Add-On” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.1 – February 26th, 2018

  • Tweak: Ensure plugin works with Timeline Express free/pro.
  • Tweak: Allow translation files to be loaded from theme root (see i18n/how-to.txt).
  • Tweak: Hide migration notice when plugin is activated without Timeline Express free/pro.
  • Tweak: Update admin notice styles on activation.

1.0.0 – February 11th, 2018

  • Initial release.