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

Countdown timer block for Gutenberg – count down to events, sales, and launches with customizable layouts, colors, separators, and patterns.

== Description ==

**Show visitors exactly how long they have left – add a professional countdown timer to any post or page and turn deadlines into action.**

[**Countdown Timer Block**](https://bplugins.com/products/countdown-time/) | [**Documentation**](https://ctb.bplugins.com/docs/) | [**Pricing**](https://bplugins.com/products/countdown-time/pricing/)

### Why Countdown Timer Block?

Nothing motivates visitors like a ticking clock. **Countdown Timer Block** adds a dedicated block to the WordPress Block Editor so you can create a professional-looking countdown for your event, sale, or launch in minutes – no code required.

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

Choose from four distinct layouts, toggle days, hours, minutes, and seconds on or off, and style every part of the timer – wrapper, boxes, digits, labels, and separators – to match your brand. Predefined patterns give you ready-made designs, and the timer stays fully responsive on mobile devices.

### Free Features

- **Layout Options:** Choose from 4 distinct templates for different presentations.
- **Responsive:** Looks great on mobile devices out of the box.
- **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 Version

Upgrade to [**Countdown Timer Pro**](https://bplugins.com/products/countdown-time/pricing/) for advanced behavior and styling controls:

- **Expired Display:** Show custom content after the countdown has elapsed.
- **Hide at Zero:** Conceal the box when the countdown timer reaches 0.
- **Mobile & Tablet Visibility:** Toggle the timer's visibility per device.
- **Prefix Text & Style:** Display styled text before the countdown timer.
- **Suffix Button & Style:** Show a button after the timer with typography, color, and padding controls.
- **Prefix/Suffix Direction:** Control the layout flow of content before and after the timer.
- **Single Style:** Style each box individually – background, digit color, and label color.
- **Dismiss Button:** Let visitors hide the countdown manually.
- **Extra Patterns:** Additional predefined countdown designs.
- **Shortcode Integration:** Use the countdown anywhere via shortcode.

### How to Use – Quick Start

1. Install and activate the **Countdown Timer** plugin.
2. Add the **Countdown Timer** block from the "Widgets" block category in the Gutenberg editor.
3. Set your target date and adjust the design from the right-side settings sidebar.
4. Publish – your countdown is live!

### Use Cases

- **Sales & Promotions:** Count down to the end of a discount to create urgency.
- **Product Launches:** Build anticipation before a new product or website goes live.
- **Events & Webinars:** Show visitors exactly when your event starts.
- **Limited-Time Offers:** Pair the timer with a call-to-action button (Pro suffix button).

### 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 your WordPress dashboard (recommended):**

1. Go to **Plugins → Add New**.
2. Search for **"Countdown Timer"**.
3. Click **Install Now**, then **Activate**.
4. Add the **Countdown Timer** block in the Gutenberg editor.

**Manual installation:**

1. Download the **Countdown Timer** plugin (*.zip file*).
2. In your admin area, go to **Plugins → Add New** and click **Upload Plugin**.
3. Choose the **`countdown-time.zip`** file, click **Install Now**, then **Activate**.
4. Alternatively, upload the plugin folder to the **`/wp-content/plugins/`** directory and activate it from the **Plugins** menu.

== Frequently Asked Questions ==

= Is the Countdown Timer Block free? =

Yes, Countdown Timer Block is a free Gutenberg block plugin. A Pro version adds advanced behavior and styling options.

= Does it work with any WordPress theme? =

Yes, it works with any standard WordPress theme.

= Can I change block settings? =

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

= Can I show a message after the countdown ends? =

Yes. The Pro version's Expired Display feature shows custom content once the timer has elapsed, and Hide at Zero can hide the timer entirely when it reaches 0.

= Can I use the countdown outside the block editor? =

Yes. The Pro version includes shortcode integration, so you can place the countdown in various locations across your site.

= Will the countdown timer slow down my website? =

No. The plugin's scripts are only loaded on pages where the block is actually used.

= How many times can I reuse the block? =

There is no limit – add as many countdown timers 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

== 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

== Changelog ==

= 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.
