=== WidgetCalc — Pricing, Quote & Cost Calculators for Leads ===
Contributors: rocksoftware
Tags: calculator, pricing calculator, quote calculator, cost estimator, lead generation, roi calculator, embed, widget
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a free pricing, ROI or cost calculator to any page — copy a ready-made embed with no signup, or build your own in minutes.

== Description ==

Most WordPress calculator plugins either need you to write formulas in code, or lock lead capture behind an expensive plan. **WidgetCalc is built the other way round**: activate this plugin, drop the block or shortcode on any page with no setup at all, and you'll see a real, working lead-capturing calculator straight away — it starts out showing [widgetcalc.com's own public demo calculator](https://widgetcalc.com/calculators/cost-savings-calculator), no account, no signup. When you're ready for your own, build a pricing calculator, quote calculator or cost estimator in a point-and-click editor at [widgetcalc.com](https://widgetcalc.com/go/wp-plugin), publish it, and paste its key in to replace the demo — free plan included, no credit card.

Whatever you're building it for — a pricing calculator that quotes a price from a visitor's answers, a quote form for a service business, a cost estimator for a project, or an ROI/savings calculator for a landing page — a WidgetCalc calculator asks a visitor a few questions (spend, team size, hours spent per week — whatever your calculator needs), shows them a result worth sharing ("You could save €4,200/year" or "Your estimated quote: €1,250"), and captures their email before or after that result so every calculation becomes a lead in your dashboard, not just a number on the page.

= Why WidgetCalc instead of a generic form plugin or a hand-coded script? =

* **Works the moment you activate it.** No key to find first: the block and shortcode show [widgetcalc.com's public demo calculator](https://widgetcalc.com/calculators/cost-savings-calculator) out of the box — no account needed — so you see a real one working on your site before you build anything.
* **No formulas to write.** Build the calculator at widgetcalc.com with a visual editor — fields, a formula built by clicking, and a live preview — then paste one key here. Nothing to code on the WordPress side, ever.
* **The lead capture is built in.** The calculator *is* the lead form; you don't wire up a separate Contact Form 7 or Gravity Forms integration to get the email address.
* **A free plan that actually works.** One calculator, unlimited visitors, no time limit — not a 14-day trial.
* **Light and lazy.** The calculator loads in an iframe after the rest of your page, so it never blocks or slows down your WordPress site's own load.

This plugin puts that calculator on a WordPress site with no code:

* A `[widgetcalc]` shortcode you can drop into any page, post or widget area.
* A WidgetCalc block for the block editor (Gutenberg), with a field for the calculator key.
* A site-wide default calculator key under **Settings → WidgetCalc**, so a single-calculator site needs no attributes at all.

Build your calculator at [widgetcalc.com](https://widgetcalc.com/go/wp-plugin) first (a free plan covers one calculator), copy its key from the publish step, and paste it here.

= Usage =

1. Activate the plugin, then add the WidgetCalc block or `[widgetcalc]` shortcode (no attributes needed) anywhere — it already shows a live, working demo calculator.
2. When you're ready for your own: create and publish a calculator at widgetcalc.com, copy the calculator key shown on the publish step (the part of the embed snippet between `/embed/` and `.js`), and either:
   * Go to **Settings → WidgetCalc** and paste it as your default key to replace the demo everywhere, or
   * Use `[widgetcalc key="your-calculator-key"]` to place a specific calculator, independent of the default.

= Does this need a paid WidgetCalc plan? =

No. The plugin works with WidgetCalc's free plan (one calculator, WidgetCalc badge shown). Paid plans add more calculators, remove the badge and unlock lead routing.

= I don't want to build the calculator myself — can WidgetCalc do it? =

Yes. WidgetCalc also sells a done-for-you service: send your pricing sheet or formula and they build, publish and host the calculator for you, for a fixed one-time setup fee plus monthly hosting. It's a separate paid service from this free plugin, not a requirement to use it — see the [built-for-you offer](https://widgetcalc.com/built-for-you) and its [Terms of Service](https://widgetcalc.com/terms). A link to it is also on this plugin's own **Settings → WidgetCalc** page.

== Installation ==

1. Upload the `widgetcalc` folder to `/wp-content/plugins/`, or install directly from the WordPress plugin directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Add the WidgetCalc block to any page, or use the `[widgetcalc]` shortcode — it shows a live demo calculator with no setup.
4. When you're ready for your own: go to **Settings → WidgetCalc** and paste your calculator's key to replace the demo.

== Frequently Asked Questions ==

= Can I use this to build a quote form, not just a calculator? =

Yes. A WidgetCalc "calculator" is really a questions-to-result flow — the same builder makes a pricing calculator, a quote form that ends in "your estimated price is...", or a cost estimator for a project. Start from the price-quote template at widgetcalc.com if a quote form is what you need.

= Is this a cost estimator plugin? =

Yes, among other things. Templates for cost estimators, pricing calculators, ROI calculators and time/savings calculators are all built in the same visual editor and embed with the same shortcode or block — pick the template closest to what you need and edit it, no code.

= Is this really free, or is lead capture locked behind a paid plan? =

The free WidgetCalc plan includes one calculator, unlimited visitors and lead capture with no time limit — the thing most calculator plugins charge for. Paid plans add more calculators, remove the WidgetCalc badge and unlock lead routing (webhooks, more export options); they are not required to get real leads from this plugin.

= Do I need to write a formula or any code? =

No. You build the calculator itself at widgetcalc.com in a visual editor — add fields, build the formula by clicking them together, and see a live preview as you go — then paste the finished calculator's key into this plugin. Nothing here needs code.

= What does the plugin show before I set a key? =

A real, working demo calculator from widgetcalc.com (no account needed), not a blank space or a placeholder message. It stays until you save your own calculator's key under **Settings → WidgetCalc**, or pass a different `key="…"` to the shortcode.

= Where do I get my own calculator key? =

Create a calculator at widgetcalc.com (or start from a template) and publish it; the publish step shows an embed snippet, and the key is the UUID between `/embed/` and `.js` in that snippet. Paste it under **Settings → WidgetCalc** to replace the demo everywhere, or use `[widgetcalc key="…"]` to place it on one specific page only.

= Can I embed more than one calculator? =

Yes — set a site-wide default under Settings → WidgetCalc for your main calculator, then use `[widgetcalc key="…"]` with a different key anywhere you want a different one.

= Does this slow down my site? =

The calculator loads in a lazy iframe, after the rest of your page, so it does not block your page's own load.

== External services ==

This plugin loads your calculator from WidgetCalc, the hosted service it is
a shortcut for — it has no function without it.

* **What**: a loader script, `https://widgetcalc.com/embed/{your-calculator-key}.js`,
  requested directly by the visitor's browser for every page that shows a
  `[widgetcalc]` shortcode or WidgetCalc block.
* **When**: on every page view where the shortcode or block is placed.
* **What data is sent**: the calculator key you configured (part of the
  script URL) and the standard request data any script load sends (the
  visitor's IP address and user agent, to the hosting server). The visitor's
  own answers inside the calculator (and an email address, if the
  calculator asks for one) are sent to WidgetCalc only if the visitor fills
  in and submits the calculator; the plugin itself sends nothing on their
  behalf.
* **Provided by**: Rock Software Oy, WidgetCalc — [Terms of Service](https://widgetcalc.com/terms), [Privacy Policy](https://widgetcalc.com/privacy).

== Changelog ==

= 1.0.7 =
* Close the activate -> blank-page leak: the block and shortcode now default to
  widgetcalc.com's own public demo calculator (no account needed) instead of showing
  nothing until you build and paste your own key. Settings → WidgetCalc explains this
  plainly instead of blocking on an empty key.
* Fix a dead link: the listing's description and FAQ pointed at
  widgetcalc.com/calculators (plural), which requires a login — not the public,
  no-account demo pages. Every link now goes to a page that actually works without
  signing in.

= 1.0.6 =
* Sell the no-signup path first: the listing's short description, intro and two FAQ entries now
  lead with copying a ready-made calculator's embed key straight from widgetcalc.com/calculators
  — no account — before asking anyone to build their own. Those three calculators' public pages
  and keys shipped on widgetcalc.com itself this week; this release is the listing catching up
  to say so.

= 1.0.5 =
* Add a FAQ entry and a settings-page link for the "built-for-you" done-for-you service
  (send your pricing sheet, WidgetCalc builds and hosts the calculator) — a separate paid
  service from this free plugin, linked only from the plugin's own settings screen, not from
  any front-facing page it renders.

= 1.0.4 =
* Retitle the listing and rewrite the tags, description and two new FAQ entries around the
  words a WordPress site owner actually searches for (pricing calculator, quote form, cost
  estimator), not just "ROI widget" — the plugin always did all of these, the listing just
  didn't say so.

= 1.0.3 =
* Add the directory listing's first screenshots: a live calculator, the builder with its live
  preview, and the embed snippet — so a visitor can see the product work before installing.

= 1.0.2 =
* Rewrite the directory listing as a landing page: a sharper title, a "why WidgetCalc" section in the description, and two new FAQ entries (is it really free, do I need to code) answering the two questions a visitor to this listing actually has.
* The admin settings screen now shows a plain "Build a free calculator" button when no key is set yet, linking through a counted redirect so we can see whether an install turns into a signup.

= 1.0.1 =
* Fix: enqueue the embed loader via wp_enqueue_script instead of printing a raw <script> tag.
* Document the WidgetCalc external service (data sent, ToS, privacy) in this readme.
* Remove an unsupported "fastest" claim from the description; add rocksoftware as a listed contributor.

= 1.0.0 =
* First release: shortcode, block and a site-wide default key.

== Screenshots ==

1. A finished calculator, live on its own page at widgetcalc.com — try it before you build
   anything.
2. The builder: pick a template, and a live preview updates on the right as you edit field
   labels and types. No formulas to write.
3. Save, and the one-line embed snippet is right there — paste it into a WordPress page,
   post, or widget, or use this plugin's shortcode/block instead.
