WordPress.org

Plugin Directory

Jellyfish Counter Widget

Show eye catching totals with static or animated counter widgets and shortcodes. Classic retro odometer style or easy customise your own custom look.

Usage

Widget

Simply drag a counter widget to your sidebar and adjust the settings to suit your needs.

There are three basic modes of operation:

  • Static - If you want the counter to simply display a non animated number just set a Start Value to the desired number for the counter and set the Counter Type to 'static'

  • Animated – If you supply both start value and end value in the widget, the counter will increment upwards or downwards depending on the chosen Counter Type until it reaches the end value. Speed of the count is controlled by the Animation Speed option. Note, this counter has no memory, it will reset when a page is reloaded or changed but it is great for a visual effect where start and end values are relatively close together.

  • Continuous – If you want to count over a long period of time and need your counter to continue to count irrespective of page loads then just select the continuous option in the widget. Then choose the interval between the counter increments, in seconds. As soon as you save the widget the counter will "start" and will continue to tick away even if nobody is viewing your blog. Changing the setting on an active continuous counter will not effect the count value and it will keep count, if you wish to reset an active continuous counter just change the start value and save the widget and the counter will restart from the new starting value. Note: In continuous mode, animation speed and display tenths have no effect.

The counters are very configurable through the widget panel. You can define the digit height, width and font as well as animation speed (animated mode only) and "bustedness" (odometer style misalignment of the digits).

You can further customise the appearance of an individual counter via the "Digit Style" input that will accept a valid CSS style attributes such as font-family, colour, background etc.

Note: the size of the font here as is automatically calculated from the height, width and padding settings.

Need a flat looking counter? "Disable 3D effect" removes the CSS shading effect.

If you want to display a prefix on the counter or include separating characters, use the Format input. Just enter a string here representing your desired counter appearance, a 0 represents a counter digit, any other character will be displayed as it is. The Format option overrides the number of digits option, if a format string exists then the counter will use the total number of 0 characters as the number of digits.

Example Formats:

$0.00

1,000,000

0000 km

Shortcode

You can generate a counter directly within page or post content using the [jellyfish_counter] shortcode. The shortcode accepts a full range of parameters to provide identical functionality to the widget version.

The following parameters may be used within a shortcode:

  • digits : a number, Number of digits in the counter
  • format : a string, representing any fancy display format
  • tenths : true/false, display tenths digit or not
  • digit_height : number, pixel height of digits
  • digit_width : number, pixel width of digits
  • digit_padding : number, pixel padding for digits
  • digit_style : a string, custom css styles for the digits
  • alignment : 'left', 'center', 'right', 'inline' overall counter alignment
  • bustedness : a number, misalignment of digits
  • flat : true/false, don't show 3d effect, show 3d effect
  • speed : a number, 0 - 100, animation speed
  • start : a number, starting value for the counter
  • end : a number, ending value for the counter
  • direction : a, string 'up' or 'down'
  • interval : The number of seconds between updates of a continuous counter
  • timestamp : false or a string representing the starting time for the counter

If you don't specify a parameter it's default value will be used.

Examples:

[jellyfish_counter end=100]

The above shortcode translates as: Display a counter that animates upwards from 0 to 100

[jellyfish_counter start=999 end=0 direction="down" digit_style="background: transparent; color: red;" flat=true; timestamp="2014-09-28 9:20:21" interval=300 ]

The above shortcode translates as: Display a counter that starts at 999 and ends at 0, counting downwards. It has red digits on a transparent background with no 3D shading effect. It is a persistent counter that started counting at 9:20:21 on 2014-09-28 and has been decrementing by one every 300 seconds (5 minutes) since then.

Styling

You can modify the appearance of an individual counters text through the widget control panel or through shortcode parameters. This should be sufficient for most uses.

However, if you need to globally override the default counter style or make other CSS changes to the counter digits or container, take a look at jellyfish-counter.css for the appropriate class names. You should override this in you theme rather than modifying this css file as any changes made would be lost when the plugin upgrades..

Requires: 3.0 or higher
Compatible up to: 4.1.5
Last Updated: 2015-2-1
Active Installs: 4,000+

Ratings

4.8 out of 5 stars

Support

4 of 8 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1