This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Recurring Timer Widget


Displays a countdown until the event begins. Specify an event duration
time and it will display a different message while the event is
happening. After the event is over, the countdown will begin again.

Uses string-to-time (strtotime) formats which can be very simple or
very complex.

The widget has many CSS classes and IDs to style it with, but it’s
been left purposely unstyled so you can format it in whatever way you
want. The included recurring-style.css and recurring-style.css-example
files show how you can move the time and labels around for a custom
look. You can customize recurring-style.css by copying it to your
active theme’s folder.

Known issues:

  • It requires a browser refresh before the “next next” event. i.e. If
    you’re viewing the widget and the timer is set for a daily event, the
    timer will countdown to today’s event, then countdown to tomorrow’s
    event. But it will not countdown to the day after tomorrow’s event
    unless the browser is refreshed.
  • Events that occur more than once in a 24-hour period have not been
    tested and may not work.


  • Widget menu in WP-Admin with an example event.
  • An un-styled version of the widget (not very pretty).
  • The widget using the example CSS file for style.


  1. Unzip and upload the plugin to your ‘wp-content/plugins’ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add the widget to your site through the ‘Widgets’ menu in WordPress
    (under ‘Appearance’).
  4. Optionally copy recurring-timer.css-example or recurring-timer.css
    to recurring-timer.css in your active theme folder to customize the
    style. You may also style the widget by customizing the stylesheet in
    your theme.


Where do I find information about the time formats?

Please note this comment on
In my screenshot example I used “fourth thursday of this month” for
the Event Day. It seems this only works in PHP 5.3+. However,
removing the ‘of’ and using “fourth thursday this month” works in
earlier versions of PHP. Your mileage may vary, so you’ll want to
experiment if your timer is displaying negative time and counting up.

Contributors & Developers

“Recurring Timer Widget” is open source software. The following people have contributed to this plugin.




  • Replaced call to time() with current_time( ‘timestamp’ ) to insure
    correct comparison to local time set in Settings -> General ->


  • Make sure monthly events do not produce ‘negative’ countdowns after
    this month’s event has occurred.
  • Added default style with option to override in the theme


  • Refactored javascript to allow widget to be placed multiple times on a
    single page


  • Fixed misspelled variable affecting next event start


  • Changed dates to use GMT – let the user’s browser determine the
  • Added readme.txt and screenshots


  • Initial release