=== Simple Stopwatch Easy to Use ===
Contributors: itsmeakay
Tags: stopwatch, timer, countdown, shortcode, block
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 1.1.0
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a simple, easy-to-use stopwatch or countdown timer to any page or post using a shortcode or block.

== Description ==

Simple Stopwatch Easy to Use lets you embed a fully functional stopwatch or countdown timer anywhere on your WordPress site, using either a shortcode or a block.

**Features:**

* Stopwatch (count up) and countdown timer modes
* Start, Stop, Reset controls
* Lap time recording, with export to a text file
* Optional millisecond display
* Optional sound on start/stop and when a countdown reaches zero
* Optional "remember time after page reload" using local storage
* Works as a Gutenberg block or a shortcode
* Multiple stopwatches on the same page work independently
* Customizable color and size
* Lightweight — no jQuery dependency
* Works on any theme

**Usage:**

Add the "Simple Stopwatch" block from the block inserter, or use the shortcode:

`[simple_stopwatch]`

**Shortcode Options:**

* `mode` — `stopwatch` or `countdown`. Default: `stopwatch`
* `from` — countdown starting time, format `HH:MM:SS`. Default: `00:05:00`. Only used when `mode="countdown"`
* `color` — button color (hex). Default: `#2271b1`
* `size` — display size: `small` or `large`. Default: `large`
* `ms` — show milliseconds: `yes` or `no`. Default: `no`
* `sound` — play a sound on start/stop/countdown-end: `yes` or `no`. Default: `no`
* `persist` — remember elapsed time after a page reload: `yes` or `no`. Default: `no`

Example: `[simple_stopwatch mode="countdown" from="00:10:00" color="#25D366" sound="yes"]`

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/simple-stopwatch-easy-to-use/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Add the "Simple Stopwatch" block from the block inserter, or add `[simple_stopwatch]` to any page or post

== Frequently Asked Questions ==

= How do I add the stopwatch to my page? =
Use the block inserter and search for "Simple Stopwatch", or add the shortcode `[simple_stopwatch]` to any page, post, or widget.

= Can I use a countdown timer instead of a stopwatch? =
Yes — set `mode="countdown"` and `from="00:10:00"` (or whatever starting time you want) in the shortcode, or choose "Countdown timer" in the block settings.

= Can I change the color? =
Yes — use `[simple_stopwatch color="#ff0000"]` or set the color in the block's Inspector panel.

= Can I add more than one stopwatch on the same page? =
Yes, each one runs independently.

= Does it remember the time if I refresh the page? =
Only if you enable that option (`persist="yes"` in the shortcode, or the matching toggle in the block).

== Screenshots ==

1. The stopwatch running on a page, with lap times and export
2. The shortcode builder under Tools — pick your options and copy the shortcode

== Changelog ==

= 1.1.0 =
* Added countdown timer mode
* Added Gutenberg block (in addition to the shortcode)
* Fixed: multiple stopwatches on the same page now work independently
* Added optional millisecond display
* Added optional sound on start/stop and countdown end
* Added optional "remember time after reload"
* Added lap export to a text file
* Added accessibility labels to controls

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.1.0 =
Adds countdown mode, a block, and fixes multiple stopwatches not working on the same page.
