Liquid Fill Gauge

Liquid Fill Gauge

This is a gauge plugin for WordPress, to create beautifully animated gauges or progress bars with a circular design. A set of 23 shortcode attributes are available to customize the gauge. Every gauge is rendered as a seperate SVG element and you can insert multiple gauges on the same page.

These are the available shortcode attributes to customize a gauge (default values between brackets):

  • value (50): The current value of the gauge.
  • width (200px): The width of the gauge.
  • height (200px): The height of the gauge.
  • minvalue (0): The gauge minimum value.
  • maxvalue (100): The gauge maximum value.
  • circlethickness (0.05): The outer circle thickness as a percentage of it’s radius.
  • circlefillgap (0.05): The size of the gap between the outer circle and wave circle as a percentage of the outer circles radius.
  • circlecolor (#178BCA): The color of the outer circle.
  • waveheight (0.05): The wave height as a percentage of the radius of the wave circle.
  • wavecount (1): The number of full waves per width of the wave circle.
  • waverisetime (1000): The amount of time in milliseconds for the wave to rise from 0 to it’s final height.
  • waveanimatetime (1000): The amount of time in milliseconds for a full wave to enter the wave circle.
  • waverise (true): Control if the wave should rise from 0 to it’s full height, or start at it’s full height.
  • waveheightscaling (true): Controls wave size scaling at low and high fill percentages. When true, wave height reaches it’s maximum at 50% fill, and minimum at 0% and 100% fill. This helps to prevent the wave from making the wave circle from appear totally full or empty when near it’s minimum or maximum fill.
  • waveanimate (true): Controls if the wave scrolls or is static.
  • wavecolor (#178BCA): The color of the fill wave.
  • waveoffset (0): The amount to initially offset the wave. 0 = no offset. 1 = offset of one full wave.
  • textvertposition (0.5): The height at which to display the percentage text withing the wave circle. 0 = bottom, 1 = top.
  • textsize (1): The relative height of the text to display in the wave circle. 1 = 50%
  • valuecountup (true): If true, the displayed value counts up from 0 to it’s final value upon loading. If false, the final value is displayed.
  • displaypercent (true): If true, a % symbol is displayed after the value.
  • textcolor (#045681): The color of the value text when the wave does not overlap it.
  • wavetextcolor (#A4DBf8): The color of the value text when the wave overlaps it.

Here is a fully functional shortcode with all available attributes:

[liquidgauge value=”53” width=”200px” height=”200px” minvalue=”0” maxvalue=”100” circlethickness=”0.05” circlefillgap=”0.05” circlecolor=”#178BCA” waveheight=”0.05” wavecount=”1” waverisetime=”1000” waveanimatetime=”1000” waverise=”true” waveheightscaling=”true” waveanimate=”true” wavecolor=”#178BCA” waveoffset=”0” textvertposition=”0.5” textsize=”1” valuecountup=”true” displaypercent=”true” textcolor=”#045681” wavetextcolor=”#A4DBf8”]

Date: October 1, 2015