Chris Reynolds

<p>This plugin does one thing: it creates a simple (but nice-looking) CSS3 progress bar that you can style with your own CSS and use wherever you want with a simple shortcode. Now with support for custom colors and gradients.</p>
<p>To add a progress bar to a post or a page, simply use this shortcode:</p>
<pre><code>[wppb progress=50]
</code></pre>
<p>where “50” in the example above is a progress bar that is 50% complete.  Simple, lightweight, cross-browser compatible (degrades nicely for browsers that don\’t support CSS3).</p>
<p>For more examples and full descriptions of all the available options, click on the <a href="https://wordpress.org/extend/plugins/progress-bar/other_notes/" rel="ugc">options tab</a>.</p>
<p>For demos of each of the options, go here: https://progressbar.jazzsequence.com</p>
<h3>Options</h3>
<p>This page describes all the available parameters for the shortcode. These can be used in any combination. The only <strong>required</strong> parameter is  <strong>progress</strong>. All parameters are case-sensitive (e.g. “progress” will work but “Progress” will not).</p>
<h4>progress (required)</h4>
<p>This determines how full the progress bar will be. Progress can be in 2 forms, either a number (0-100), in which case it will be interpreted as a percentage, or as a fraction (e.g. 25/100). Since 1.1, you can also use dollar signs (e.g. $63/$180), for example to create a fundraising progress bar. If using dollar signs, you only <em>need</em> to add a dollar sign to one or the other of the two values (e.g. 63/$180 or $63/180) — the plugin will output either option the same ($63/$180). Your progress can go over, too (e.g. 150/100 or 123%), but your mileage may vary for the display. It’s not recommended to use this with the <strong>fullwidth</strong> option, for example, because your progress will spill outside of your main body container.</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=50] A progress bar that is 50% complete

[wppb progress="50/100"] A progress bar that is 50/100 complete

[wppb progress="$45/$50"] A dollar value progress bar that is $45/$50 complete

[wppb progress=110] A progress bar that has gone over 100%

[wppb progress=150/100] A progress bar that has exceeded its goal

[wppb progress=$125/100] A fundraising-style progress bar that has exceeded the goal
</code></pre>
<h4>option</h4>
<p>This adds one of several supported options to the progress bar. For those that know CSS, new “options” can be added simply by adding new styles to your style.css. See the <a href="https://wordpress.org/support/plugin/progress-bar/faq/" rel="ugc">Frequently Asked Questions</a> page for more information on creating new CSS classes. Options can be combined by wrapping them in quotes in the shortcode. The progress bar will naturally have an inner shadow applied to it. The <code>flat</code> option was added to remove the shadow and display a “flat” color, best when used in conjunction with the <code>color</code> parameter.</p>
<p>Supported values: candystripe, animated-candystripe, red, orange, green, yellow, flat</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=50 option=red] Displays a red progress bar

[wppb progress=50 option="animated-candystripe green"] Displays a green progress bar with an animated candystripe

[wppb progress=50 option="candystripe orange"] Displays an orange progress bar with a static candystripe

[wppb progress=50 option=candystripe] Displays a default progress bar (blue) with a static candystripe

[wppb progress=50 option=flat color=red] Displays a red progress bar with no inner shadow or gradient

[wppb progress=50 option="flat candystripe" color=gray] Displays a gray progress bar with no inner shadow or gradient and a static candystripe
</code></pre>
<h4>location</h4>
<p>Displays the percentage, text or fraction either inside or outside the progress bar.<br />
<em>Note:</em> It is <em>not</em> recommended to use <code>location=after</code> if you are displaying a progress bar that exceeds its goal.</p>
<p>Supported values: inside, after</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=50 option=red location=after] Displays a red progress bar with the progress displayed to the right of the progress bar.

[wppb progress=50 option="red candystripe" location=inside] Displays a red progress bar with a static candystripe and the progress displayed inside the progress bar.

[wppb progress=85 location=after text="foo"] Displays a progress bar with the text "foo" displayed after the progress bar.
</code></pre>
<h4>text</h4>
<p>Displays arbitrary text instead of the progress bar. Can be used with the <strong>location</strong> parameter to define whether the text appears inside or outside the progress bar (default is inside). <em>Must</em> be used inside double quotes. HTML code is stripped from the final output.</p>
<p>Supported values: any plain text string</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=75 text="My awesome text"] Displays "My awesome text" inside a 75% progress bar.

[wppb progress=85 location=after text="foo"] Displays "foo" after an 85% progress bar

[wppb progress=85 location=inside text="hello!"] Displays "hello!" inside an 85% progress bar (note, default location for text is inside, so it isn't required to specify "inside").
</code></pre>
<h4>fullwidth</h4>
<p>Makes the progress bar take up 100% of the container. (Good for responsive layouts.) <em>Not</em> recommended for progress bars that exceed their goal.<br />
<em>Note:</em> As of 2.2.4, <code>fullwidth</code> will <em>only take truthy</em> values. Previously, it would accept any value, e.g. <code>fullwidth=foo</code> would output the same as <code>fullwidth=true</code>. This is no longer the case.</p>
<p>Supported value: true</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=50 fullwidth=true] Displays a full-width (responsive) progress bar

[wppb progress=50 fullwidth=foo] Identical to the above progress bar
</code></pre>
<h4>color</h4>
<p>Defines a color for the progress bar. This is useful for creating new progress bar colors on the fly without having to edit CSS. Cannot be used in conjunction with any of the pre-existing color options (red, yellow, orange or green).</p>
<p>Supported values: any hexadecimal color value, any rgb/rgba color value, any css-supported <a href="http://www.w3schools.com/cssref/css_colornames.asp" rel="nofollow ugc">color name</a></p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=50 color=rgb(123,50,87)]

[wppb progress=55 color=rgba(123,64,99,0.3)]
</code></pre>
<p><em>Note:</em> Since the background color for the progress bar is dark gray, any opacity applied to the rgba color will make the color darker, since it’s adding to the dark gray background.</p>
<pre><code>[wppb progress=22 color=#ff3257]

[wppb progress=68 color=lightYellow]
</code></pre>
<h4>endcolor</h4>
<p>Defines an end color for a custom gradient when used with <strong>color</strong>.</p>
<p>Supported values: any hexadecimal color value, any rgb/rgba color value, any css-supported <a href="http://www.w3schools.com/cssref/css_colornames.asp" rel="nofollow ugc">color name</a></p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=72 color=turquoise endcolor=teal]

[wppb progress=83 color=#ff2222 endcolor=#ff9984]

[wppb progress=50 color=rgb(203,96,179) endcolor=rgb(173,18,131)]
</code></pre>
<h4>gradient</h4>
<p>Determines an end-color on the fly for a gradient based on the <strong>color</strong> parameter. As such, <strong>gradient</strong> <em>requires</em> <strong>color</strong> to be present, otherwise the color and gradient will be set to the default color (blue). Cannot be used in conjunction with any of the pre-existing color options (red, yellow, orange or green). When using <code>gradient</code> the <strong>color</strong> value <em>must</em> be in hexadecimal form.</p>
<p>Supported values: any positive or negative decimal value from 0.0 to 1.0 or -1.0.</p>
<p><em>Examples</em></p>
<pre><code>[wppb progress=22 color=#ff0000 gradient=0.2] Displays a red progress bar that gets lighter at the bottom

[wppb progress=22 color=#ff0000 gradient=-0.2] Displays a red progress bar that gets darker at the bottom
</code></pre>
<p><strong>This does not work:</strong></p>
<pre><code>[wppb progress=34 color=rgb(22,18,99) gradient=0.2]
</code></pre>


Progress Bar

A simple progress bar shortcode that can be styled with CSS

Freemius

Ben Roberts

<p>Ultimeter uses a simple shortcode, widget or block, to display a choice of different meters (a thermometer and a progress bar in the Lite version, with three more added in the Pro version). It then allows you to choose between percentage or currency units (with heaps more metrics in the Pro version). You can specify the total (goal) amount, as well as the total raised (progress) amount. You can even choose the colour of the meter, to keep it in line with your own styles.</p>
<h3>Features</h3>
<ul>
<li>Choice of 3 meters</li>
<li>Change the colours to suit your branding</li>
<li>Control alignment and size</li>
<li>Set goal and current values</li>
<li>Choice of either percentage or currency units</li>
<li>Automatic formatting of currency values</li>
<li>Choice of currency unit</li>
<li>Duplicate meters easily</li>
<li>Multiple meters per page or site</li>
<li>Insert using a shortcode or a block</li>
</ul>
<h3>Pro Features</h3>
<ul>
<li>Many more meter designs, including a radial meter, a vertical progress bar, and a range of inline and text-based meters.</li>
<li>A third measurement unit with custom values – takes a singular and plural form, i.e. boxes, bags etc.</li>
<li>Ability to add custom CSS to make even more style changes.</li>
<li>A new set of Infinite Meters that count up indefinitely.</li>
<li>The ability to upload your own image to use as a meter. This could be a photo, or your company logo.<br />
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/kRq5_a8q8kI?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></li>
<li>Heaps more styling options, such as the ability to color the progress and goal labels, as well as your milestones.</li>
<li>Add milestones to your meters, to proudly display key points in your progress.<br />
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/OehM4Jyd5MQ?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></li>
<li>Track WooCommerce sales progress. Pick a product, and the Ultimeter will display the all-time gross sales figure.</li>
<li>Fully integrated with GiveWP. Pick a GiveWP form to track, and display your fundraising progress using any Ultimeter.</li>
<li>Fully integrated with Charitable Fundraising Plugin. Pick a Charitable Campaign to track, and display your fundraising progress using any Ultimeter.</li>
<li>Fully integrated with Gravity Forms. Pick a form to track, and display the total payments or number of entries.</li>
<li>Fully integrated with Fluent Forms. Pick a form to track, and display the number of form submissions.</li>
<li>A growing collection of WordPress hooks to allow you to configure more of your meter’s content.</li>
<li>Track data from any compatible plugin or external data source via an API.</li>
<li>Celebrations – add an exciting animation when you reach your target.</li>
<li>‘Boost’ your progress by a user-specified amount. Great for adding offline payments to donation campaigns.</li>
<li>Use our Zapier integration to connect Ultimeter to 2000+ other applications. Ultimeter can now track (nearly) everything!</li>
<li>Real-time updating. No need to refresh the page. Your meters will adjust their progress dynamically (Enterprise Edition)<br />
<span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/7uzYrp6fVSU?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></li>
</ul>
<p>Plus:<br />
* Regular updates<br />
* Our awesome email and personal support</p>
<p>To see all the Pro Features, head to the <a href="https://ultimeter.app" rel="nofollow ugc">plugin homepage</a> and then compare our <a href="https://ultimeter.app/pricing" rel="nofollow ugc">simple and affordable plans</a>.</p>


Ultimeter

Ultimeter - the Ultimate Progress and Goals Meter

Progress Bar vs Ultimeter