Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!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.

Countdown Timer

This plugin allows you to setup a series of dates to count to or from in terms of years, months, weeks, days, hours, minutes, and/or seconds.

  1. Install the plugin using your preferred method of choice. Using the built-in WordPress installer is the preferred choice, but you can also do things the hard/manual way.

  2. Activate the timer.

  3. Events can be added and other settings modified in Settings > Countdown Timer in The Dashboard.

Inserting countdown timers into your blog

There are three places you can insert a countdown timer:

  1. Sidebar (using the widget)
  2. A post or page (using shortcodes)
  3. PHP (experts only)

Adding to the sidebar

Add the widget to the sidebar by going to Appearances > Widget in The Dashboard.

Adding to a post or page

If you want to insert the Countdown Timer into a page or post, you can use the following shortcodes to return all or a limited number of Countdown Timers, respectively:

[fergcorp_cdt max=##]

Where ## is maximum number of results to be displayed, ordered by date.

If you want to insert individual countdown timers, such as in posts or on pages, you can use the following shortcode:

[fergcorp_cdt_single date="ENTER_DATE_HERE"]


Time until our wedding:
[fergcorp_cdt_single date="08 December 2012"]

Where "ENTER_DATE_HERE" uses PHP's strtotime function and will parse about any English textual date/time description (such as "08 December 2012"). A complete list of valid formats can be found on PHP's Supported Date and Time Format page.


Countdown Timer also provides a PHP function designed to be accessed publicly so you can include it in elements of your site that may not be in The Loop.


Where ## is the maximum number of events you wish to be displayed. If $maxEvents is not given, the function will return all timers.

Events are automatically sorted by date of occurrence.

Note: You should also encapsulate calls with "function_exists" to prevent unintentional fatal errors if the plugin is deactivated.

Limiting the number of countdown timers displayed

If you're using the widget, there is an option to set the maximum number of timers shown. If you are using the PHP code, $maxEvents is the maximum number of events you wish to be displayed.

Events are automatically sorted by date of occurrence.

Changing the font, size, and style using CSS

You can makes changes to the appearance of Countdown Timer display using CSS.

The following CSS classes are available:

  • fergcorp_countdownTimer_event_li styles each List Item, each item encompasses one countdown event
  • fergcorp_countdownTimer_event_title styles the title of the event
  • fergcorp_countdownTimer_event_linkTitle styles the title of an event if it is linked
  • fergcorp_countdownTimer_event_time styles the actual countdown timer
  • fergcorp_countdownTimer_timeUnit styles the units (e.g. "25 days")
  • fergcorp_countdownTimer_year styles the year text
  • fergcorp_countdownTimer_month styles the month text
  • fergcorp_countdownTimer_week styles the week text
  • fergcorp_countdownTimer_day styles the day text
  • fergcorp_countdownTimer_hour styles the hour text
  • fergcorp_countdownTimer_minute styles the minute text
  • fergcorp_countdownTimer_second styles the second text

Requires: 3.7 or higher
Compatible up to: 3.9.17
Last Updated: 3 years ago
Active Installs: 7,000+


4.7 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

0,1,0 100,4,4
100,1,1 100,1,1
100,3,3 100,1,1 33,3,1 100,5,5
100,1,1 100,3,3
0,1,0 0,1,0 50,2,1
0,2,0 100,1,1