WP CountUP JS

Description

Display multiple animated counters into your WordPress site.

Gutenberg

The plugin is compatible with Gutenberg, so you can add the custom block called CountUp to your posts and pages. Check the wiki for more details.

Shortcode

It’s very easy to use this plugin, you can use the shortcode after install it, but there are two ways to use the plugin:

The first way is:

[countup start="your-value" end="your-value" decimals="your-value" duration="your-value"]

The second way. To use this format you need to check the Use the end number inside the shortcode? setting in the plugin option page:

[countup start="the-start-number" decimals="your-value" duration="your-value"]the-end-number[/countup]

Example

You can use the shortcode in two ways, as mentioned before. If you are using the first way:

[countup start="0" end="55" decimals="2" duration="5" prefix="my_prefix" scroll="false"]

If you are using the second way (remember to check the Use the end number inside the shortcode?):

[countup start="0" decimals="2" duration="5"]55[/countup]

Copy and paste any example in one of your posts and test.

Available Attributes

The shortcode and Gutenberg block accepts the next arguments:

  • decimals – Puts the desired decimals into your counter.
  • delay – Set a delay in milliseconds to start the counter.
  • duration – The counter duration represented by a number (seconds).
  • easing – Easing the counter.
  • end – A number to end (arrive) the counter.
  • grouping – Groups the content into sections (eg. 1,000 vs 1000).
  • prefix – A text as counter prefix.
  • reset – Reset the counter after view.
  • scroll – If true, start the counter when the user visualize it.
  • separator – You can use a separator (default is comma).
  • start – A number to start the counter.
  • suffix – A text as counter suffix.

Settings

You know how to use the plugin now, but you can still edit some options inside of the plugin settings page (Go to Settings->CountUP.js).

Inside of the settings page, you can find the next settings:

  • Easing: Easing the counter.
  • Grouping: Groups the content into sections (eg. 1,000 vs 1000).
  • Separator: You can use a separator (default is comma).
  • Decimal: Symbol to use for decimal spot (default is dot).
  • Prefix: Character(s) at beginning of string.
  • Suffix: Character(s) at the end of string.

Screenshots

  • Screenshot-1: Output counters on the site.
  • Screenshot-2: Shortcode example.
  • Screenshot-3: Plugin options page.
  • Screenshot-4: CountUp.js Options inside shortcode.
  • Screenshot-5: Output counters on the site with individual prefix and suffix.

Blocks

This plugin provides 1 block.

roelmagdaleno/wp-countup-js
CountUp

Installation

  1. Install the plugin via WordPress Plugin Installer.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Go to “Settings”->”CountUP.js” menu to configure options of the plugin.

Reviews

February 14, 2018
It works! Easy to use and has all the options you need, and does exactly what it is supposed to.
April 3, 2017
Hi Roel, Thanks for this plugin. Its very easy to use. However, I had a few feature requests: I want the counter to run on a decimal number. Something like 0 to 2.5 in 1 second. I tried using [countup start="0" end="2.5" decimals="1" scroll="true" duration="1"], but that ends at 25 instead of 2.5 I want a suffix, but want it in a slighly smaller size than the number. So in 2.5 Lakh, Lakh needs to be in a smaller font. If I put it outside the counter div, it goes to the next line. Is it possible to have run the counter whenever someone scrolls up and down and comes to that section? If these features are already available, pls let me know how to implement them. Thanks! Priyanka
April 1, 2017
This plugin is the only one out there that allows you to use dynamic number directly from the database by using shortcode within a shortcode. For instance [countup start="1" decimals="0" duration="5"][users_count][/countup] Thank you for adding this functionality. That person who gave you 4 stars needs to resubmit his review as it was his only reason for not giving you 5 stars! I'd give you 6 stars to cover it 😉 Thanks again!
February 11, 2017
Works perfectly! The one missing star is only because I wish I could use an ending number from outside the shortcode itself. Like... [countup start="0" duration="3"]2,500[/countup] Then I could stick some PHP in there and source the number dynamically from content. Love the plugin though. You have all the classes n'stuff you need to make this do pretty much anything you want and it's simple and light. 🙂
November 9, 2016
Finding this functionality to trigger the animation when the user scrolls to the content is tough. This works right out of the box. The newest params are so helpful. Thank you!
Read all 9 reviews

Contributors & Developers

“WP CountUP JS” is open source software. The following people have contributed to this plugin.

Contributors

Translate “WP CountUP JS” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.2.3

  • FIX: Decimal counters shows as integers instead of floats.

4.2.2

  • FIX: JavaScript file wasn’t loading properly in some posts and pages for shortcodes.

4.2.1

  • FIX: Main script was loading as type JavaScript instead of Module.

4.2.0

  • Compatible with Gutenberg. Now the plugin has its own Gutenberg Block.