=== Devgirl Countdown Clock ===
Contributors: elfynity5
Donate link: https://devgirl.co.za/plugins-donations/
Tags: countdown clock, countdown timer
Requires at least: 4.9
Tested up to: 6.1.1
Requires PHP: 5.2
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A simple countdown timer/clock you can place in a page, post or widget using a shortcode. Elementor-friendly.





== Description ==
The simple countdown clock is used to countdown to a date and time of your choosing using a Wordpress shortcode. 

* Use the shortcode on more than one page or post.
* The shortcode comes with different options you can set.
* Choose your date to countdown to.
* Choose your background colour.
* Choose your text colour,
* Choose the message you would like to display once the countdown timer has reached the due time.







== Installation ==
1. Install the plugin and click Activate.
2. Use the following shortcode to display in your post, page, text widget or Elementor shortode: **[devgirl-countdown-clock time="31 Dec 2023 8:00"]**
3. Put your own date and time in here: time="31 Dec 2023 8:00". 
4. Navigate to Settings->Countdown Clock for all instructions.

### You can use extra included parameters:
* end-notice = "" eg: end-notice = "Countdown done!"
* clock-colour = "" eg: clock-colour = "orange"
* text-colour = "" eg: text-colour = "#000000"

### Full shortcode example with all parameters used:
* [devgirl-countdown-clock time="31 Dec 2023 8:00" end-notice="The countdown is over!" clock-colour="red" text-colour="#000000"]

### Colour inputs you can use:
* A word eg: red
* A hex value eg: #0011aa
* Clock-color only: For those who are CSS savvy, any CSS value for the clock-colour parameter. It is a background shorthand property.

	eg: rgba(0, 0, 0, 0.5)
	eg: linear-gradient(to left, darkTurquoise, aqua, blue)






== Frequently Asked Questions ==
= Can I use this countdown clock more than once on a page or post? =
At the moment, you can only use the clock once on a page or post. I will be developing it further with this in mind.

= What can we expect to see in future releases? =
* I am going to create an admin area where global options can be selected.
* I will be developing more clock styles to choose from. 
* I plan to create a widget for the plugin. 
* I have considered that I'd like the clock to do some sort of animation when it starts to get closer to the end time, and allow the user to choose when that animation begins.


= Can I make suggestions to improve your plugin? =
Yes, please do, your feedback would be totally appreciated!





== Screenshots ==
1. The default countdown clock.
2. Add the shortcode in a page or post.
3. Add the shortcode in the Elementor shortcode widget.
4. Use options in the shortcode to customise your countdown clock.






== Changelog ==
= 1.0 =
* This is the first release of this plugin.  *


== Upgrade Notice ==
No upgrades at present.