=== Countdown Timer Block – Build urgency for events and launches ===
Contributors: bplugins, abuhayat, charlescormier, freemius
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, countdown timer blocks, timer, count time, event date
Requires at least: 6.5
Tested up to: 7.1
Stable tag: 1.3.4
Requires PHP: 7.4
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Display your event's date on a timer to your visitor with a countdown timer block

== Description ==

👉 [Plugin Demo](https://bplugins.com/products/countdown-time/) | [Documentation](https://ctb.bplugins.com/docs/) | [Get Pro Version](https://bplugins.com/products/countdown-time/pricing/) 👈

Professionally showcase your countdown timer. This plugin adds a new block in the Block Editor by which you can create a professional-looking countdown timer block!

https://youtube.com/watch?v=DW02aMWHJbE

It is very effective in presenting your countdown timer nicely. There are many options that you can use to decorate your countdown timer in any color you like.


= Features =
- **Layout Options**: Choose from 4 distinct templates for different presentations.

- **Responsiveness**: Responsive for the mobile devices.

- **Element Visibility**: Toggle the visibility of labels, days, hours, minutes, and seconds.

- **Wrapper Customization**: Configure width, background, padding, and shadow for the countdown wrapper.

- **Boxes Customization**: Define background, width, height, border, and shadow settings for the countdown boxes.

- **Content Appearance**: Adjust typography and color for the digit and label elements.

- **Separator Customization**: Display separators and configure type, size, and color settings.

- **Patterns**: Predefined designs for expanding the variety of styles.


= Pro Features =
- **Expired Display:** Show content that has expired after the countdown timer has elapsed.

- **Hide at Zero:** Conceal the box when the countdown timer reaches 0.

- **Mobile Visibility:** Toggle visibility of the countdown timer on mobile devices.

- **Tablet Visibility:** Toggle visibility of the countdown timer on tablet devices.

- **Prefix Text:** Display text before the countdown timer.

- **Prefix Style:** Implement typography settings and adjust the color for the prefix text.

- **Suffix Button:** Show a button after the countdown timer.

- **Suffix Button Style:** Apply typography, colors(text and background) and padding for the suffix button.

- **Prefix Suffix Direction:** Direction of the content displayed before and after the countdown timer.

- **Single Style:** Apply different styles to each box, including variations in background, digit color, and label color.

- **Dismiss Button:** Provide a button to dismiss/hide the countdown timer.

- **Patterns**: Additional patterns for expanding the variety of countdown styles.

- **Shortcode Integration:** Shortcode for flexible use across various locations.


= How to use =
- First, install the Countdown Timer plugin
- Add the Countdown Timer block from the block category called "Widgets" in the Gutenberg editor.
- You can change block settings from the right-side settings sidebar.
- Enjoy!

* For Installation help click on Installation Tab


= Feedback =
- Did you like this plugin? Dislike it? Do you have a feature request? [Please share your feedback with us](mailto:support@bplugins.com 'Send feedback')


### Check out the Parent Plugin of this plugin-

[**B Blocks**](https://bblockswp.com) – A blocks collection and page building tool for Gutenberg.


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) – Embed 3D models and 3D products with interaction.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== Installation ==

= From Gutenberg Editor: =
1. Go to the WordPress Block/Gutenberg Editor
2. Search For **Countdown Timer**
3. Click on the **Countdown Timer** block to add the block

= Download & Upload: =
1. Download the **Countdown Timer** plugin (*.zip file*)
2. In your admin area, go to the Plugins menu and click on **Add New**
3. Click on **Upload Plugin** and choose the **`countdown-time.zip`** file and click on **Install Now**
4. Activate the plugin and Enjoy!

= Manually: =
1. Download and upload the **Countdown Timer** plugin to the **`/wp-content/plugins/`** directory
2. Activate the plugin through the Plugins menu in WordPress


== Frequently Asked Questions ==

= Is the Countdown Timer Block free? =

Yes, Countdown Timer Block is a free Gutenberg block plugin.

= Does it work with any WordPress theme? =

Yes, it will work with any standard WordPress theme.

= Can I change block settings? =

Yes, you can change block settings from the Gutenberg block editor's right sidebar.

= How many times can I reuse a block? =

You can use unlimited times as you want.

= Where can I get support? =

You can post your questions on the [support forum here](https://wordpress.org/support/plugin/countdown-time/)

= Where do I report security bugs found in this plugin? =

Please report security bugs found in the source code of the Countdown Timer plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fc31f-1fa2-420c-bdc3-2629eaa79a31). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.


== Screenshots ==

1. Default Layout
2. Second Layout
3. Third Layout
4. Forth Layout
5. Countdown Settings


== Changelog ==

= 1.3.4 - 17 Nov 2026 =
* **Improvement:** Fix minor issues.

= 1.3.3 - 09 Jun 2026 =
* **Update:** SDK
* **Update:** Performance Improvement

= 1.3.2 - 04 Mar 2026 =
* **Update:** Admin Dashboard - Improved UI with better navigation and clearer feature organization.

= 1.3.1 - 29 Nov 2025 =
* **Update:** Performance Improvement

= 1.3.0 - 20 Sep 2025 =
* Add Admin Dashboard
* Update SDK
* Reduce Code for Performance

= 1.2.8 - 5 May 2025 =
* Fix textdomain issue.

= 1.2.7 - 17 Feb 2025 =
* Improve security

= 1.2.6 - 27 Jan 2025 =
* Update SDK.

= 1.2.5 - 2 Nov 2024 =
* Fix ShortCode Issue.
* Update SDK

= 1.2.4 - 4 Feb 2024 =
* Fix activation issue.

= 1.2.3 - 20 Jan 2024 =
* General improvements and optimizations.

= 1.2.2 - 13 Jan 2024 =
* Fix label change issue

= 1.2.1 - 1 Jan 2024 =
* Fix issue

= 1.2.0 - 27 Dec 2023 =
* Performance Improvement

= 1.1.7 =
* Fix the issue.

= 1.1.6 =
* Not load scripts if block is not used.

= 1.1.5 =
* Responsive enable/disable option.

= 1.1.4 =
* Fix free-pro activation conflict.

= 1.1.3 =
* Responsive Fix

= 1.1.2 =
* Add translate feature

= 1.1.1 =
* Fix HTML Render

= 1.1.0 =
* Reduce PHP Code
* Performance Improvement

= 1.0.9 =
* Fix issue

= 1.0.8 =
* Reduce PHP Code

= 1.0.7 =
* Performance upgrade

= 1.0.6 =
* Performance upgrade

= 1.0.5 =
* Change default colors & performance upgrade

= 1.0.4 =
* Separator CSS fix

= 1.0.3 =
* Update labels in a modern way
* Separator align fix

= 1.0.2 =
* Fix days count.

= 1.0.1 =
* Layout fixing.

= 1.0.0 =
* Initial Release.


== Source Code ==

You can find the source code, report bugs, and contribute to the development of this plugin on our GitHub repository:
[**Countdown Timer on GitHub**](https://github.com/bPlugins/countdown-time-wp)


== Third-Party Libraries ==

This plugin bundles the following third-party JavaScript/PHP libraries.

= Freemius Lite SDK =
* **Source:** [https://bplugins.com/](https://bplugins.com/)
* **GitHub:** [https://github.com/bPlugins/freemius-lite-sdk](https://github.com/bPlugins/freemius-lite-sdk)
* **License:** GPL-2.0-or-later – [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)
* **Purpose:** Provides an opt-in consent form for usage tracking and analytics to help improve the plugin. No data is sent before explicit user consent.
* **External Services:** Communicates with `api.bplugins.com` (activation events) and `wp.freemius.com` (opt-in processing) only after user opt-in. See [bPlugins Privacy Policy](https://bplugins.com/privacy-policy/) and [Freemius Privacy Policy](https://freemius.com/privacy/).

= bpl-tools =
* Source / GitHub: https://github.com/bPlugins/bpl-tools
* License: GPL-2.0-or-later – https://www.gnu.org/licenses/gpl-2.0.html
* Purpose: Shared utility library providing admin dashboard components and common Gutenberg editor controls.
* External Services: The library may connect to bPlugins, WordPress.org, and Freemius services for product data and checkout functionality. See full details: https://github.com/bPlugins/bpl-tools#external-requests--why-they-are-made