Donation Thermometer


‘Donation Thermometer’ uses a simple shortcode to display classic-style tracking thermometers that can blend seamlessly with your website content on any post, page or sidebar.

Individual thermometers are fully customisable, including options to change the fill/text colours, currency, size, and to set multiple raised/target values. Colour schemes and default values are controlled from the settings page, and with custom CSS rules the thermometer can match any theme style. The thermometers are rendered inline as vector-based images (SVG), producing a visually sharp graphic regardless of its size. Since the plugin does not load any remote image files your page-load times will remain fast and save bandwith for users.

Simply use the shortcode [thermometer raised=?? target=??]. Optional shortcode parameters can control thermometer width, height, tick alignment, currency, alt text, the thousands separator, currency symbol position, fill colors, or to include a legend.

The ‘raised’ and ‘target’ values are linked to independent shortcodes ([therm_r], [therm_t] and [therm_%]); useful for keeping multiple instances up-to-date around your site, for example if you want to keep a running total caption in your site footer/sidebar.


  • The Thermometer settings page.
  • Multiple thermometers displayed on a page/sidebar. Unique values and colours can be assigned for each.
  • Customisable CSS rules for thermometers.
  • The help page describing the various shortcode options and functionality.


  1. Extract and upload the contents of the zip file to the /wp-content/plugins/ directory.
  2. वर्डप्रैस के प्लगइन मेनू के द्वारा इस प्लगइन को सक्रिय करें।
  3. Configure the options from the settings page.
  4. Insert the shortcode [thermometer] into any post or page.

सामान्य प्रश्न

The [therm_r] and [therm_t] shortcodes show different values to the thermometers.

Values for these shortcodes are set on the Thermometer settings page or dashboard widget. If you want your thermometers to display the same values, remove the ‘raised’ and ‘target’ parameters from the [thermometer] shortcode, e.g. [thermometer width=300 align=right]. Values given in the shortcode will overrule those on the settings page.

Can I display the thermometer as a percentage of the page width?

Yes – just use the percentage symbol in the shortcode. For example, width=30%. As before, values can be set for Width OR height only. The default size is width=200px.

How do I use the alt parameter?

This option will change the title and alt text attributes of the thermometer image. To toggle off, type alt=off. To enter custom text, type alt=’your custom text’ (include apostrophes). If the option is left out the default text ‘Raised xxxx towards the xxxx target.’ will appear.

Can I remove the currency symbol?

Yes – select the empty option on the settings page dropdown menu, or enter currency=null in the thermometer shortcode, e.g. [thermometer currency=null].


सितम्बर 4, 2020
This plugin worked nearly perfectly. I specially liked how I could have different categories of donations be shown in the same thermometer in different colors. For my alumni site we collect three different buckets of donations: General Fund, ENdowment Fund, Scholarship Fund. I could show amounts for all three! What I would love to see is some integration with WooCommerce which we use to collect our donations where each Fund is like a product being sold. Barring that some ability to provide custom php code to determine values dynamically would be great. UPDATE: It turns out it seems like what I was wishing for is already supported! Changing my rating to 5 stars.
मई 27, 2020
Super simple yet easily customization. Adds a great visual to our donation page and now can use dynamic data which saves so much time. Thank you! We are fundraising for Service Dogs and they all send 5 wags.
सितम्बर 3, 2016
I added the code and got a ton of php errors along with the thermometer.. They went away again once I deactivated.
8 के सभी समीक्षा पढ़ें

सहायक &डेवलपर्स

यह खुला स्रोत सॉफ्टवेयर है। अनुगामी लोगो ने इस प्लगइन के लिए योगदान दिया है।


Translate “Donation Thermometer” into your language.

Interested in development?

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

बदलाव विवरण


  • Added option to include decimal places for raised/target/percentage values.
  • Fixed legend bug.


  • Fixed bug for the raised shortcode parameter.


  • Now possible to use shortcodes for the raised shortcode parameter.
  • Fixed a bug where the therm_% shortcode value calculation.


  • Modified settings field arguments and collection of default values.
  • Fixed bug where therm_% did not correctly use the cumulative total of raised values.


  • Fixed a bug where a shortcode raised value of 0 would revert to the default value.


  • Added shortcode options for changing the default colors of the raised, target, percentage and subtarget values for individual thermometers.


  • Added customisable CSS rules for further control over thermometer appearance.
  • Added a preview of the color ramp on the settings page.


  • Added options for placing sub-target labels on thermometer.
  • Added shortcode preview tab on the settings page.
  • Added ability to remove target/raised values on individual thermometers.
  • Fixed bug with thermometer text colours.
  • Fixed bug with raised value in dashboard widget.


  • Meta data bug fix


  • Major upgrade switching the thermometer to be drawn as scalable vector graphic (SVG).
  • New shortcode parameters available to include multiple categories in the thermometer.
  • A new shortcode ‘therm_%’ that states the percentage raised from the default global values.
  • Tick marks can be placed left or right.
  • Multiple target values can be set.
  • An automatically generated legend can be placed below the thermometer.
  • Clean uninstallation.


  • Fixed a minor bug extracting page id.


  • Added new dasboard widget from which raised and target values can be edited.


  • Fill colours can now be assigned for individual thermometers using the new shortcode parameter ‘fill=‘.


  • Fixed minor bug regarding centre alignment of the thermometer.


  • Fixed minor bug with default values when updating from < version 1.3.


  • Error in database changes on upgrade in 1.3.10.


  • Various backend improvements of the code and handling of errors.
  • Added more options for the thousands separator.
  • Confirmed compatibility up to WordPress 4.3.*


  • Move width and height parameters into CSS code.
  • ‘px’ units can now be defined in the shortcode, instead of having to just use a number value.


  • Fixed encoding for currency symbols in the filename.


  • Further fix to the therm_r and therm_t shortcodes.


  • Fixed an issue with the default display of the thousands separator.


  • Added an option to modify the thousands separator in the thermometer shortcode. E.g. sep=,
  • Added an option to move the position of the currency symbol to follow the target/raised value using the thermometer shortcode. E.g. trailing=true
  • Added global currency settings to the plugin options page.


  • Fixed a bug that was preventing absolute values of the width/height parameter working.


  • Added the option to use the width or height parameter value as a percentage (useful for displaying thermometers consistently across various screen sizes).


  • Bug fixed where thermometer settings were overwritten with defaults every time the plugin is reactivated/updated.
  • More efficient code used for filling the thermometer.
  • When percentage raised is greater than 100% the thermometer now fills completely.
  • Thousand’s separator added to the thermometer alt and title captions.


  • New ‘alt’ parameter for the [thermometer] shortcode: toggle the thermometer’s alt & title off, or use custom text.
  • Added option for different raised/target value text colours.
  • Fix for servers with allow_url_fopen directive set to off.
  • Added a ‘donate’ link for the developer 😉


  • New shortcodes for ‘raised’ and ‘target’ values ([therm_r] and [therm_t]).
  • Addressed memory issues concerning the generation of images.
  • A new parameter in the thermometer shortcode now allows for custom currency symbols.
  • Image width now dynamically adjusts depending on the total raised.
  • Target and percentage values change font size depending on string length.
  • Horizontal and vertical margins added to the thermometer image.


  • Improved the fail-safe that makes sure thermometers exist before page load.


  • Code improvements including for align issues, the image title text and references to file paths.


  • New Feature: Multiple thermometers with varying targets/amounts raised now possible.
  • Target/amount raised values now moved from the settings page to the shortcode parameters.
  • Included a cache feature which clears thermometer images on the server after 1 week.


  • Fixed a bug that may have stopped the thermometer appearing in Internet Explorer.
  • Helped an image resampling issue present in some browsers.


  • Custom colour option for raised/target text added.


  • Option added to use custom colours for the thermometer and percentage text.
  • Accuracy of the thermometer-fill and gauge improved to the nearest target unit.


  • Initial release.