=== Toolshed Widgets ===
Contributors: toolshedworld
Tags: calculator, widget, embed, finance, percentage
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 0.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed 25+ free calculators on your WordPress site. Percentage, discount, EMI, SIP, compound interest, GST, and more.

== Description ==

Toolshed Calculators lets you embed free, interactive calculators on any WordPress post or page using a simple shortcode.

**25+ calculators available:**

**Everyday**
* Percentage Calculator — `/calculator/percentage/`
* Discount Calculator — `/calculator/discount/`
* Tip & Split Calculator — `/calculator/tip-split/`

**Investing**
* CAGR Calculator — `/calculator/compound-annual-growth-rate/`
* Compound Interest Calculator — `/calculator/compound-interest/`
* Inflation Calculator — `/calculator/inflation/`
* Goal Calculator — `/calculator/goal/`

**Finance (India)**
* EMI Calculator — `/in/calculator/equated-monthly-installment/`
* Loan Prepayment Calculator — `/in/calculator/prepayment/`
* Loan Eligibility Calculator — `/in/calculator/loan-eligibility/`
* SIP Calculator — `/in/calculator/systematic-investment-plan/`
* SWP Calculator — `/in/calculator/systematic-withdrawal-plan/`
* PPF Calculator — `/in/calculator/public-provident-fund/`
* FD Calculator — `/in/calculator/fixed-deposit/`
* RD Calculator — `/in/calculator/recurring-deposit/`
* Take-Home Salary Calculator — `/in/calculator/take-home/`
* EPF Calculator — `/in/calculator/employee-provident-fund/`
* Gratuity Calculator — `/in/calculator/gratuity/`
* HRA Calculator — `/in/calculator/house-rent-allowance/`
* GST Calculator — `/in/calculator/goods-and-services-tax/`
* Import Duty Calculator — `/in/calculator/import-duty/`

**Government Schemes (India)**
* NPS Calculator — `/in/calculator/national-pension-scheme/`
* SSY Calculator — `/in/calculator/sukanya-samriddhi-yojana/`
* NSC Calculator — `/in/calculator/national-savings-certificate/`
* KVP Calculator — `/in/calculator/kisan-vikas-patra/`
* MIS Calculator — `/in/calculator/post-office-monthly-income-scheme/`

**How it works:**

The plugin registers a `[toolshed]` shortcode. Pass the calculator's path and the plugin renders it on your page. All calculations run in the visitor's browser — no data is sent to any server.

**External service disclosure:**

This plugin loads calculator widgets from [toolshed.world](https://toolshed.world). When a page with a Toolshed shortcode is viewed, the visitor's browser fetches:

* `https://toolshed.world/widget.js` — the widget loader script (~3 KB)
* `https://toolshed.world/embed/{path}` — the calculator page (loaded in an iframe)

No personal data is collected or transmitted by the plugin. The embedded calculators use cookieless analytics (no tracking cookies are set). The calculator service may display a small attribution link below the widget.

== Installation ==

1. Upload the `toolshed-calculators` folder to `/wp-content/plugins/`
2. Activate the plugin through the Plugins menu
3. Add `[toolshed path="/calculator/percentage/"]` to any post or page

== Usage ==

**Basic:**
`[toolshed path="/calculator/percentage/"]`

**Custom size (px):**
`[toolshed path="/calculator/discount/" width="500px" height="700px"]`

**Custom size (%):**
`[toolshed path="/calculator/compound-interest/" width="100%" height="600px"]`

**Custom title:**
`[toolshed path="/calculator/inflation/" title="My Inflation Calculator"]`

**Dark theme:**
`[toolshed path="/calculator/tip-split/" theme="dark"]`

== Shortcode Parameters ==

`[toolshed path="" width="" height="" title="" theme=""]`

= path (required) =
The calculator path from toolshed.world. This determines which calculator to embed.

Examples: `/calculator/percentage/`, `/calculator/compound-interest/`, `/calculator/discount/`

= width (optional) =
Widget width. Accepts pixels or percentage. Default: `450px`.

Examples: `450px`, `100%`, `600px`

= height (optional) =
Widget height. Accepts pixels or percentage. Default: `600px`.

Examples: `600px`, `100%`, `800px`

= title (optional) =
Custom title displayed above the calculator. If omitted, a title is auto-generated from the path.

Examples: `My EMI Calculator`, `GST कैलकुलेटर`, `Interest Calculator`

= theme (optional) =
Force a specific theme. If omitted, the calculator uses the default light theme.

Accepted values: `light`, `dark`

== Frequently Asked Questions ==

= Does this plugin slow down my site? =

No. The widget script is lightweight (under 3 KB) and loads asynchronously. It does not block page rendering.

= Is any data sent to external servers? =

The plugin loads calculator widgets from toolshed.world. No personal data is collected. All calculations run in the visitor's browser.

= Can I customize the calculator appearance? =

You can set the width, height, title, and theme via shortcode attributes. The calculator supports light and dark themes.

= Do I need a toolshed.world account? =

No. The plugin works without any account or API key.

== Screenshots ==

1. Percentage calculator embedded in a WordPress post
2. EMI calculator with custom width and dark theme

== Changelog ==

= 0.0.1 =
* Initial release with 25+ calculators
* Shortcode with path, width (px/%), height (px/%), title, and theme attributes
