Displays a countdown timer in a widget for a recurring event.
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 Instructions
- Unzip and upload the plugin to your ‘wp-content/plugins’ directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Add the widget to your site through the ‘Widgets’ menu in WordPress (under ‘Appearance’).
- 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?
Please note this comment on php.net: 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.
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
