=== Counters Block – Animated Number Counters, Stats & Dynamic KPIs ===
Contributors: bplugins, abuhayat, charlescormier, asadsuzan, freemius
Donate link: https://www.buymeacoffee.com/abuhayat
Tags: block, counter, animated counter, stats, woocommerce
Requires at least: 6.5+
Tested up to: 7.0
Stable tag: 2.0.7
Requires PHP: 7.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Display animated number counters, live WooCommerce sales, and WordPress stats in real-time with this high-performance Gutenberg block.

== Description ==

**Counters Block** is the ultimate Gutenberg tool for displaying statistics, milestones, and achievements with professional animated number counters. 

Whether you're building a business landing page, a portfolio, or a high-converting dashboard, this block helps you showcase social proof and key metrics in a way that captures attention and builds trust.

[**Counters Block**](https://bplugins.com/products/counters-block/) | [**Pricing**](https://bplugins.com/products/counters-block/pricing) | [**Support**](https://bplugins.com/support/) | [**Demos**](https://bblockswp.com/demo/counters-block-all/)

### 🚀 NEW: Dynamic Data Integration (Premium)
Stop manual updates! Counters Block can now automatically fetch and display live data from your site:

- **WooCommerce Stats:** Display total Sales, Order Count, Product Count, and Total Customers (Registered + Guests).
- **WordPress Core Stats:** Automatically show total Posts, Pages, Comments, and User counts.
- **HPOS Ready:** Fully compatible with WooCommerce High-Performance Order Storage.

### 🎨 Stunning Designs & Animations
With 16 modern counter layouts (including the new **Circular Progress Counter**), powerful animation triggers, and full responsive controls, you have complete creative freedom without touching a single line of code.



==💡 Perfect For:==
- **E-commerce:** Live sales counters & happy customer stats.
- **Agency/Business:** Project milestones & team achievements.
- **Blogs/Portfolios:** Published post/page counts & subscriber stats.
- **SaaS/Dashboards:** Real-time KPI tracking & performance metrics.

== Features ==

= 📊 Dynamic Data Sources (Premium) =
- **WooCommerce Stats:** Total Sales, Total Orders, Total Products, and Total Customers.
- **Smart Customer Counting:** Includes both registered users and guest checkouts.
- **WordPress Stats:** Total Posts, Total Pages, Total Comments, and Total Users.
- **Auto-Sync:** Data stays fresh and updates automatically.

= 🎨 Themes & Layouts =
- 16 ready-made counter themes (13 premium + 3 free)
- **NEW:** Circular Progress Counter (Theme 15)
- Multiple modern layouts with one-click theme switching
- Fully responsive grid-based layout (Desktop, Tablet, Mobile)
- Custom column and row gap control

= ✨ Advanced Number Animations =
- Classic, Rolling, Bounce, Fade, and Slide (Up/Down/Left/Right)
- Pulse, Flip, and Typewriter animations
- **Animation Triggers:** On Visible, On Page Load, On Click, On Hover, or Custom CSS Selector.
- Global & Per-Counter duration, delay, and stagger controls.

= 🔢 Number Formatting =
- Custom Prefix & Suffix support.
- Thousands separator support (Comma & Space).
- Decimal number support with smooth transitions.
- Smart Sales Formatting: Automatically handles refunds and prevents negative values.

= 🖼️ Icon & Typography =
- Custom icon support (Font Awesome, Bootstrap, Lucide).
- Responsive typography for numbers, labels, and sub-labels.
- Per-counter styling: Backgrounds, borders, shadows, and hover effects.


== Free vs Premium ==

= Free Version =
- Unlimited static counters.
- 3 professional counter themes.
- Fully responsive grid layout.
- Classic animations & icon support.
- Basic typography controls.

= Premium Version =
- **Live Dynamic Data:** WooCommerce & WP Core stats integration.
- **13 Premium Themes:** Including the Circular Progress Counter.
- **Advanced Animations:** Rolling, Bounce, Flip, Typewriter, and more.
- **Smart Formatting:** Auto-handling of sales/refunds & guest counting.
- **Priority Support:** Direct help from our development team.


== How to Use ==

1. Install and activate the **Counters Block** plugin.
2. Open any Page or Post in the Gutenberg editor.
3. Add **Counters Block** from the block inserter.
4. (Optional) Select a **Data Source** (Static, WP Core, or WooCommerce).
5. Customize themes, colors, and animations from the settings panel.
6. Publish and watch your stats come to life! 🚀


== Feedback & Support ==

Found a bug or have a feature request? We'd love to hear from you!
📧 [Send feedback](mailto:support@bplugins.com)

Support forum:  
https://wordpress.org/support/plugin/counters-block/




### 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 Editor.
2. Search For **Counters Block**.
3. Click to add and start customizing.

= Download & Upload: =
1. Download the plugin .zip file.
2. Go to Plugins > Add New > Upload Plugin.
3. Choose the file and click **Install Now**.
4. Activate and Enjoy!

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



== Frequently Asked Questions ==

= Is Counters Block free? =
Yes! The core plugin is free. Premium features like Dynamic WooCommerce/WP stats and advanced themes require a license.

= Does it support WooCommerce HPOS? =
Yes, version 2.1.0+ is fully compatible with High-Performance Order Storage.

= Can it count guest customers? =
Yes! Our smart customer counter includes both registered users and guest shoppers.

= Where can I get support? =

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



== Screenshots ==
1. Dynamic Data Sources
2. Default Counters
3. Theme 1
4. Theme 2
5. Theme 3
6. Theme 4
7. Theme 5
8. Theme 6
9. Theme 7
10. Theme 8
11. Theme 9
12. Theme 10
13. Theme 11
14. Theme 12
15. Theme 13
16. Theme 14
17. Theme 15
18. All Themes





== Changelog ==

= 2.0.7 – 28 April 2026 =
* **New Features**: Added Data Source system with multiple options (Static values, WP Core Stats, WooCommerce Stats).
* **WP Core Stats**: Support for Posts, Comments, and Users (now including Pages).
* **WooCommerce Stats**: Support for Sales, Orders, Products, and Customers (including Guest users).
* **HPOS Ready**: Fully compatible with WooCommerce High-Performance Order Storage.
* **Dynamic Data**: Introduced automatic real-time data fetching from the database.

= 2.0.6 – 7 April 2026 =
* **Fix**: Resolved license activation check issue by improving class existence validation.
* **Update**: Improved Inspector Controls for a more intuitive and user-friendly experience.

= 2.0.5 – 16 Feb 2026 =
* Update: Redesigned and modernized admin dashboard interface.

= 2.0.4 – 16 Feb 2026 =
* Fixed issues in editor-only Theme Switcher UI.
* Improved Popover-based theme switching stability.
* No frontend changes (editor-only fix).


= 2.0.3 – 7 Feb 2026 =
* Enhanced the Theme Switcher UI for the Counter block (editor-only).
* Theme selector now opens in a Popover for a cleaner experience.
* Popover automatically closes when clicking outside.
* Improved theme selection interaction and visual feedback.
* No changes to frontend output.


= 2.0.2 – 5 Feb 2026 =
*  Added Theme 15: Circular Progress Counter.
*  SVG-based animated circular progress ring.
*  Added controls for circle size, ring thickness, and line caps.
*  Added progress, track, and fill color customization.
*  Improved layout settings placement for faster theme switching.

= 2.0.1 – Minor Release =

* Ensured responsive column settings (Desktop / Tablet / Mobile) now apply correctly across the block.
* No breaking changes — existing blocks continue to work as expected.

= 2.0.0 – Major Release =
*  Added 15 counter themes (12 premium + 3 free)
*  Multiple new animation types and triggers
*  Advanced animation controls & easing options
*  Per-counter styling (background, shadow, sizing)
*  Improved Gutenberg editor experience
*  Performance and rendering optimizations

= 1.1.4 – 4 Nov 2025 =
* Fix Issues
* Update Icon Library v7.1.0

= 1.1.3 – 17 Feb 2024 =
* Improve security

= 1.1.2 – 3 Oct 2024 =
* Fix pattern issue

= 1.1.1 – 6 May 2024 =
* Add separators in the number.
* Update icon library

= 1.1.0 =
* Fix script not loaded

= 1.0.9 =
* Counter starts when visible

= 1.0.8 =
* Reduce asset loads

= 1.0.7 =
* Add translate feature

= 1.0.6 =
* Fix HTML Render

= 1.0.5 =
* Reduce PHP Code
* Performance Improvement

= 1.0.4 =
* Reduce PHP Code
* Typography fix

= 1.0.2 =
* Performance upgrade

= 1.0.1 =
* Fix text-align
* Performance Upgrade

= 1.0.0 =
* Initial Release.


== Upgrade Notice ==

= 2.0.7 =
Major Update: Dynamic stats just got smarter! 🚀 This update adds Total Pages, Comments, and Users to WP Core stats, introduces Smart Customer Counting (including Guests) for WooCommerce, and improves sales accuracy with HPOS support.


= 2.0.4 =
Fixes issues in the editor-only Theme Switcher UI.  

= 2.0.2 =
New Theme Alert! Version 2.0.2 introduces Theme 15: a fully customizable, SVG-powered Circular Progress Counter. You can now adjust ring thickness, size, and colors directly in the block settings. We've also streamlined the sidebar layout to make switching between your favorite themes faster than ever.

= 2.0.1
Fix responsive layout control

= 2.0.0 =
This is a major update with new counter themes, animation types, and settings.


