Simple Text Only Countdown

Description

A simple countdown shortcode plugin that displays just the text. No flash nor javascript for live timer effect, nor styles, just plain text. Perfect for in-line text-based countdown timer. Visitors need to refresh the browsers in order to update the countdown.

USAGE

When you’re done installing the plugin, just put a [cntdwn todate="9 January 2019 08:00" timeoff="0"] shortcode into your content. Make sure to change the todate parameter to your target date, and timeoff to the GMT offset (in hours) of the time indicated in the todate.

Anything that can be parsed by the strtotime php function can be used in the todate parameter. But in order to avoid confusion, it’s better to stick with the format as the sample above.

See the Frequently Asked Questions for the complete parameters available and their default values.

Installation

1. Upload the simple-text-only-countdown folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the ‘Plugins’ menu in your WordPress installation.

FAQ

How to use this plugin?

• When you’re done installing the plugin, just put a [cntdwn todate="9 January 2019 08:00" timeoff="0"] shortcode into your content. Make sure to change the todate parameter to your target date, and timeoff to the GMT offset (in hours) of the time indicated in the todate.

What are the other parameters available?

The complete parameters that you may use in the shortcode, and their default values, are:

• todate -> target date to where we’re counting down to;
• timeoff -> GMT offset time. Default is 0 or UTC;
• sep -> the separator to use in between days, hours, etc. Default is ', '. Feel free to change it to <br /> or otherwise.
• showhours -> Show number of hours remaining? Default is 1 for true. The todate may be too far in the future that render hours irrelevant.
• showmins -> Show number of minutes remaining? Default is 1 for true. See showhours above.
• showsecs -> Show number of seconds remaining? Default is 0 for false. Seconds may only be relevant for countdowns with live timers.
• pretext -> The text before the countdown text. Default is 'The event starts in ';
• posttext -> The text following the countdown text. Default is '.';
• donemsg -> The text message when the countdown is done. Default is 'The countdown is done.'.

What’s the standard format for the `todate` parameter?

• Anything that can be parsed by the strtotime php function can be used in the todate parameter. But in order to avoid confusion, it’s better to stick with the format as the sample above.

How to put the countdown in my theme files?

• The do_shortcode() can do that for you.

Is there a widget available for the sidebar?

• No. But this article can show you how to use a shortcode in the sidebar widget.

Is there a working demo for this plugin?

• If the target date hasn’t come yet, you might see a working demo of the plugin at ChessHive.

Reviews

Perfect for simple applications

Justin Jackson November 24, 2017

Perfect if you just need an in-line text-based countdown timer.

Great plugin

paburmester November 10, 2016 2 replies

Great plugin! simple but makes exactly what they offer. It will be great if we can personalize also “years”, “months”, “days”, “hours”, “minutes” and “seconds”, so we can translate them completely.

Contributors & Developers

Changelog

1.2.0

• Bug fix to get rid of “A non well formed numeric value encountered” error.
• Updated descriptions.

1.1.0

• Changed function name to make it more unique and avoid conflicting with other functions.

1.0

• Original version.