Easy Timer is a free WordPress plugin allowing you to easily insert into posts, pages and widgets of your website an unlimited number of count down/up timers that refresh every second, and the time or date. Each countdown timer shows the time remaining until the date you choose, and, if you want, reveals a hidden content when this date is reached. Each countup timer shows the time elapsed since the date you choose or the time spent by the Internet user on the webpage.
Easy Timer also allows you to schedule an automatic content modification.
To display a countdown timer, insert into your posts/pages/widgets a code like this:
[countdown date=YYYY/MM/DD-hh:mm:ss]
Just [timer] until this film comes out in cinemas!
[/countdown]
YYYY = year
MM = month (from 1 to 12)
DD = day number of the month (from 1 to 31)
hh = hours
mm = minutes
ss = seconds
In some cases, you can specify the date differently:
YYYY/MM/DD is equivalent to YYYY/MM/DD-00:00:00YYYY/MM/DD-hh is equivalent to YYYY/MM/DD-hh:00:00YYYY/MM/DD-hh:mm is equivalent to YYYY/MM/DD-hh:mm:00The date shall be indicated according to the time zone of your website. Set correctly your time zone via the WordPress Administration Panel if you have not done. You may occasionally specify an offset to UTC time different from your time zone using the offset attribute:
[countdown date=YYYY/MM/DD-hh:mm:ss offset=x]
Just [timer] until this film comes out in cinemas!
[/countdown]
The offset attribute is the offset (in hours) to UTC time. You can specify any relative number for this attribute. In some countries, the offset to UTC time is not constant. It may distort the calculation of the remaining time. To solve this problem, you can use the offset attribute (offset=x for each date during winter time and offset=x+1 for each date during summer time, replace x with the right numeric value).
The countdown timer shows the same remaining time everywhere in the world. When the date is reached, the content between [countdown date=YYYY/MM/DD-hh:mm:ss] and [/countdown] disappears. You can format this content as any content of your website.
You can insert the [timer] shortcode as many times as you want between [countdown date=YYYY/MM/DD-hh:mm:ss] and [/countdown]. If you don't insert it, Easy Timer allows you to schedule a content disappearance without displaying a countdown timer:
[countdown date=YYYY/MM/DD-hh:mm:ss]
When this film will come out in cinemas, this sentence will disappear!
[/countdown]
You can specify a PHP function that will be applied to the content before this one is displayed, using the filter attribute, like this:
[countdown date=YYYY/MM/DD-hh:mm:ss filter=function]Content[/countdown]
Replace function by the name of the function you want to apply.
It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:
[countdown date=YYYY/MM/DD-hh:mm:ss filter=function1/function2/.../functionN]Content[/countdown]
The functions will be applied in the specified order.
You are not limited to the [timer] shortcode. You can use the following shortcodes:
[timer] to display the remaining time[dhmstimer] to display the remaining time in days, hours, minutes and seconds[dhmtimer] to display the remaining time in days, hours and minutes[dhtimer] to display the remaining time in days and hours[dtimer] to display the remaining time in days[hmstimer] to display the remaining time in hours, minutes and seconds[hmtimer] to display the remaining time in hours and minutes[htimer] to display the remaining time in hours[mstimer] to display the remaining time in minutes and seconds[mtimer] to display the remaining time in minutes[stimer] to display the remaining time in seconds[hmsrtimer] to display only the hours, minutes and seconds of the remaining time in days, hours, minutes and seconds[hmrtimer] to display only the hours and minutes of the remaining time in days, hours, minutes and seconds[hrtimer] to display only the hours of the remaining time in days, hours, minutes and seconds[msrtimer] to display only the minutes and seconds of the remaining time in days, hours, minutes and seconds[mrtimer] to display only the minutes of the remaining time in days, hours, minutes and seconds[srtimer] to display only the seconds of the remaining time in days, hours, minutes and secondsAll countdown timers will display:
If you want to schedule a content substitution, insert into your posts/pages/widgets a code like this:
[countdown date=2013/01/01]
Just [timer] until 2013!
[after]Happy New Year 2013![/countdown]
Result (with a little formatting, time zone = UTC):
Just 226 days 16 hours 17 minutes 31 seconds until 2013!
Insert the content you want to substitute between [after] and [/countdown]. When the date is reached, the content between [countdown date=YYYY/MM/DD-hh:mm:ss] and [after] disappears, and the content between [after] and [/countdown] appears. The content between [after] and [/countdown] is never sent to the browser before this date.
You can insert the [timer] shortcode as many times as you want between [countdown date=YYYY/MM/DD-hh:mm:ss] and [after]. If you don't insert it, Easy Timer allows you to schedule a content substitution without displaying a countdown timer:
[countdown date=2013/01/01]
We will be soon in 2013!
[after]Happy New Year 2013![/countdown]
Result (with a little formatting, time zone = UTC):
We will be soon in 2013!
It is possible to specify several dates for the date attribute, by separating the different dates by //, like this:
[countdown date=2012/12/25//2013/01/01]
Just [timer] until Christmas![after]
Just [timer] until 2013![after]
Happy New Year 2013![/countdown]
Result (with a little formatting, time zone = UTC):
Just 219 days 16 hours 17 minutes 31 seconds until Christmas!
You can use the following shortcodes:
[total-timer] to display the remaining time until the last date of the date attribute[total-dhmstimer] to display the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-dhmtimer] to display the remaining time until the last date of the date attribute in days, hours and minutes[total-dhtimer] to display the remaining time until the last date of the date attribute in days and hours[total-dtimer] to display the remaining time until the last date of the date attribute in days[total-hmstimer] to display the remaining time until the last date of the date attribute in hours, minutes and seconds[total-hmtimer] to display the remaining time until the last date of the date attribute in hours and minutes[total-htimer] to display the remaining time until the last date of the date attribute in hours[total-mstimer] to display the remaining time until the last date of the date attribute in minutes and seconds[total-mtimer] to display the remaining time until the last date of the date attribute in minutes[total-stimer] to display the remaining time until the last date of the date attribute in seconds[total-hmsrtimer] to display only the hours, minutes and seconds of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-hmrtimer] to display only the hours and minutes of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-hrtimer] to display only the hours of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-msrtimer] to display only the minutes and seconds of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-mrtimer] to display only the minutes of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-srtimer] to display only the seconds of the remaining time until the last date of the date attribute in days, hours, minutes and secondsAnother example:
[countdown date=2012/01/01//2013/01/01//2014/01/01//2015/01/01//2016/01/01]
Just [timer] until 2012 and [total-timer] until 2016![after]
Just [timer] until 2013 and [total-timer] until 2016![after]
Just [timer] until 2014 and [total-timer] until 2016![after]
Just [timer] until 2015 and [total-timer] until 2016![after]
Just [timer] until 2016![after]Happy New Year 2016![/countdown]
Result (with a little formatting, time zone = UTC):
Just 226 days 16 hours 17 minutes 31 seconds until 2013 and 1321 days 16 hours 17 minutes 31 seconds until 2016!
You can display a periodic countdown timer, like this:
[countdown date=YYYY/MM/DD-hh:mm:ss period=d:h:m:s]
Just [timer] ![/countdown]
d = number of days
h = number of hours
m = number of minutes
s = number of seconds
In some cases, you can specify the period differently:
d is equivalent to d:0:0:0d:h is equivalent to d:h:0:0d:h:m is equivalent to d:h:m:0The countdown timer repeats with a period equal to the duration specified for the period attribute.
Example (counter repeating every day):
[countdown date=2009/09/23 period=1]
Just [timer] before tomorrow ![/countdown]
Result (with a little formatting, time zone = UTC):
Just 16 hours 17 minutes 31 seconds before tomorrow !
Another example (counter repeating every week):
[countdown date=2011/09/04//2011/09/07 period=7]
Just [timer] before Sunday ![after]
Just [timer] before Wednesday ![/countdown]
Result (with a little formatting, time zone = UTC):
Just 16 hours 17 minutes 31 seconds before Sunday !
It is possible to specify a relative date for the date attribute, like this:
[countdown date=+d:h:m:s]
Just [timer]![after]Countdown ended!
[/countdown]
d = number of days
h = number of hours
m = number of minutes
s = number of seconds
In some cases, you can specify the duration differently:
+d is equivalent to +d:0:0:0+d:h is equivalent to +d:h:0:0+d:h:m is equivalent to +d:h:m:0The date is then the date of the first display of the content by the Internet user, increased by the specified duration.
Example:
[countdown date=+0:0:2]
Just [timer]![after]Countdown ended!
[/countdown]
Result (with a little formatting):
Just 2 minutes 0 second!
With the origin attribute, you can use the date of the last display of the content by the Internet user, instead of the date of the first display.
Example:
[countdown date=+0:18 origin=last-visit]
Just [timer]![/countdown]
Result (with a little formatting):
Just 18 hours 0 second!
To display a countup timer, insert into your posts/pages/widgets a code like this:
[countup date=YYYY/MM/DD-hh:mm:ss]
For [timer], this film is released in cinemas!
[/countup]
YYYY = year
MM = month (from 1 to 12)
DD = day number of the month (from 1 to 31)
hh = hours
mm = minutes
ss = seconds
In some cases, you can specify the date differently:
YYYY/MM/DD is equivalent to YYYY/MM/DD-00:00:00YYYY/MM/DD-hh is equivalent to YYYY/MM/DD-hh:00:00YYYY/MM/DD-hh:mm is equivalent to YYYY/MM/DD-hh:mm:00The date shall be indicated according to the time zone of your website. Set correctly your time zone via the WordPress Administration Panel if you have not done. You may occasionally specify an offset to UTC time different from your time zone using the offset attribute:
[countup date=YYYY/MM/DD-hh:mm:ss offset=x]
For [timer], this film is released in cinemas!
[/countup]
The offset attribute is the offset (in hours) to UTC time. You can specify any relative number for this attribute. In some countries, the offset to UTC time is not constant. It may distort the calculation of the elapsed time. To solve this problem, you can use the offset attribute (offset=x for each date during winter time and offset=x+1 for each date during summer time, replace x with the right numeric value).
The countup timer shows the same elapsed time everywhere in the world. If the date is not yet reached, the content between [countup date=YYYY/MM/DD-hh:mm:ss] and [/countup] doesn't appear. You can format this content as any content of your website.
You can insert the [timer] shortcode as many times as you want between [countup date=YYYY/MM/DD-hh:mm:ss] and [/countup]. If you don't insert it, Easy Timer allows you to schedule a content appearance without displaying a countup timer:
[countup date=YYYY/MM/DD-hh:mm:ss]
When this film will come out in cinemas, this sentence will appear!
[/countup]
You can specify a PHP function that will be applied to the content before this one is displayed, using the filter attribute, like this:
[countup date=YYYY/MM/DD-hh:mm:ss filter=function]Content[/countup]
Replace function by the name of the function you want to apply.
It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:
[countup date=YYYY/MM/DD-hh:mm:ss filter=function1/function2/.../functionN]Content[/countup]
The functions will be applied in the specified order.
You are not limited to the [timer] shortcode. You can use the following shortcodes:
[timer] to display the elapsed time[dhmstimer] to display the elapsed time in days, hours, minutes and seconds[dhmtimer] to display the elapsed time in days, hours and minutes[dhtimer] to display the elapsed time in days and hours[dtimer] to display the elapsed time in days[hmstimer] to display the elapsed time in hours, minutes and seconds[hmtimer] to display the elapsed time in hours and minutes[htimer] to display the elapsed time in hours[mstimer] to display the elapsed time in minutes and seconds[mtimer] to display the elapsed time in minutes[stimer] to display the elapsed time in seconds[hmsrtimer] to display only the hours, minutes and seconds of the elapsed time in days, hours, minutes and seconds[hmrtimer] to display only the hours and minutes of the elapsed time in days, hours, minutes and seconds[hrtimer] to display only the hours of the elapsed time in days, hours, minutes and seconds[msrtimer] to display only the minutes and seconds of the elapsed time in days, hours, minutes and seconds[mrtimer] to display only the minutes of the elapsed time in days, hours, minutes and seconds[srtimer] to display only the seconds of the elapsed time in days, hours, minutes and secondsAll countup timers will display:
If you want to schedule a content substitution, insert into your posts/pages/widgets a code like this:
[countup date=2013/01/01]
For [timer], we are in 2013!
[before]We will be soon in 2013![/countup]
Result (with a little formatting, time zone = UTC):
For 139 days 7 hours 42 minutes 29 seconds, we are in 2012!
Insert the content you want to substitute between [countup date=YYYY/MM/DD-hh:mm:ss] and [before]. When the date is reached, the content between [countup date=YYYY/MM/DD-hh:mm:ss] and [before] appears, and the content between [before] and [/countup] disappears. The content between [before] and [/countup] is never sent to the browser after this date.
You can insert the [timer] shortcode as many times as you want between [countup date=YYYY/MM/DD-hh:mm:ss] and [before]. If you don't insert it, Easy Timer allows you to schedule a content substitution without displaying a countup timer:
[countup date=2013/01/01]
Happy New Year 2013![before]
We will be soon in 2013![/countup]
Result (with a little formatting, time zone = UTC):
We will be soon in 2013!
It is possible to specify several dates for the date attribute, by separating the different dates by //, like this:
[countup date=2012/01/01//2011/12/25]
For [timer], we are in 2012![before]
For [timer], Christmas has arrived![before]
Christmas will come soon![/countup]
Result (with a little formatting, time zone = UTC):
For 139 days 7 hours 42 minutes 29 seconds, we are in 2012!
You can use the following shortcodes:
[total-timer] to display the elapsed time since the last date of the date attribute[total-dhmstimer] to display the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-dhmtimer] to display the elapsed time since the last date of the date attribute in days, hours and minutes[total-dhtimer] to display the elapsed time since the last date of the date attribute in days and hours[total-dtimer] to display the elapsed time since the last date of the date attribute in days[total-hmstimer] to display the elapsed time since the last date of the date attribute in hours, minutes and seconds[total-hmtimer] to display the elapsed time since the last date of the date attribute in hours and minutes[total-htimer] to display the elapsed time since the last date of the date attribute in hours[total-mstimer] to display the elapsed time since the last date of the date attribute in minutes and seconds[total-mtimer] to display the elapsed time since the last date of the date attribute in minutes[total-stimer] to display the elapsed time since the last date of the date attribute in seconds[total-hmsrtimer] to display only the hours, minutes and seconds of the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-hmrtimer] to display only the hours and minutes of the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-hrtimer] to display only the hours of the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-msrtimer] to display only the minutes and seconds of the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-mrtimer] to display only the minutes of the elapsed time since the last date of the date attribute in days, hours, minutes and seconds[total-srtimer] to display only the seconds of the elapsed time since the last date of the date attribute in days, hours, minutes and secondsAnother example:
[countup date=2015/01/01//2014/01/01//2013/01/01//2012/01/01//2011/01/01]
For [timer], we are in 2015 and for [total-timer], 2011 has arrived![before]
For [timer], we are in 2014 and for [total-timer], 2011 has arrived![before]
For [timer], we are in 2013 and for [total-timer], 2011 has arrived![before]
For [timer], we are in 2012 and for [total-timer], 2011 has arrived![before]
For [timer], we are in 2011![before]We will be soon in 2011![/countup]
Result (with a little formatting, time zone = UTC):
For 139 days 7 hours 42 minutes 29 seconds, we are in 2012 and for 504 days 7 hours 42 minutes 29 seconds, 2011 has arrived!
To display a chronometer, insert into your posts/pages/widgets a code like this:
[countup]You have spent [timer] on this webpage.[/countup]
Result:
You have spent 0 second on this webpage.
To display a chronometer that begins from n seconds (n must be a positive integer), insert into your posts/pages/widgets a code like this:
[countup date=n]Total time: [timer][/countup]
Result (with n=55):
Total time: 55 seconds
To display a chronometer that begins from m minutes and n seconds (m and n must be positive integers), insert into your posts/pages/widgets a code like this:
[countup date=m:n]Total time: [timer][/countup]
Result (with m=5 and n=8):
Total time: 5 minutes 8 seconds
It is possible to specify a relative date for the date attribute, like this:
[countup date=-d:h:m:s]Total time: [timer][/countup]
d = number of days
h = number of hours
m = number of minutes
s = number of seconds
In some cases, you can specify the duration differently:
-d is equivalent to -d:0:0:0-d:h is equivalent to -d:h:0:0-d:h:m is equivalent to -d:h:m:0The date is then the date of the first display of the content by the Internet user, decreased by the specified duration.
Example:
[countup date=-0]
Elapsed time since your first display of this page: [timer]
[/countup]
Result (with a little formatting):
Elapsed time since your first display of this page: 0 second
With the origin attribute, you can use the date of the last display of the content by the Internet user, instead of the date of the first display.
Example:
[countup date=-0 origin=last-visit]
Elapsed time since your last display of this page: [timer]
[/countup]
Result (with a little formatting):
Elapsed time since your last display of this page: 0 second
To display countup and countdown timers, insert into your posts/pages/widgets a code like this:
[counter date=YYY/MM/DD-hh:mm:ss]
Just [remaining-timer] until this film comes out in cinemas!
[after]For [elapsed-timer], this film is released in cinemas![/counter]
YYYY = year
MM = month (from 1 to 12)
DD = day number of the month (from 1 to 31)
hh = hours
mm = minutes
ss = seconds
In some cases, you can specify the date differently:
YYYY/MM/DD is equivalent to YYYY/MM/DD-00:00:00YYYY/MM/DD-hh is equivalent to YYYY/MM/DD-hh:00:00YYYY/MM/DD-hh:mm is equivalent to YYYY/MM/DD-hh:mm:00The date shall be indicated according to the time zone of your website. Set correctly your time zone via the WordPress Administration Panel if you have not done. You may occasionally specify an offset to UTC time different from your time zone using the offset attribute:
[counter date=YYYY/MM/DD-hh:mm:ss offset=x]
Just [remaining-timer] until this film comes out in cinemas!
[after]For [elapsed-timer], this film is released in cinemas![/counter]
The offset attribute is the offset (in hours) to UTC time. You can specify any relative number for this attribute. In some countries, the offset to UTC time is not constant. It may distort the calculation of the elapsed and remaining time. To solve this problem, you can use the offset attribute (offset=x for each date during winter time and offset=x+1 for each date during summer time, replace x with the right numeric value).
The counter shows the same elapsed and remaining time everywhere in the world. When the date is reached, the content between [counter date=YYYY/MM/DD-hh:mm:ss] and [after] disappears, and the content between [after] and [/counter] appears. The content between [after] and [/counter] is never sent to the browser before this date.
You can insert the [elapsed-timer] and [remaining-timer] shortcodes as many times as you want between [counter date=YYYY/MM/DD-hh:mm:ss] and [/counter]. If you don't insert it, Easy Timer allows you to schedule a content disappearance without displaying a counter:
[counter date=2013/01/01]
We will be soon in 2013!
[after]Happy New Year 2013![/counter]
Result (with a little formatting, time zone = UTC):
We will be soon in 2013!
You can specify a PHP function that will be applied to the content before this one is displayed, using the filter attribute, like this:
[counter date=YYYY/MM/DD-hh:mm:ss filter=function]
Content 1[after]Content 2[/counter]
Replace function by the name of the function you want to apply.
It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:
[counter date=YYYY/MM/DD-hh:mm:ss filter=function1/function2/.../functionN]
Content 1[after]Content 2[/counter]
The functions will be applied in the specified order.
You are not limited to the [elapsed-timer] and [remaining-timer] shortcodes. You can use the following shortcodes:
[timer] to display the elapsed time[dhmstimer] to display the elapsed time in days, hours, minutes and seconds[dhmtimer] to display the elapsed time in days, hours and minutes[dhtimer] to display the elapsed time in days and hours[dtimer] to display the elapsed time in days[hmstimer] to display the elapsed time in hours, minutes and seconds[hmtimer] to display the elapsed time in hours and minutes[htimer] to display the elapsed time in hours[mstimer] to display the elapsed time in minutes and seconds[mtimer] to display the elapsed time in minutes[stimer] to display the elapsed time in seconds[hmsrtimer] to display only the hours, minutes and seconds of the elapsed time in days, hours, minutes and seconds[hmrtimer] to display only the hours and minutes of the elapsed time in days, hours, minutes and seconds[hrtimer] to display only the hours of the elapsed time in days, hours, minutes and seconds[msrtimer] to display only the minutes and seconds of the elapsed time in days, hours, minutes and seconds[mrtimer] to display only the minutes of the elapsed time in days, hours, minutes and seconds[srtimer] to display only the seconds of the elapsed time in days, hours, minutes and seconds[elapsed-timer] to display the elapsed time[elapsed-dhmstimer] to display the elapsed time in days, hours, minutes and seconds[elapsed-dhmtimer] to display the elapsed time in days, hours and minutes[elapsed-dhtimer] to display the elapsed time in days and hours[elapsed-dtimer] to display the elapsed time in days[elapsed-hmstimer] to display the elapsed time in hours, minutes and seconds[elapsed-hmtimer] to display the elapsed time in hours and minutes[elapsed-htimer] to display the elapsed time in hours[elapsed-mstimer] to display the elapsed time in minutes and seconds[elapsed-mtimer] to display the elapsed time in minutes[elapsed-stimer] to display the elapsed time in seconds[elapsed-hmsrtimer] to display only the hours, minutes and seconds of the elapsed time in days, hours, minutes and seconds[elapsed-hmrtimer] to display only the hours and minutes of the elapsed time in days, hours, minutes and seconds[elapsed-hrtimer] to display only the hours of the elapsed time in days, hours, minutes and seconds[elapsed-msrtimer] to display only the minutes and seconds of the elapsed time in days, hours, minutes and seconds[elapsed-mrtimer] to display only the minutes of the elapsed time in days, hours, minutes and seconds[elapsed-srtimer] to display only the seconds of the elapsed time in days, hours, minutes and seconds[remaining-timer] to display the remaining time[remaining-dhmstimer] to display the remaining time in days, hours, minutes and seconds[remaining-dhmtimer] to display the remaining time in days, hours and minutes[remaining-dhtimer] to display the remaining time in days and hours[remaining-dtimer] to display the remaining time in days[remaining-hmstimer] to display the remaining time in hours, minutes and seconds[remaining-hmtimer] to display the remaining time in hours and minutes[remaining-htimer] to display the remaining time in hours[remaining-mstimer] to display the remaining time in minutes and seconds[remaining-mtimer] to display the remaining time in minutes[remaining-stimer] to display the remaining time in seconds[remaining-hmsrtimer] to display only the hours, minutes and seconds of the remaining time in days, hours, minutes and seconds[remaining-hmrtimer] to display only the hours and minutes of the remaining time in days, hours, minutes and seconds[remaining-hrtimer] to display only the hours of the remaining time in days, hours, minutes and seconds[remaining-msrtimer] to display only the minutes and seconds of the remaining time in days, hours, minutes and seconds[remaining-mrtimer] to display only the minutes of the remaining time in days, hours, minutes and seconds[remaining-srtimer] to display only the seconds of the remaining time in days, hours, minutes and secondsAll counters will display:
It is possible to specify several dates for the date attribute, by separating the different dates by //, like this:
[counter date=2011/12/25//2012/01/01]
Just [remaining-timer] until Christmas![after]
For [elapsed-timer], Christmas has arrived!
Just [remaining-timer] until 2012![after]
For [elapsed-timer], we are in 2012![/counter]
Result (with a little formatting, time zone = UTC):
For 139 days 7 hours 42 minutes 29 seconds, we are in 2012!
You can use the following shortcodes:
[total-timer] to display the elapsed time since the first date of the date attribute[total-dhmstimer] to display the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-dhmtimer] to display the elapsed time since the first date of the date attribute in days, hours and minutes[total-dhtimer] to display the elapsed time since the first date of the date attribute in days and hours[total-dtimer] to display the elapsed time since the first date of the date attribute in days[total-hmstimer] to display the elapsed time since the first date of the date attribute in hours, minutes and seconds[total-hmtimer] to display the elapsed time since the first date of the date attribute in hours and minutes[total-htimer] to display the elapsed time since the first date of the date attribute in hours[total-mstimer] to display the elapsed time since the first date of the date attribute in minutes and seconds[total-mtimer] to display the elapsed time since the first date of the date attribute in minutes[total-stimer] to display the elapsed time since the first date of the date attribute in seconds[total-hmsrtimer] to display only the hours, minutes and seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-hmrtimer] to display only the hours and minutes of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-hrtimer] to display only the hours of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-msrtimer] to display only the minutes and seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-mrtimer] to display only the minutes of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-srtimer] to display only the seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-timer] to display the elapsed time since the first date of the date attribute[total-elapsed-dhmstimer] to display the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-dhmtimer] to display the elapsed time since the first date of the date attribute in days, hours and minutes[total-elapsed-dhtimer] to display the elapsed time since the first date of the date attribute in days and hours[total-elapsed-dtimer] to display the elapsed time since the first date of the date attribute in days[total-elapsed-hmstimer] to display the elapsed time since the first date of the date attribute in hours, minutes and seconds[total-elapsed-hmtimer] to display the elapsed time since the first date of the date attribute in hours and minutes[total-elapsed-htimer] to display the elapsed time since the first date of the date attribute in hours[total-elapsed-mstimer] to display the elapsed time since the first date of the date attribute in minutes and seconds[total-elapsed-mtimer] to display the elapsed time since the first date of the date attribute in minutes[total-elapsed-stimer] to display the elapsed time since the first date of the date attribute in seconds[total-elapsed-hmsrtimer] to display only the hours, minutes and seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-hmrtimer] to display only the hours and minutes of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-hrtimer] to display only the hours of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-msrtimer] to display only the minutes and seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-mrtimer] to display only the minutes of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-elapsed-srtimer] to display only the seconds of the elapsed time since the first date of the date attribute in days, hours, minutes and seconds[total-remaining-timer] to display the remaining time until the last date of the date attribute[total-remaining-dhmstimer] to display the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-dhmtimer] to display the remaining time until the last date of the date attribute in days, hours and minutes[total-remaining-dhtimer] to display the remaining time until the last date of the date attribute in days and hours[total-remaining-dtimer] to display the remaining time until the last date of the date attribute in days[total-remaining-hmstimer] to display the remaining time until the last date of the date attribute in hours, minutes and seconds[total-remaining-hmtimer] to display the remaining time until the last date of the date attribute in hours and minutes[total-remaining-htimer] to display the remaining time until the last date of the date attribute in hours[total-remaining-mstimer] to display the remaining time until the last date of the date attribute in minutes and seconds[total-remaining-mtimer] to display the remaining time until the last date of the date attribute in minutes[total-remaining-stimer] to display the remaining time until the last date of the date attribute in seconds[total-remaining-hmsrtimer] to display only the hours, minutes and seconds of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-hmrtimer] to display only the hours and minutes of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-hrtimer] to display only the hours of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-msrtimer] to display only the minutes and seconds of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-mrtimer] to display only the minutes of the remaining time until the last date of the date attribute in days, hours, minutes and seconds[total-remaining-srtimer] to display only the seconds of the remaining time until the last date of the date attribute in days, hours, minutes and secondsAnother example:
[counter date=2011/01/01//2012/01/01//2013/01/01//2014/01/01//2015/01/01]
Just [remaining-timer] until 2011 and [total-remaining-timer] until 2015![after]
For [elapsed-timer], we are in 2011!
Just [remaining-timer] until 2012 and [total-remaining-timer] until 2015![after]
For [elapsed-timer], we are in 2012 and for [total-elapsed-timer], 2011 has arrived!
Just [remaining-timer] until 2013 and [total-remaining-timer] until 2015![after]
For [elapsed-timer], we are in 2013 and for [total-elapsed-timer], 2011 has arrived!
Just [remaining-timer] until 2014 and [total-remaining-timer] until 2015![after]
For [elapsed-timer], we are in 2014 and for [total-elapsed-timer], 2011 has arrived!
Just [remaining-timer] until 2015![after]
For [elapsed-timer], we are in 2015 and for [total-elapsed-timer], 2011 has arrived![/counter]
Result (with a little formatting, time zone = UTC):
For 139 days 7 hours 42 minutes 29 seconds, we are in 2012 and for 504 days 7 hours 42 minutes 29 seconds, 2011 has arrived! Just 226 days 16 hours 17 minutes 31 seconds until 2013 and 956 days 16 hours 17 minutes 31 seconds until 2015!
You can display a periodic counter, like this:
[counter date=YYYY/MM/DD-hh:mm:ss period=d:h:m:s]
Just [remaining-timer] ![/counter]
d = number of days
h = number of hours
m = number of minutes
s = number of seconds
In some cases, you can specify the period differently:
d is equivalent to d:0:0:0d:h is equivalent to d:h:0:0d:h:m is equivalent to d:h:m:0The counter repeats with a period equal to the duration specified for the period attribute.
Example (counter repeating every day):
[counter date=2009/09/23 period=1]
Just [remaining-timer] before tomorrow ![/counter]
Result (with a little formatting, time zone = UTC):
Just 16 hours 17 minutes 31 seconds before tomorrow !
Another example (counter repeating every week):
[counter date=2011/09/04//2011/09/07 period=7]
Just [remaining-timer] before Sunday ![after]
Just [remaining-timer] before Wednesday ![/counter]
Result (with a little formatting, time zone = UTC):
Just 16 hours 17 minutes 31 seconds before Sunday !
It is possible to specify a relative date for the date attribute, like this:
[counter date=+d:h:m:s]
Just [remaining-timer]![after]Countdown ended!
[/counter]
[counter date=-d:h:m:s][after]Total time: [timer][/counter]
d = number of days
h = number of hours
m = number of minutes
s = number of seconds
In some cases, you can specify the duration differently:
+d is equivalent to +d:0:0:0+d:h is equivalent to +d:h:0:0+d:h:m is equivalent to +d:h:m:0-d is equivalent to -d:0:0:0-d:h is equivalent to -d:h:0:0-d:h:m is equivalent to -d:h:m:0The date is then the date of the first display of the content by the Internet user, increased or decreased by the specified duration.
Example:
[counter date=+0:0:2]
Just [remaining-timer]![after]Countdown ended!
[/counter]
Result (with a little formatting):
Just 2 minutes 0 second!
Another example:
[counter date=-0][after]
Elapsed time since your first display of this page: [timer]
[/counter]
Result (with a little formatting):
Elapsed time since your first display of this page: 0 second
With the origin attribute, you can use the date of the last display of the content by the Internet user, instead of the date of the first display.
Example:
[counter date=-0 origin=last-visit][after]
Elapsed time since your last display of this page: [timer]
[/counter]
Result (with a little formatting):
Elapsed time since your last display of this page: 0 second
To display the time, insert into your posts/pages/widgets a code like this:
It's [clock].
Result (time zone = UTC):
It's 07:42.
By default, the time is displayed in hours and minutes. If you want to display it in hours, minutes and seconds, use the format attribute and write [clock format=hms] instead of [clock]:
It's [clock format=hms].
Result (time zone = UTC):
It's 07:42:29.
The time is displayed according to the time zone of your website. Set correctly your time zone via the WordPress Administration Panel if you have not done. You may occasionally specify an offset to UTC time different from your time zone using the offset attribute.
To display the time of the Internet user:
It's [clock offset=local].
Result:
It's 07:42.
The offset attribute is the offset (in hours) to UTC time. You can specify any relative number for this attribute. You also can specify the local value to display the time of the Internet user. The offset attribute can be used for all shortcodes in the Time And Date and Time Zone sections.
To display the year, insert into your posts/pages/widgets a code like this:
We are in [year].
Result (time zone = UTC):
We are in 2012.
By default, the year is displayed in 4 digits. If you want to display it in 2 digits, use the format attribute and write [year format=2] instead of [year].
To display the ISO 8601 week number and year, insert into your posts/pages/widgets a code like this:
We are in the week [yearweek] of [isoyear].
Result (time zone = UTC):
We are in the week 20 of 2012.
To display the day number of the year, insert into your posts/pages/widgets a code like this:
Today, it's the day [yearday] of [year].
Result (time zone = UTC):
Today, it's the day 140 of 2012.
To display the month, insert into your posts/pages/widgets a code like this:
We are in [month].
Result (time zone = UTC):
We are in May.
By default, the month is displayed in letters, with the first letter capitalized. Use the format attribute and give the value:
To display the day number of the month, insert into your posts/pages/widgets a code like this:
Today is [month] [monthday], [year].
Result (time zone = UTC):
Today is May 19, 2012.
By default, the day number of the month is displayed as a number with 1 or 2 digits (1 digit for the first nine days of the month, 2 digits for the others). If you want to display it as a number with 2 digits (first digit equal to 0 for the first nine days of the month), use the format attribute and write [monthday format=2] instead of [monthday].
To display the weekday, insert into your posts/pages/widgets a code like this:
Today is [weekday], [month] [monthday], [year].
Result (time zone = UTC):
Today is Saturday, May 19, 2012.
By default, the weekday is displayed with the first letter capitalized. Use the format attribute and give the value:
Example:
Yesterday was [weekday offset=-24], [month offset=-24] [monthday offset=-24], [year offset=-24].
Today is [weekday format=lower offset=0], [month format=lower offset=0] [monthday offset=0], [year offset=0].
Tomorrow will be [weekday format=upper offset=24], [month format=upper offset=24] [monthday offset=24], [year offset=24].
Result:
Yesterday was Friday, May 18, 2012.
Today is saturday, may 19, 2012.
Tomorrow will be SUNDAY, MAY 20, 2012.
To display the time zone of your website, insert into your posts/pages/widgets a code like this:
The time zone of this website is [timezone].
Result:
The time zone of this website is UTC.
The displayed time zone will be automatically updated each time you will change the time zone of your website.
To display the time zone of the Internet user:
Your time zone is [timezone offset=local].
Result:
Your time zone is UTC.
To display an option of Easy Timer, insert into your posts/pages/widgets a code like this:
[easy-timer option]
by replacing option with:
[timer] shortcodeExample:
Default prefix of the <code>[timer]</code> shortcode: [easy-timer default-timer-prefix]
Result:
Default prefix of the [timer] shortcode: dhms
You can specify a text that will be displayed instead of the option when this one is empty, using the default attribute, like this:
[easy-timer option default="text"]
Don't forget to include the quotes at the beginning and the end of the default value.
You can specify a PHP function that will be applied to the option before this one is displayed, using the filter attribute, like this:
[easy-timer option filter=function]
Replace function by the name of the function you want to apply.
Sometimes, the option is an English word. You can translate it into the language of your website by entering i18n as the value for the filter attribute.
Example:
JavaScript enabled: [easy-timer javascript-enabled filter=i18n]
Result:
JavaScript enabled: yes
It is possible to specify several functions for the filter attribute, by separating the different functions by /, like this:
[easy-timer option filter=function1/function2/.../functionN]
The functions will be applied in the specified order.
By default, they are displayed in English. But if your website language is Belarusian, Chinese, Dutch, French, German, Hebrew, Hungarian, Italian, Polish, Portuguese, Russian, Slovak, Spanish or Swedish, then they will automatically be displayed in this language. If this is not the case, open your wp-config.php file and change the WPLANG value. WPLANG values supported by Easy Timer are:
Javascript may be deactivated in your browser. In this case, activate it. Check the Add JavaScript code field in the options page of Easy Timer. Check the footer.php file of your WordPress theme. Make sure there is a call to wp_footer.
Insert into the PHP files of your theme a code like this:
<?php echo do_shortcode('[your-shortcode]'); ?>
Edit the functions.php file (create it if it doesn't exist) of your WordPress theme and add this line of code:
add_filter('comment_text', 'do_shortcode');
You can write your comment as to any website. You can also format it using HTML tags.
Display the Comment Writing FAQ
Here are the answers to frequently asked questions.
Simply click on the smiley in the toolbar.
Return to the entry field of your comment
Return to the list of questions
Enclose this text between the <strong> and </strong> tags that you can insert by writing them yourself or by clicking on the b button in the toolbar.
Example:
<strong>Bold text</strong>
Result:
Bold text
Return to the entry field of your comment
Return to the list of questions
Enclose this text between the <em> and </em> tags that you can insert by writing them yourself or by clicking on the i button in the toolbar.
Example:
<em>Italic text</em>
Result:
Italic text
Return to the entry field of your comment
Return to the list of questions
Enclose this text between the <del> and </del> tags that you can insert by writing them yourself or by clicking on the button in the toolbar.del
Example:
<del>Strikethrough text</del>
Result:
Strikethrough text
Return to the entry field of your comment
Return to the list of questions
Enclose this text between the <ins> and </ins> tags that you can insert by writing them yourself or by clicking on the ins button in the toolbar.
Example:
<ins>Underlined text</ins>
Result:
Underlined text
Return to the entry field of your comment
Return to the list of questions
Click on the url button in the toolbar, enter the URL of the page and the text of your link.
Example:
<a href="http://www.kleor-editions.com">Kleor Editions</a>
Result:
Return to the entry field of your comment
Return to the list of questions
Enclose this text between the <blockquote> and </blockquote> tags that you can insert by writing them yourself or by clicking on the citation button in the toolbar.
Example:
<blockquote>Quote</blockquote>
Result:
Quote
Return to the entry field of your comment
Return to the list of questions
Enclose the text of this paragraph between the <pre> and </pre> tags that you can insert by writing them yourself or by clicking on the pre button in the toolbar.
Example:
<pre><a href="http://www.kleor-editions.com">Kleor Editions</a></pre>
Result:
<a href="http://www.kleor-editions.com">Kleor Editions</a>
Return to the entry field of your comment
Return to the list of questions
Enclose this code between the <code> and </code> tags that you can insert by writing them yourself or by clicking on the code button in the toolbar.
Example:
<code><a href="http://www.kleor-editions.com">Kleor Editions</a></code>
Result:
<a href="http://www.kleor-editions.com">Kleor Editions</a>
Return to the entry field of your comment
Return to the list of questions
Like this:
<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>...</li>
</ul>
Result:
You can insert:
<ul> and </ul> tags by writing them yourself or by clicking on the ul button in the toolbar<li> and </li> tags by writing them yourself or by clicking on the li button in the toolbarReturn to the entry field of your comment
Return to the list of questions
Like this:
<ol>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>...</li>
</ol>
Result:
You can insert:
<ol> and </ol> tags by writing them yourself or by clicking on the ol button in the toolbar<li> and </li> tags by writing them yourself or by clicking on the li button in the toolbarReturn to the entry field of your comment
Return to the list of questions
Simply click on Preview under the entry field of your comment.
Hide the Comment Writing FAQ
Return to the list of questions
Hi Jeremy,
I find your plugin very useful and of very simple use. In my case I need to display the time I have been traveling for and at the moment it displays the amount of days.
How do I get the the timer to display the countup in years, months and days?
Thank you so much for your help and possible improvement to this plugin.
Gionata
It may be possible in a later version.
Thank you very much jeremy, keep up the good work!
Regards
Hello,
First of all thank you for providing Easy Timer – just what I needed!
I am having trouble with something very simple though. I want to display the elapsed time the user has been on the current page.
For some reason, the timer displays 0 min 0 secs, then jumps to 1 min, 20 secs, and keeps counting from there.
It is also doing this on your help documentation page.
Any suggestions?
Thank you
The code I used was your example code:
[countup]You have spent [timer] on this webpage.[/countup]
Thanks again.
Lisa
Synchronize the time of your computer with Internet.
Got it! Thanks!
Thanks! And another question: how can I format the timer to display minutes and seconds with leading zeros? Example: 12:01:02, not like now 12:1:2
Same answer
How can I format the displaying countdown timer into h:m:s format. I don’t need default h hours m minutes s seconds.
It will be possible in a later version. But you can edit the easy_timer_lang_js and timer_string functions of the easy-timer.php file.
[...] http://www.kleor-editions.com/easy-timer/en/ [...]
Hello again Jérémy.
This is the most flexible timer ever.
Ive tried a lot but none of them could do ecxactly what i wanted.
Im using EASY TIMER for soon expiring deals
The future expired dates are bulk imported through an rss feed.
Next i installed ”the future is now” plugin so i ended up to my functions.php with this code ,combined with your allready installed plugin :
$shortcode =get_the_date('Y-m-d H:i:s');echo do_shortcode('[countdown date=" '. $shortcode .' " ][timer][after] Expired[/countdown]');
The first line(get_the_date) refers to the “future is now ” plugin and my inserting date format:(‘Y-m-d H:i:s’).
And the the next two lines to EASY TIMER.
Dont forget to enclose the code
Im new to php so it took me about 3 no ..i won’t lie 4 days to figure this out:lol:
Thank you Jérémy,and for your new updates!!!
[...] Kleor WWW: home page, [...]
[...] Kleor WWW: home page, [...]
Hi,
Can someone help me out a very basic requirement that I can’t get correct.
I want every visitor to have the countdown timer on my squeeze page to countdown 5 minutes and to display the remaining time in minutes and seconds.
I inserted this code:
[countdown date=+5:0]
Only [remaining-mstimer] to go!
[/countdown]
But I got was the countdown was staring from 1440 minutes and 0 seconds.
How do I correct this, please?
JP
Thank you Jeremy.
Works beautifully.