=== HIFreeTools Embed ===
Contributors: hifreetools
Tags: calculator, converter, embed, shortcode, block
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed any HIFreeTools calculator or converter on your WordPress site with a shortcode or block. Free, no sign-up, runs in the visitor's browser.

== Description ==

HIFreeTools Embed lets you drop any of the free calculators and converters from
[hifreetools.com](https://hifreetools.com) into your posts and pages.

* **Free** — no sign-up, no API key, no per-view cost.
* **Fast** — the tool is static code on a global CDN and the iframe loads lazily.
* **Private** — the widget runs in your visitor's browser; no tracking inside it.
* **Mobile-friendly** — the embed is responsive (width 100%, max 680px).

= How to use =

**Block editor:** add the "HIFreeTools Embed" block, then type the tool slug
(the last part of the tool's URL, e.g. `percentage-calculator`) in the block
settings.

**Shortcode:** `[hifreetool slug="percentage-calculator"]`
Optional height: `[hifreetool slug="mortgage-calculator" height="640"]`

Find a tool's slug by opening it on hifreetools.com — the slug is the final
segment of the address, e.g. `https://hifreetools.com/calculators/percentage-calculator`
→ slug `percentage-calculator`.

== Installation ==

1. Upload the `hifreetools` folder to `/wp-content/plugins/`, or install the zip
   via Plugins → Add New → Upload Plugin.
2. Activate the plugin through the Plugins menu in WordPress.
3. Add the "HIFreeTools Embed" block, or use the `[hifreetool]` shortcode.

== Frequently Asked Questions ==

= Where do I find the tool slug? =

Open the tool on hifreetools.com. The slug is the last part of the URL, for
example `percentage-calculator` or `mortgage-calculator`.

= Does it cost anything? =

No. The tools are free to embed and run in the visitor's browser, so there is
no hosting cost on your side.

= Can I resize the widget? =

Yes. Set the `height` attribute on the shortcode, or use the Height slider in
the block settings. The width is always responsive up to 680px.

= Is attribution required? =

The embed includes a small credit link back to the tool. Keeping it is
appreciated and helps others discover the tools, but it is not mandatory.

== Changelog ==

= 1.0.0 =
* Initial release: `[hifreetool]` shortcode and "HIFreeTools Embed" block.
