{"id":43304,"date":"2016-04-20T05:09:13","date_gmt":"2016-04-20T05:09:13","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/jkl-unit-converter\/"},"modified":"2016-04-20T05:09:13","modified_gmt":"2016-04-20T05:09:13","slug":"jkl-unit-converter","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/jkl-unit-converter\/","author":14074821,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"trunk","tested":"4.5.33","requires":"3.5","requires_php":"","requires_plugins":"","header_name":"JKL Unit Converter","header_author":"Aaron Snowberger","header_description":"","assets_banners_color":"3c3832","last_updated":"2016-04-20 05:09:13","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=567MWDR76KHLU","header_plugin_uri":"https:\/\/github.com\/jekkilekki\/plugin-jkl-unit-converter","header_author_uri":"http:\/\/www.aaronsnowberger.com","rating":0,"author_block_rating":0,"active_installs":80,"downloads":3707,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1399908","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1399908","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"1399908","resolution":"1544x500","location":"assets"},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"1399908","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1399908","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1399908","resolution":"2","location":"assets"}},"screenshots":{"1":"Unit Converter loaded in a Page via the shortcode","2":"Unit Converter Widget"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[529,527,80,12664,162],"plugin_category":[43,52,59],"plugin_contributors":[90387],"plugin_business_model":[],"class_list":["post-43304","plugin","type-plugin","status-publish","hentry","plugin_tags-content","plugin_tags-custom","plugin_tags-shortcode","plugin_tags-units","plugin_tags-widget","plugin_category-customization","plugin_category-performance","plugin_category-utilities-and-tools","plugin_contributors-jekkilekki","plugin_committers-jekkilekki"],"banners":{"banner":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/banner-772x250.png?rev=1399908","banner_2x":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/banner-1544x500.png?rev=1399908","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/icon-128x128.png?rev=1399908","icon_2x":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/icon-256x256.png?rev=1399908","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/screenshot-1.png?rev=1399908","caption":"Unit Converter loaded in a Page via the shortcode"},{"src":"https:\/\/ps.w.org\/jkl-unit-converter\/assets\/screenshot-2.png?rev=1399908","caption":"Unit Converter Widget"}],"raw_content":"<!--section=description-->\n<p>I'm an American expat in South Korea so I find I'm constantly wanting to convert \nbetween various units of measurement for different things. My family talks to me \nover Skype in Fahrenheit; recipes online call for 8 ounces of something; and I always \nwondered what various Korean house sizes and floor plans (pyoung) actually were in\nsquare meters or square feet.<\/p>\n\n<p>Well now, I've created just the plugin to take care of all of those kinds of \nconversions. It currently includes functions for 14 different conversion formulas \n(like length, weight, temperature, speed, etc), but there are plans for about 20 \nmore! (For a full list of conversion formulas and units, see the plugin NOTES \nsection below.)<\/p>\n\n<p>This plugin was inspired by Google's Unit Converter and includes the majority of \nthe units <a href=\"https:\/\/support.google.com\/websearch\/answer\/3284611?hl=en-KR#unitconverter\">listed on their website<\/a> \n(including some extra silly ones I've found and a handful of Korea specific units \nof measurement).<\/p>\n\n<p>Requires WordPress 3.5 and PHP 5.4 or later.<\/p>\n\n<h4>Special Features<\/h4>\n\n<ul>\n<li>Provides varying levels of complexity for conversion lists (Basic - 6 types, \nDefault - 14 types)<\/li>\n<li>Provides a default list of the most common units for each list, but also a checkbox \nto enable ALL unit types (including some obscure ones from ancient history and fiction)<\/li>\n<li>Lists values are dynamically controlled with JavaScript so that as soon as you \nchange list types, the units of measurement are immediately switched (without page \nrefresh)<\/li>\n<\/ul>\n\n<h4>Notes<\/h4>\n\n<ul>\n<li>Multiple widgets are allowed at once (on the same Post\/Page)<\/li>\n<li>Multiple shortcodes (on the same Post\/Page) are disabled - multiple shortcodes\nwill display only ONE form<\/li>\n<li>On Posts\/Pages with a shortcode, the widget will be disabled<\/li>\n<\/ul>\n\n<h4>Planned Upcoming Features<\/h4>\n\n<ul>\n<li>AJAX form submission to prevent page reload<\/li>\n<li>An Advanced List of conversion formulas - 32 types<\/li>\n<li>More conversion units supported<\/li>\n<li>Possibly allow users to select whether or not to display multiple forms in shortcodes\nand\/or widgets <\/li>\n<\/ul>\n\n<h4>Translations<\/h4>\n\n<ul>\n<li>English (EN) - default<\/li>\n<li>Korean (KO) - upcoming<\/li>\n<\/ul>\n\n<p>If you want to help translate the plugin into your language, please have a look \nat the <code>.pot<\/code> file which contains all definitions and may be used with a [gettext] \neditor.<\/p>\n\n<p>If you have created your own language pack, or have an update of an existing one, \nyou can send your [gettext .po or .mo file] to me so that I can bundle it in the\nplugin.<\/p>\n\n<h4>Contact Me<\/h4>\n\n<p>If you have questions about, problems with, or suggestions for improving this \nplugin, please let me know at the <a href=\"http:\/\/wordpress.org\/support\/plugin\/jkl-unit-converter\">WordPress.org support forums<\/a><\/p>\n\n<p>Want updates about my other WordPress plugins, themes, or tutorials? Follow me \n<a href=\"http:\/\/twitter.com\/jekkilekki\">@jekkilekki<\/a><\/p>\n\n<h4>Support<\/h4>\n\n<p><a href=\"https:\/\/wordpress.org\/support\/plugin\/jkl-unit-converter\">Click here to visit the forum for this plugin<\/a><\/p>\n\n<h4>Acknowledgements<\/h4>\n\n<p>This plugin uses:<\/p>\n\n<ul>\n<li>A similar list of units as those <a href=\"https:\/\/support.google.com\/websearch\/answer\/3284611?hl=en-KR#unitconverter\">on the Google website<\/a> <\/li>\n<\/ul>\n\n<h4>License<\/h4>\n\n<p>This program is free software; you can redistribute it and\/or modify it under the terms \nof the GNU General Public License as published by the Free Software Foundation; either \nversion 2 of the License, or (at your option) any later version.<\/p>\n\n<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY \nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A \nPARTICULAR PURPOSE. See the GNU General Public License for more details.<\/p>\n\n<p>You should have received a copy of the GNU General Public License along with this \nprogram; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth \nFloor, Boston, MA 02110-1301 USA<\/p>\n\n<!--section=installation-->\n<h4>Automatic installation<\/h4>\n\n<ol>\n<li>Log into your WordPress admin<\/li>\n<li>Go to <code>Plugins -&gt; Add New<\/code><\/li>\n<li>Search for <code>JKL Unit Converter<\/code><\/li>\n<li>Click <code>Install Now<\/code><\/li>\n<li>Activate the Plugin<\/li>\n<\/ol>\n\n<h4>Manual installation<\/h4>\n\n<ol>\n<li>Download the Plugin<\/li>\n<li>Extract the contents of the .ZIP file<\/li>\n<li>Upload the contents of the <code>jkl-unit-converter<\/code> directory to your <code>\/wp-content\/plugins<\/code> \nfolder of your WordPress installation<\/li>\n<li>Activate the Plugin from the <code>Plugins<\/code> page<\/li>\n<\/ol>\n\n<h4>Documentation<\/h4>\n\n<p>Full documentation of the Plugin and its uses can (currently) be found at its \n<a href=\"https:\/\/github.com\/jekkilekki\/plugin-jkl-unit-converter\">GitHub page<\/a><\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Tips<\/dt>\n<dd><p>As a general rule, it is always best to keep your WordPress installation and all \nThemes and Plugins fully updated in order to avoid problems with this or any other \nThemees or Plugins. I regularly update my site and test my Plugins and Themes with\nthe latest version of WordPress.<\/p><\/dd>\n<dt>How can I change the style of the plugin to match my website?<\/dt>\n<dd><p>Each element within the <code>conversion_form<\/code> contains its own unique CSS identifier, \nallowing you to hook into those in your own Custom CSS stylesheet.<\/p>\n\n<p>To easily find out which classes control which elements, simply open your site in \na modern browser (Google Chrome, Firefox, Opera, or Internet Explorer 9 or later) \nand right-click on the element you wish to style. Then find <code>Inspect<\/code> in the pop-up \ncontextual menu.<\/p><\/dd>\n<dt>Why don't the lists show units immediately upon page load?<\/dt>\n<dd><p>The unit lists are dynamically controlled by JavaScript (which loads at the end \nof the page load). So, if your site has large images or other things that cause \nthe page to load more slowly than usual, this will also cause the script to load \nlater and delay the appearance of unit options in the select dropdowns.<\/p><\/dd>\n<dt>Why doesn't the Sidebar Widget also show up on a Page using the shortcode?<\/dt>\n<dd><p>Simple: it's best to not allow TWO separate instances of the Unit Converter \nto run on the same page. It's overkill. You only need one per page. The same is \ntrue for multiple shortcodes on one page. Only ONE instance of the Unit Converter\nshould be used on any one Page.<\/p><\/dd>\n<dt>Why does my Page reload every time I click the Convert button?<\/dt>\n<dd><p>There is currently no AJAX functionality implemented by this plugin to maintain\nthe state of the Page and dynamically calculate and show the answer without a \nreload. This is a planned feature for an upcoming release.<\/p><\/dd>\n<dt>Why do I have to scroll down the Page to see my results after conversion?<\/dt>\n<dd><p>Currently, the plugin doesn't remember your page position when you submit the \nconversion form, so because the form completely reloads the page, it thinks this \nis the first time you're loading, so it will load to the top of the page.<\/p>\n\n<p>Remembering page position is a planned upcoming feature, but it will be \nunnecessary if\/when I implement dynamic calculations with AJAX.<\/p><\/dd>\n<dt>Why do some of the Unit Converter fields appear out of place?<\/dt>\n<dd><p>For the most part, it depends on how your Theme styles those elements. I did my \nbest to style the form very simply and plainly, but some elements may appear out\nof place in your installation due to your Theme's default styles. In order to fix\nthis, add some Custom CSS (preferrably using Jetpack's Custom CSS feature, or \nanother that doesn't require modifying the Theme or Plugin files).<\/p>\n\n<p>See the first question above for more info on how to do create Custom CSS for the plugin.<\/p><\/dd>\n<dt>Can you ADD \/ REMOVE \/ CHANGE features of the plugin?<\/dt>\n<dd><p>Sure, I'm always open to suggestions. Let me know what you're looking for. Feel\nfree to open a GitHub Issue on the <a href=\"https:\/\/github.com\/jekkilekki\/plugin-jkl-unit-converter\">plugin repository<\/a>\nto let me know the specific features or problems you're having.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"A simple Unit Converter widget that allows you to between various units. (Inspired by Google&#039;s Unit Converter.)","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/43304","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=43304"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jekkilekki"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=43304"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=43304"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=43304"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=43304"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=43304"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=43304"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}