=== ExactCalcs ===
Contributors: exactcalcs
Tags: calculator, mortgage calculator, bmi calculator, finance calculator, health calculator
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed any of ExactCalcs' 49 formula-verified calculators — health, finance, clinical risk, and more — with a block, an Elementor widget, or a shortcode.

== Description ==

ExactCalcs is a library of 49 calculators — BMI, mortgage, loan amortization, retirement, clinical
risk scores (Gail model breast cancer risk, CHADS2, HAS-BLED, and others), pregnancy timelines,
home energy costs, and more — each checked against either a published formula or the original
tool's own live output. This plugin embeds any of them directly into a page, with no iframe: the
calculator renders styled to match its own theme, live and interactive, right inside your content.

Three ways to place one:

* **Gutenberg block** — search "ExactCalcs" in the block inserter, pick a calculator from the
  dropdown.
* **Elementor widget** — drag "ExactCalcs Calculator" from the widget panel, pick a calculator.
* **Shortcode** — `[exactcalcs id="bmi"]` works anywhere shortcodes render, including the Classic
  Editor and page builders without dedicated ExactCalcs support.

An ExactCalcs API key is required — [sign up for one free](https://exactcalcs.com/dev). Saving your
key under Settings → ExactCalcs also registers your site's domain against it, which is what allows
your key to work at all: for security, an ExactCalcs API key only accepts requests from domains
you've explicitly registered.

= Third-party service =

This plugin connects your WordPress site to the ExactCalcs API at `https://exactcalcs.com`, a
service operated by ExactCalcs, to:

* validate your API key and register your site's domain when you save it under Settings →
  ExactCalcs (sends: your API key, your site's home URL);
* fetch the list of available calculators for the block/widget picker, cached locally for 12 hours
  (sends: nothing beyond the request itself);
* load `exactcalcs-widget.js` and, from each visitor's own browser, verify the API key against
  the domain it's running on and load the calculator's configuration (sends, from the visitor's
  browser directly to exactcalcs.com: your API key, your site's domain, and which calculator was
  requested — no visitor-identifying data).

ExactCalcs' terms of service: https://exactcalcs.com/terms
ExactCalcs' privacy policy: https://exactcalcs.com/privacy

== Installation ==

1. Upload the plugin (or install it from the WordPress plugin directory) and activate it.
2. Go to Settings → ExactCalcs and paste in an API key from
   [your ExactCalcs dashboard](https://exactcalcs.com/dev).
3. Add a calculator to any page or post via the "ExactCalcs Calculator" block, the Elementor
   widget of the same name, or the `[exactcalcs id="bmi"]` shortcode.

== Frequently Asked Questions ==

= Which calculator IDs can I use in the shortcode? =

Every ID visible in the block editor's or Elementor's calculator dropdown is a valid shortcode
`id` — e.g. `[exactcalcs id="mortgage"]`, `[exactcalcs id="breast-cancer-risk"]`.

= Does this slow down pages with no calculator on them? =

No — the calculator script only loads on pages that actually contain a block, widget, or
shortcode instance.

= Can I use more than one calculator per page? =

Yes, any number and mix of the three embed methods on the same page.

== Changelog ==

= 1.0.0 =
* Initial release: settings page, shortcode, Gutenberg block, Elementor widget.
