Title: Recurring Timer Widget
Author: jrfoell
Published: <strong>20 kwiytnia 2011</strong>
Last modified: 26 mŏja 2017

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/recurring-timer-widget.svg)

# Recurring Timer Widget

 By [jrfoell](https://profiles.wordpress.org/jrfoell/)

[Download](https://downloads.wordpress.org/plugin/recurring-timer-widget.1.7.zip)

 * [Details](https://szl.wordpress.org/plugins/recurring-timer-widget/#description)
 * [Reviews](https://szl.wordpress.org/plugins/recurring-timer-widget/#reviews)
 *  [Installation](https://szl.wordpress.org/plugins/recurring-timer-widget/#installation)
 * [Development](https://szl.wordpress.org/plugins/recurring-timer-widget/#developers)

 [Support](https://wordpress.org/support/plugin/recurring-timer-widget/)

## Description

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 to style it with, but it’s been left purposely unstyled
so you can format it in whatever way you want. The included recurring-timer-widget.
css and recurring-timer-widget.css-example files show how you can move the time 
and labels around for a custom look. You can customize recurring-timer-widget.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.

## Screenshots

 * [[
 * 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.

## Installation

 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-widget.css-example or recurring-timer-widget.css
    to recurring-timer-widget.css in your active theme folder to customize the style.
    You may also style the widget by customizing the stylesheet in your theme.

## FAQ

  Installation Instructions

 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-widget.css-example or recurring-timer-widget.css
    to recurring-timer-widget.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?

 * [http://php.net/strtotime](http://php.net/strtotime)
 * [http://www.php.net/manual/en/datetime.formats.relative.php](http://www.php.net/manual/en/datetime.formats.relative.php)
 * [http://www.gnu.org/software/tar/manual/html_node/Date-input-formats.html](http://www.gnu.org/software/tar/manual/html_node/Date-input-formats.html)

Please note this comment on php.net: [http://us.php.net/manual/en/datetime.formats.relative.php#98989](http://us.php.net/manual/en/datetime.formats.relative.php#98989)
In my screenshot example I used „fourth thursday of this month” for the Event Day.
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/or counting up.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

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

Contributors

 *   [ jrfoell ](https://profiles.wordpress.org/jrfoell/)

[Translate “Recurring Timer Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/recurring-timer-widget)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/recurring-timer-widget/),
check out the [SVN repository](https://plugins.svn.wordpress.org/recurring-timer-widget/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/recurring-timer-widget/)
by [RSS](https://plugins.trac.wordpress.org/log/recurring-timer-widget/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.7

 * Added more CSS classes for easier targeting/styling.

#### 1.6

 * Renamed files to support translations via [http://translate.wordpress.org]
 * Fixed issue with monthly events showing up as today when they shouldn’t.

#### 1.5

 * Replaced call to time() with current_time( ‚timestamp’ ) to insure correct comparison
   to local time set in Settings -> General -> Timezone.

#### 1.4

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

#### 1.3

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

#### 1.2

 * Fixed misspelled variable affecting next event start.

#### 1.1

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

#### 1.0

 * Initial release.

## Meta

 *  Version **1.7**
 *  Last updated **9 lŏt ago**
 *  Active installations **10+**
 *  WordPress version ** 4.6 or higher **
 *  Tested up to **4.7.33**
 *  Language
 * [English (US)](https://wordpress.org/plugins/recurring-timer-widget/)
 * Tags
 * [Event](https://szl.wordpress.org/plugins/tags/event/)[recurring](https://szl.wordpress.org/plugins/tags/recurring/)
   [timer](https://szl.wordpress.org/plugins/tags/timer/)[widget](https://szl.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://szl.wordpress.org/plugins/recurring-timer-widget/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/recurring-timer-widget/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/recurring-timer-widget/reviews/)

## Contributors

 *   [ jrfoell ](https://profiles.wordpress.org/jrfoell/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/recurring-timer-widget/)