Title: Units Author: Kyle Phillips Published: February 24, 2015 Last modified: August 21, 2015 --- Search plugins ![](https://ps.w.org/units/assets/banner-772x250.png?rev=1098692) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/units/assets/icon-128x128.png?rev=1098692) # Units By [Kyle Phillips](https://profiles.wordpress.org/kylephillips/) [Download](https://downloads.wordpress.org/plugin/units.1.0.2.zip) * [Details](https://pcd.wordpress.org/plugins/units/#description) * [Reviews](https://pcd.wordpress.org/plugins/units/#reviews) * [Installation](https://pcd.wordpress.org/plugins/units/#installation) * [Development](https://pcd.wordpress.org/plugins/units/#developers) [Support](https://wordpress.org/support/plugin/units/) ## Description **Why Units?** Units provides your users with an intuitive way to choose and display their preferred unit of measurement. The user’s preferred unit of measurement is saved via session, cookie, or none – configurable under the plugin settings. Any number of primary/alternate units can be added, along with their conversion formulas. Visit [unitswitcher.com](http://unitswitcher.com) for more detailed information. **Using Units** Add primary units under Settings > Units. Alternate units may be added by providing their name and conversion formula. Multiple alternate units may be added for each primary unit. Use the function `unit_switcher($value, $primaryunit, $round)` in your template to display the switcher. Pass the stored value as the first parameter and primary unit of measurement as the second value. To display a single switcher, the shortcode [unit_switcher] is available for use. The shortcode requires two parameters: `unit` (the primary unit being converted) and `value` (the stored value). For more information visit [unitswitcher.com](http://unitswitcher.com). **Important: Unit Switcher requires WordPress version 3.8 or higher, and PHP version 5.3.2 or higher.** ### More Information #### Using the Template Function **unit_switcher($variable, $primaryunit, $round);** Parameters: * $variable – The stored value (integer or float) * $primaryunit – The primary unit (the stored value should be stored in this unit) * $round – Number of digits to round to (default is 2) Visit [unitswitcher.com](http://unitswitcher.com) for more detailed information. ## Screenshots * [[ * Display a dropdown method for users to toggle between units of measurement. * [[ * Optionally save the user’s preference via the session or cookie. * [[ * Add as many units/alternate units as needed. ## Installation 1. Upload unit-switcher to the wp-content/plugins/ directory 2. Activate the plugin through the Plugins menu in WordPress 3. Visit the plugin settings to add units of measurement 4. Use the unit_switcher() template function or [unit_switcher] shortcode to display the switcher ## FAQ Is this plugin WPML compatible? The plugin is not yet WPML compatible. How do I add a unit of measurement? Visit Settings > Unit Switcher. A primary unit of measurement is required, along with at least one alternate unit. Substitute the primary unit with `X` in the formula to equal the alternate formula. So, to set an alternate unit of `inches` for a primary unit of `feet`, the formula should be set to `X*12`. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Units” is open source software. The following people have contributed to this plugin. Contributors * [ Kyle Phillips ](https://profiles.wordpress.org/kylephillips/) [Translate “Units” into your language.](https://translate.wordpress.org/projects/wp-plugins/units) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/units/), check out the [SVN repository](https://plugins.svn.wordpress.org/units/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/units/) by [RSS](https://plugins.trac.wordpress.org/log/units/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.2 * Bug fix – conflict with Bootstrap Javascript libary resolved. #### 1.0.1 * Page caching conflicts resolved. If using a page cache plugin, visit Settings > Unit Switcher to enable the fix. * Minor bug fixes in options saving #### 1.0 * Initial release ## Meta * Version **1.0.2** * Last updated **11 years ago** * Active installations **10+** * WordPress version ** 3.8 or higher ** * Tested up to **4.3.34** * Language * [English (US)](https://wordpress.org/plugins/units/) * Tags * [localization](https://pcd.wordpress.org/plugins/tags/localization/)[measurements](https://pcd.wordpress.org/plugins/tags/measurements/) [units](https://pcd.wordpress.org/plugins/tags/units/) * [Advanced View](https://pcd.wordpress.org/plugins/units/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/units/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/units/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/units/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/units/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/units/reviews/?filter=1) [Add my review](https://wordpress.org/support/plugin/units/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/units/reviews/) ## Contributors * [ Kyle Phillips ](https://profiles.wordpress.org/kylephillips/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/units/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://unitswitcher.com/)