=== Universal Unit Converter: Convert Length, Weight, Temperature, Speed, and Time ===
Contributors: awordpresslife, razipathhan, hanif0991, muhammadshahid, fkfaisalkhan007, sharikkhan007, zishlife, FARAZFRANK
Donate link: https://paypal.me/awplife
Tags: unit converter, calculator, measurement, length and weight, temperature and speed
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Universal unit converter with 7 templates. Real-time conversion for length, weight, temperature, volume, area, speed, time, and data units.

== Description ==

**Universal Unit Converter** is a WordPress plugin that adds a beautiful, fully-featured unit conversion widget to your website. With 7 stunning template designs and 8 conversion categories, your visitors can quickly convert between different units of measurement.

The plugin is designed with modern aesthetics and smooth functionality in mind. Whether you run an educational site, a science blog, or any website where unit conversions are helpful, this plugin provides an elegant solution.


= What Does Universal Unit Converter Do? =

This plugin provides a complete unit conversion solution with:

* **8 Conversion Categories** - Length, Weight, Temperature, Volume, Area, Speed, Time, and Data
* **7 Beautiful Templates** - Minimal, Dashboard, Gradient, Neumorphism, Floating, Glass, and Split
* **Real-time Conversion** - Results update instantly as you type
* **Responsive Design** - Works perfectly on desktop, tablet, and mobile

= Who Can Benefit From This Plugin? =

**Educational Websites**: Help students convert units for homework and learning.

**Science & Engineering Blogs**: Provide useful conversion tools for your readers.

**Cooking & Recipe Sites**: Let visitors convert cooking measurements easily.

**Fitness & Health Sites**: Convert weight and measurement units for workouts and nutrition.

**Travel & International Sites**: Help users convert between metric and imperial systems.

= Quick Setup Guide =

1. Install and activate the plugin through your WordPress dashboard
2. Navigate to "Unit Converter" in your admin menu
3. Configure the appearance and behavior options
4. Copy the shortcode `[AWL_converter]`
5. Paste the shortcode into any page, post, or widget area

That's it. Your unit converter is ready to use.

== Universal Unit Converter Features ==

= 8 Conversion Categories =
* **Length** - Millimeters, Centimeters, Meters, Kilometers, Inches, Feet, Yards, Miles
* **Weight** - Milligrams, Grams, Kilograms, Metric Tons, Ounces, Pounds, Stones
* **Temperature** - Celsius, Fahrenheit, Kelvin
* **Volume** - Milliliters, Liters, Gallons, Quarts, Pints, Cups, Fluid Ounces
* **Area** - Square mm/cm/m/km, Hectares, Acres, Square ft/yd
* **Speed** - Meters/sec, km/hour, Miles/hour, Feet/sec, Knots
* **Time** - Milliseconds, Seconds, Minutes, Hours, Days, Weeks, Months, Years
* **Data** - Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits

= 7 Beautiful Templates =
Each template offers a unique visual style:

* **Minimal** - Clean sidebar navigation design
* **Dashboard** - Dark theme with horizontal navigation
* **Gradient** - Colorful gradient design with modern aesthetics
* **Neumorphism** - Soft UI design with subtle shadows
* **Floating** - Modern floating cards layout
* **Glass** - Frosted glassmorphism effect
* **Split** - Two-column side-by-side layout

= Real-time Conversion =
Results update instantly as users type, providing immediate feedback without page reloads.

= Fully Responsive =
The converter adapts to any screen size - desktop, tablet, or mobile phone.

= Customization Options =
* Show/hide widget title
* Adjustable border radius
* Configurable decimal places (0-8)
* Number format options (Standard, Scientific, Compact)
* Enable/disable conversion formula display
* Keyboard shortcuts (Enter to swap, Escape to clear)
* Click-to-copy result functionality

= Shortcode Support =
Use flexible shortcode options:
* `[AWL_converter]` - Display with default settings
* `[AWL_converter template="glass"]` - Use specific template
* `[AWL_converter category="weight"]` - Default to specific category
* `[AWL_converter template="split" category="temperature"]` - Combine options

= Widget Ready =
Add the converter to any sidebar or widget area using the included WordPress widget.

= Self-Hosted Icons =
All icons are self-hosted using an optimized SVG sprite - no external dependencies.

= Optimized Performance =
Lightweight code with minified CSS and JavaScript for fast page loads.

== Screenshots ==

1. Minimal template - Clean sidebar navigation
2. Dashboard template - Dark theme design
3. Gradient template - Colorful modern style
4. Neumorphism template - Soft UI design
5. Floating template - Unique design
6. Glass template - Frosted glass effect
7. Split template - Two-column layout
8. Admin Dashboard settings page
9. Universal Unit converter live preview on website

== Installation ==

= From WordPress Dashboard =
1. Go to Plugins > Add New
2. Search for "Universal Unit Converter"
3. Click Install Now, then Activate
4. Find Unit Converter in your admin menu

= Manual Installation =
1. Download the plugin zip file
2. Extract and upload the `hash-converter` folder to `/wp-content/plugins/`
3. Activate through the Plugins menu
4. Configure settings in Unit Converter menu

== Frequently Asked Questions ==

= How do I put the converter on my website? =
Use the shortcode `[AWL_converter]` on any page or post.

= Can I hide specific features like length, weight, temperature, volume, area, speed, time, or data? =
Yes. You can toggle any of these choices in the settings.

= Is this unit converter friendly for mobile users? =
Yes. The plugin adapts to any screen size automatically.

= Can I set a custom decimal place limit? =
Yes. You can change this in the plugin settings dashboard.

== Changelog ==

= 1.2.0 =
* Added: New shortcode prefix `[AWL_converter]` for better brand consistency
* Added: Backward compatibility for the original `[converter]` shortcode
* Added: Shortcode slug reference tables (Templates and Categories) in admin settings
* Fixed: Live preview bug where user selections were saved to localStorage
* Fixed: Shortcode category override (specified categories are now always enabled for that instance)
* Improved: Case-insensitivity for shortcode attributes (`category="Speed"` now works)
* Improved: Admin header now displays current plugin version clearly
* Tested: WordPress 6.9 compatibility

= 1.1.0 =
* Fixed decimal output formatting issues.
* Improved layout responsive CSS rules.