=== Vareon Calculator Suite Lite ===
Contributors: vareon
Tags: calculator, loan, mortgage, savings, bmi
Requires at least: 6.3
Tested up to: 6.9
Requires PHP: 8.0
Text Domain: vareon-calculator-suite-lite
Stable tag: 1.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A collection of lightweight calculators for WordPress. Embed via blocks or shortcodes. Fast, simple, and professional.

== Description ==

Vareon Calculator Suite Lite gives you a curated set of calculators that can be embedded anywhere on your WordPress site with Gutenberg blocks or shortcodes.

**Available calculators in Lite (14 total):**

- Finance: Loan, Mortgage, Savings and Compound Growth, Credit Card Payoff, ROI
- Everyday Life: Tip, Discount, BMI, Fuel Cost
- Education: GPA, Grade Calculator
- Utilities: Percentage, Age, Unit Converter

**Key Features:**

- Blocks and Shortcodes - add calculators from the block inserter or with `[vareon]` / `[vareoncalc]`
- Live Block Preview - choose a calculator and preview it directly in the editor
- Built-in Theme Presets - use Light, Dark, or Modern globally, or override them per block or shortcode
- Flexible Branding Control - branding is off by default, with global and per-embed overrides available
- Smart Validation - sensible defaults and validation for incomplete or invalid input
- Responsive Layouts - calculators are built to work on phones, tablets, and desktops
- Accessible UI - keyboard-friendly, ARIA-aware interfaces with readable result states

== Screenshots ==

1. Three built-in theme presets included: Dark, Light, and Modern. Set one globally or override per embed to match any site design.
2. Native Gutenberg integration. Browse and insert any of the 14 calculators directly from the block editor with a visual selection modal.
3. Example of the Credit Card Payoff calculator embedded on a site, showing principal vs. interest breakdown, payoff timeline, and monthly payment detail.
4. Built to stay out of your way. The entire frontend loads in roughly 55 kB across 10 minified requests with zero jQuery dependency.

== Installation ==

1. Upload the `vareon-calculator-suite-lite` folder to `/wp-content/plugins/`
2. Activate the plugin through the Plugins menu in WordPress
3. Review settings at Settings > Vareon Calculator Suite
4. Add calculators to your pages or posts using blocks or shortcodes

== Usage ==

**Using Blocks (Recommended):**

1. Open the block editor
2. Click the + inserter
3. Search for "Vareon Calculator"
4. Choose a calculator type
5. Adjust theme, width, and branding if needed

**Using Shortcodes:**

Basic usage:
`[vareon type="bmi"]`

Alias shortcode:
`[vareoncalc type="bmi"]`

Common examples:
`[vareon type="loan" theme="dark" width="620px"]`
`[vareon type="savings" theme="modern"]`
`[vareon type="bmi" branding="0"]`

**Shortcode Parameters:**

* `type` - Calculator type: `loan`, `mortgage`, `savings`, `credit-card-payoff`, `roi`, `discount`, `tip`, `bmi`, `age`, `percentage`, `unit-converter`, `fuel-cost`, `gpa`, `grade-calc`
* `theme` - Built-in theme override: `light`, `dark`, or `modern`
* `width` - Any safe CSS width value such as `100%`, `620px`, `40rem`, or `auto`
* `branding` - Show branding with `1` or hide it with `0`

**Important:** If an invalid calculator type is used, the shortcode renders nothing instead of falling back to another calculator.

== Theme and Branding ==

Lite includes three built-in presets: Light, Dark, and Modern.

You can:

- Choose a global default theme in plugin settings
- Override the theme on individual blocks
- Override the theme in shortcodes with `theme="light"`, `theme="dark"`, or `theme="modern"`
- Enable branding globally or override it per block or shortcode

Lite also includes basic currency formatting and a global measurement system setting.

== Calculator Details ==

**BMI Calculator**

* Input: Height and weight
* Output: BMI value with category
* Includes: Friendly guidance based on the result

**Loan Calculator**

* Input: Loan amount, APR, and term
* Output: Payment estimate and payoff summary
* Includes: Total interest and total paid

**Savings and Compound Growth**

* Input: Starting amount, recurring contributions, rate, and time period
* Output: Future balance, contributions, and interest earned

**Age Calculator**

* Input: Birth date
* Output: Age in years, months, and days
* Includes: Next birthday countdown

**Unit Converter**

* Input: Value and unit category
* Output: Converted value in the selected unit

== Troubleshooting ==

= A calculator is not showing =

Make sure the plugin is active and the calculator type is valid. Test with a known shortcode such as `[vareon type="loan"]`.

= Changes are not appearing =

Clear any caching, optimization, or CDN layer and refresh the page.

= The block uses the wrong style =

Check whether the block is using the global default theme or a block-level override.

= Shortcodes work in one area but not another =

Some page builders restrict shortcode execution in certain regions. Try a shortcode block or use the native Vareon block instead.

== Frequently Asked Questions ==

= Can I add multiple calculators on one page? =

Yes. You can use multiple blocks or multiple shortcodes on the same page.

= Which themes are available in Lite? =

Lite supports the built-in `light`, `dark`, and `modern` presets.

= Can I override the theme for one calculator only? =

Yes. Blocks can use their own theme selection, and shortcodes can use the `theme` attribute.

= Can I control branding? =

Yes. Branding is off by default, and you can enable it globally or override it per block or shortcode.

= Are the calculators mobile-friendly? =

Yes. The calculators are responsive and designed to work across common screen sizes.

= Do the calculators require JavaScript? =

Yes. The calculators use modern JavaScript modules and render interactively in the browser.

== Support ==

If you need help, use the plugin support forum at https://wordpress.org/support/plugin/vareon-calculator-suite-lite/

Helpful details to include:

- Your site URL or staging URL
- Your WordPress and PHP versions
- Your Vareon Calculator Suite Lite version
- The exact shortcode or block settings you used
- A screenshot or short recording of the issue

Additional docs are available at https://vareon.dev/docs

== External Services ==

This plugin does not connect to any third-party services. All calculations run locally in the visitor's browser.

Links to vareon.dev, including documentation, branding, privacy, and the optional admin-only Pro Waitlist page, are standard links that a user may choose to click. Support is handled on WordPress.org. The plugin does not automatically send calculation data or waitlist data to those URLs.

For reference:
* Privacy Policy: https://vareon.dev/privacy/
* Terms of Service: https://vareon.dev/terms/

== Data Storage & Privacy ==

**Cookies:** This plugin does not set cookies.

**Browser localStorage (functional):**
* `vareoncalc_measurement_mode` - Stores the visitor's preferred measurement system on calculators that support both metric and imperial units.
* `vareoncalc_lite_preview_v2_state` - Stores administrator-only settings preview preferences in wp-admin (selected calculator type, preview width, zoom level, and pan position) for convenience.

**WordPress Database:**
* **Site options:** Theme preferences, currency settings, measurement settings, branding, review prompt state, and related plugin configuration
* **User meta:** Dismissal preferences for admin notices and tips
* **Transients:** Short-lived flags used for activation redirects

**No telemetry or tracking:** This plugin does not collect usage analytics or personal data. All calculations happen in the browser. The admin-only Pro Waitlist tab is just a link to vareon.dev.

**Uninstall cleanup:** Deleting the plugin from the WordPress admin removes stored plugin data from the database. Browser localStorage can be cleared from the browser itself.

== Changelog ==

Version 1.5.0 - April 2026

Calculator Overhaul
---------------
- Completely redesigned the calculator UI for better readability, stronger mobile usability, and a more modern visual style.
- Added two upgraded calculator frameworks depending on the tool: a streamlined Two-Step layout and an improved Wizard flow.
- Added a new Modern preset to Lite, giving users a darker slate/black alternative to the Light theme.
- Refined result views, interaction states, and responsive behavior across the suite.

Calculator Improvements
---------------
- Age: fixed date borrowing logic, added Milestone Horizon for the next 1,000th day alive, and enhanced the Next Birthday result with the weekday.
- BMI: added Actionable Delta guidance, extended the BMI spectrum to 50, fixed Imperial input issues, and added a disclaimer for edge cases such as muscle mass and age.
- Credit Card Payoff: added Minimum Payment mode, an editable What If planner, improved payoff date accuracy, and introduced a full amortization schedule toggle.
- Discount: added Tax, Quantity, and Reverse modes, improved the receipt view with Total at Register, and strengthened screen-reader accessibility.
- Fuel Cost: corrected MPG calculation logic, added an Annual Commute insight, improved mobile keypad behavior, and made passenger-cost updates instant.
- GPA: fixed weighted-scale logic and improved cumulative tracking.
- Grade Calculator: refined required-score math for edge cases and more reliable targets.
- Loan: added one-click presets, a Years / Months toggle, Extra Payment support, and a Cost of Money metric.
- Mortgage: added an Advanced panel for PMI, taxes, insurance, HOA, and extra payments, improved amortization accuracy, added interest-savings analysis, and introduced visual breakdown charts.
- Percentage: expanded Lite access, added Reverse Percent and Find Whole modes, and improved handling for negative numbers and zero-start edge cases.
- ROI: added a Time Unit selector, Inflation Rate support for Real ROI, and new break-even guidance for loss scenarios.
- Savings: added inflation, tax, and annual contribution-growth inputs, introduced Real Purchasing Power outputs, and upgraded the engine for dynamic monthly cash-flow simulation.
- Tip: added Smart Rounding, improved split-mode emphasis around Per Person, and tightened preset/custom-input state handling.
- Unit Converter: added Volume and Speed categories and improved result formatting with smarter rounding.

Editor, Width, and Responsive Improvements
---------------
- Rebuilt the Lite settings preview into a more interactive split-view live preview with calculator switching, width presets, custom width controls, zoom controls, retry/reset actions, drag-to-pan, and persistent preview state.
- Fixed editor and frontend width handling for aligned calculators.
- Added explicit width caps by alignment: 645px for default, 700px for left/center/right, and 1340px for wide/full.
- Added a hard minimum width clamp of 300px plus a recommended minimum width of 410px for healthier layouts.
- Added tighter responsive handling for smaller embeds, including dedicated 410px tight mode and 360px micro mode adjustments to reduce stacking and overflow issues.

Settings, Docs, and Admin Improvements
---------------
- Replaced the old docs button collection with a dedicated Docs screen.
- Added a built-in Shortcode Builder in Docs with copy support and a live embed summary.
- Refreshed settings UI details, including updated icons.
- Added a new Review Plugin notice.
- Added "Docs" quick link to the plugins list page.
- Added an admin-only Pro Waitlist tab that links to the official Vareon site.
- Persisted settings tip dismissal for administrators across sessions.
- Added a **Region Preset** (Quick Setup) section at the top of General settings: choose US, European (EU), or UK/Commonwealth to apply currency, thousand/decimal separators, and measurement units together (Imperial, Metric, or Mixed respectively).
- When your saved options match a preset exactly, that preset stays selected; otherwise the control shows **Custom** so you can keep fine-tuned combinations.

Performance, Compatibility, and Maintenance
---------------
- Improved frontend performance by splitting the calculator CSS into smaller calculator-specific files and only enqueueing the styles needed on the page.
- Improved frontend and admin asset cache busting, including preview-related asset versioning for more reliable updates.
- Updated privacy and uninstall cleanup coverage for admin dismissal preferences.
- Consolidated duplicate script_loader_tag handling into a single location.
- Removed duplicate currency-catalog.php require.
- Standardized admin asset cache busting to use filemtime() consistently.
- Removed deprecated block_categories filter (WP 5.8+).

Vareon
---------------
- We made a total revamp of the Vareon.dev website with new design and articles explaining all the available calculators. Other content is also planned, therefore please visit the website periodically, for relevant content.

Removed
---------------
- Auto-Calculate on Input setting (incompatible with new calculator designs).

Version 1.0.3 - January 2026

Fixes
---------------
- Updated readme

Version 1.0.2 - January 2026

Fixes
---------------
- Minor fix to logo and readme

Version 1.0.1 - January 2026

Fixes
---------------
- Minor Logo fixes

Version 1.0.0 - January 2026

Highlights
---------------
- Curated library of embedded calculators covering finance, health, education, and daily utilities.
- Gutenberg block with alignment controls and per-block overrides.
- Modern UI driven by CSS custom properties, light/dark presets, and responsive layouts.
- Built-in validation and accessible messaging for every calculator.

What's Included
---------------
Finance & Business: Loan, Mortgage, Savings & Compound Growth, ROI, Credit Card Payoff, Tip, Discount, Percentage.
Health & Lifestyle: BMI, Fuel Cost.
Education & Productivity: GPA, Grade Calculator, Age Calculator, Unit Converter.
Editor & Admin: Block modal picker and settings live preview.
Branding Control: Optional "Powered by Vareon" credit (off by default, enable if you'd like to support development).
Performance & Architecture: ES-module calculators, on-demand loading, reusable calculator utilities.

Looking Ahead
---------------
Ongoing improvements and refinements across the calculator library and UI.
Additional calculators and customization options in future 1.x releases.

== Upgrade Notice ==

= 1.5.0 =
Major calculator overhaul with redesigned UI, new Modern Lite theme, upgraded responsive layouts, interactive settings preview, broad accuracy improvements across the suite, and new vareon.dev website design.

= 1.0.3 =
Updated readme

= 1.0.2 =
Minor fix to logo and readme

= 1.0.1 =
Minor Logo fixes

= 1.0.0 =
Initial release.
