=== Caresort Animated Counters for Elementor ===
Contributors: caresortsolutions
Tags: elementor, counter, number counter, animated counter, stats
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.0
Requires Plugins: elementor
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Two Elementor widgets: an animated number counter, and an animated progress bar — both with scroll-trigger animation and full color/font control.

== Description ==

**Caresort Animated Counters for Elementor**, by Caresort Solutions, adds two widgets to Elementor — "Animated Counter" and "Animated Progress Bar" — fully compatible with the **free version of Elementor** (no Elementor Pro required).

= Features =

* A number that counts up from a starting value to an ending value, with an adjustable animation duration.
* Optional thousands separator, decimal places, and a custom prefix or suffix (e.g. "$", "+", "%", "M") — enough to display things like "1,250+" or "$1.2M".
* An icon (from Elementor's own icon library, or a custom SVG upload) above the number.
* A title label below the number (e.g. "Projects Completed", "Happy Clients").
* Scroll-trigger animation — the count-up only plays once the counter scrolls into view, so it replays the "wow" moment for every visitor instead of running once on page load.
* Full style controls: icon color and size, number color and typography, title color and typography, alignment, and spacing.
* Lightweight — the count-up animation is built with a small vanilla-JS easing function; no GSAP or other external animation library is loaded.

= Requirements =

* [Elementor](https://wordpress.org/plugins/elementor/) (free version) must be installed and activated.

== Installation ==

1. Upload the `caresort-animated-counters-for-elementor` folder to `/wp-content/plugins/`, or install via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin.
3. Make sure **Elementor** is installed and activated.
4. Edit a page with Elementor, search for **"Animated Counter"** in the widget panel, and drag it onto your page.
5. Set the starting and ending numbers, icon, title, and animation options from the Content tab.

== Frequently Asked Questions ==

= Does this work with the free version of Elementor? =
Yes. Elementor Pro is not required.

= Does this use GSAP? =
No. The count-up animation uses a lightweight, dependency-free vanilla-JS easing function for a smooth, GSAP-like feel without loading an external library.

= Can I show four counters in a row, like a stats section? =
Yes — place four Animated Counter widgets inside an Elementor Container set to a 4-column layout.

== Screenshots ==

1. The Animated Counter widget's Content tab.
2. A row of counters with icons, numbers, and titles.

== Changelog ==

= 1.1.1 =
* Fixed the Animated Counter's Left/Center/Right Alignment control — it was setting an invalid CSS value (align-items does not accept "left"/"right"), so clicking Left or Right had no visible effect. Alignment now works correctly.

= 1.1.0 =
* Added a second widget: Animated Progress Bar — a titled card with a horizontal gradient bar that fills from 0 to a set percentage, with the same scroll-trigger animation as the counter.

= 1.0.0 =
* Initial release: count-up animation, icon, title, scroll-trigger, prefix/suffix, decimal places, thousands separator, and full color/typography controls.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
