CSSable Countdown

Tanya Jawab

How do I use the widget?

Go to Appearances > Widgets and drag the CSSable Countdown widget where you want it. Expand the widget to fill out the particulars.

How do I use the shortcode?

The shortcode is much more involved than the point-and-click interface of the widget.

The shortcode’s minimum syntax is:

[countdown date="MM/DD/YYYY"]

You can specify additional options:

• time – in HH:MM:SS format (make sure you use 24-hour time). Defaults to 00:00:00.
• timezone – in ±HH:MM GMT format (e.g. EST is -5, India is +5:30, etc). Defaults to your WordPress’s GMT offset as defined in Settings > General > Timezone.
• format – valid options are any of case-sensitive YOWDHMS. Defaults to ydHMS. See [*] below for more information.
  • Y – years
  • O – months
  • W – weeks
  • D – days
  • H – hours
  • M – minutes
  • S – seconds
• significant – valid options are 1 through 7. See [+] below for more information.
• direction – valid options are down and up. Toggles countdown vs. countup timer. Defaults to down.
• event – the event description.
• display – valid options are default, list, text, compact. Defaults to default. Controls the presentation and basic styling options.
• expirytext – plaintext string to display on time expired.

[*] format is the powerhouse that controls the digits displaying on the timer. It is case-sensitive:

• Uppercase values will always display
• Lowercase values will display only if non-zero
• Unspecified values will never display

For example, the default value of ydHMS will show you years and days if they’re non-zero, but hours, minutes, and seconds will always be shown. If you didn’t care about the time, you could show years, months, and days with just YMD.

[+] significant controls how many significant digits are displayed.

Combining format with significant produces almost any combination of date and time values that you want displayed.

Note: you cannot set an expiration URL with the shortcode, since shortcodes are, by definition, parsed after headers are sent.

I don’t want your bare-bones CSS! How can I disable it completely?

In your functions.php file, add these lines:

wp_dequeue_style( 'cssable-countdown-style-default' );
wp_dequeue_style( 'cssable-countdown-style-list' );
wp_dequeue_style( 'cssable-countdown-style-text' );

How do I add my own CSS?

In your functions.php file, add these lines for every CSS file you’re including:

wp_enqueue_style( 'cssable-countdown-style-YOURNAMEHERE', 'PATH/TO/CUSTOM/CSS/FILE.css' , '', '1.1' );

• Replace YOURNAMEHERE with a unique name so it won’t conflict with any other stylesheets.

• Replace PATH/TO/CUSTOM/CSS/FILE.css with the path to your CSS file. It is suggested that you put the CSS file in your themes directory and use WordPress’s get_stylesheet_directory() for your theme instead of giving it an absolute URL. Ex:

  wp_enqueue_style( ‘cssable-countdown-style-YOURNAMEHERE’, get_stylesheet_directory() . ‘/css/YOURCUSTOMFILE.css’ , ”, ‘1.1’ );

What languages are supported?

Although the admin panel is currently only localized in English, the countdown will automatically take the language you have your WordPress set to.

• Albanian (Gjuha shqipe)
• Arabic (العربية)
• Armenian (Հայերեն)
• Bengali/Bangla (বাংলা)
• Bosnian (Bosanski)
• Bulgarian (български език)
• Burmese (မြန်မာစာ)
• Catalan (Català)
• Chinese/Simplified (简体中文
• Chinese/Traditional (繁體中文)
• Croatian (Hrvatski jezik)
• Czech (Čeština)
• Danish (Dansk)
• Dutch (Nederlands)
• Estonian (eesti keel)
• Farsi/Persian (فارسی)
• Finnish (suomi)
• French (Français)
• Galician (Galego)
• German (Deutsch)
• Greek (Ελληνικά)
• Gujarati (ગુજરાતી)
• Hebrew (עברית
• Hungarian (Magyar)
• Indonesian (Bahasa Indonesia)
• Icelandic (Íslenska)
• Italian (Italiano)
• Japanese (日本語)
• Kannada ( ಕನ್ನಡ )
• Korean (한국어)
• Latvian (Latviešu Valoda)
• Lithuanian (lietuvių kalba)
• Malayalam (മലയാളം)
• Malaysian (Bahasa Melayu)
• Norwegian (Bokmål)
• Polish (Polski)
• Portuguese/Brazilian (Português)
• Romanian (Română)
• Russian (Русский)
• Serbian (српски језик)
• Serbian (srpski jezik)
• Slovak (Slovenčina)
• Slovenian (Slovenščina)
• Spanish (Español)
• Swedish (Svenska)
• Thai (ภาษาไทย)
• Turkish (Türkçe)
• Ukrainian (українська мова)
• Uzbek (O‘zbek tili)
• Vietnamese (Tiếng Việt)
• Welsh (Cymraeg)