=== Counting Number Block === Contributors: Mr2P Tags: Gutenberg, block, number, counter, animation Requires PHP: 7.0 Requires at least: 5.9 Tested up to: 7.1 Stable tag: 1.1.3 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Donate link: https://boldblocks.net?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=Counting+Number+Block+Donate This block provides an animated counter effect for numbers. It’s fast, lightweight, SEO-friendly, accessibility-ready, and fits any design. == Description == This single-block plugin makes your numbers stand out by animating them while still keeping them SEO-friendly, accessibility-ready, and respecting the reduced motion mode. The number can be counted up or down. This block performs one simple job: animating numbers. You can combine it with other blocks to fit any design. === Key features === * It can be counted up or down depending on the start value and the real value * SEO and Accessibility ready - Screen readers will read the actual number value, not the animated one. * It can be fit in any design * Highly customizable with a large range of options like duration, separator, decimal, etc. * You can animate it one time or multiple times whenever the block appears in the viewport * You can provide a prefix and/or a suffix value * The animated effect will not be shown in the reduced motion mode Please take a look at [these custom block patterns](https://boldpatterns.net/keywords/number?utm_source=wp.org&utm_campaign=readme&utm_medium=link&utm_content=Counting+Number+Block) that use this block to see how it can be applied to real-world sites. If this plugin is useful for you, please do a quick review and [rate it](https://wordpress.org/support/plugin/counting-number-block/reviews/#new-post) on WordPress.org to help us spread the word. I would very much appreciate it. ## Other plugins Please check out my other plugins if you're interested: - **[Content Blocks Builder](https://wordpress.org/plugins/content-blocks-builder)** - Build custom layouts and blocks visually in the Block Editor without needing a code editor, using only core blocks and native Gutenberg features. - **[Meta Field Block](https://wordpress.org/plugins/display-a-meta-field-as-block)** - A single block to display custom fields in the Block Editor without coding. It supports ACF, MetaBox, WooCommerce, meta, rest field, shortcode and more. Works everywhere: in the Site Editor (FSE), the Block Editor, inside Query Loop, WooCommerce Product Collection, Term Query blocks, and even in template files. - **[SVG Block](https://wordpress.org/plugins/svg-block)** - A block to display SVG images as blocks. Useful for images, icons, dividers, and buttons. It allows you to upload SVG images and load them into the icon library. - **[Icon separator](https://wordpress.org/plugins/icon-separator)** - A tiny block just like the core/separator block but with the ability to add an icon. - **[Breadcrumb Block](https://wordpress.org/plugins/breadcrumb-block)** - A simple breadcrumb trail block that supports JSON-LD structured data and is compatible with WooCommerce. - **[Block Enhancements](https://wordpress.org/plugins/block-enhancements)** - Adds practical features to blocks like icons, box shadows, transforms, etc. - **[Better YouTube Embed Block](https://wordpress.org/plugins/better-youtube-embed-block)** - A block to solve the performance issue with embedded YouTube videos. It can also embed multiple videos and playlists. The plugin is developed using @wordpress/create-block. The source code is in the trunk branch. == Installation == 1. Upload the plugin files to the `/wp-content/plugins` directory, or install the plugin through the WordPress plugins screen directly. 1. Activate the plugin through the 'Plugins' screen in WordPress == Frequently Asked Questions == = Why and when would you need this plugin? = If you want to highlight your numbers, you could use this plugin to make a counting effect. = Does it fit in my design? Absolutely! It is super simple. It only animates the number, you can put it in any layout blocks. == Screenshots == 1. Block settings == Changelog == = 1.1.3 = *Release Date - 07 May 2026* * Improved - Updated inspector control style = 1.1.2 = *Release Date - 11 February 2026* * Fixed - Delay not working * Fixed - Missing default value that caused an invalid content issue * Improved - Upgraded the CountUp script = 1.1.1 = *Release Date - 11 January 2026* * Improved - Replaced classnames with clsx * Improved - Handling of the frontend script when hosts or cache plugins defer or delay it. = 1.1.0 = *Release Date - 30 June 2024* * Improved - Support accessibility for the actual value * Improved - Don't animate the number in the reduced motion mode * Added - Support clientNavigation interactivity * Added - Allow editing content attributes from the block toolbar * Improved - Refactor the code * Updated - Tested up to WP 6.6 = 1.0.7 = *Release Date - 10 August 2023* * DEV - Add a CSS class named `is-number-animating` when it's counting * DEV - Show the `startVal` at the beginning * DEV - Refactor code = 1.0.6 = *Release Date - 22 March 2023* * DEV - Make the block animate the trailing zero in decimal places = 1.0.5 = *Release Date - 31 January 2023* * DEV - Add settings for disabling grouping, grouping separator, decimal separator * DEV - Add more typography settings * DEV - Add keywords for blocks = 1.0.4 = *Release Date - 16 October 2022* * FIX - Refactor code to allow animate the number both scroll up & down = 1.0.3 = *Release Date - 16 September 2022* * FIX - Change textdomain = 1.0.1 = *Release Date - 20 July 2022* * FIX - Allow animating decimal numbers * FIX - Animate on load = 1.0.0 = *Release Date - 13 July 2022*