=== HisabCalc – Loan, Zakat, BMI & Age Calculators ===
Contributors: tfjishan
Tags: calculator, emi calculator, loan calculator, bmi calculator, zakat calculator
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free loan/EMI, mortgage, zakat, compound interest, DPS, BMI, percentage and age calculators. Instant and mobile-friendly.

== Description ==

HisabCalc gives you eight ready-made calculators that you can drop into any post, page or widget with a block or a shortcode. Everything is calculated inside the visitor's browser, so the pages stay fast and no personal data ever leaves the reader's device.

**Included calculators**

* **Loan / EMI calculator** - monthly instalment, total payable, total interest, plus a year-by-year breakdown table.
* **Mortgage / home loan calculator** - property price, down payment, monthly payment and the real total cost.
* **Zakat calculator** - gold, silver, cash, business stock, receivables and debts, with the 2.5% zakat and a nisab check.
* **Compound interest / FDR maturity** - what a lump sum becomes at a fixed rate, with yearly, half-yearly, quarterly or monthly compounding.
* **Monthly savings / DPS** - what a monthly deposit grows into over time.
* **BMI calculator** - with both WHO and South Asian cut-off points, plus the healthy weight range for the visitor's height.
* **Percentage calculator** - five everyday percentage questions in one: percent of a number, what percent, percentage change, increase and decrease.
* **Age calculator** - exact age in years, months and days, total days and the countdown to the next birthday.

**Why people keep it installed**

* **Fast.** One small CSS file and two small scripts. No jQuery, no external requests, no fonts to download.
* **Private by design.** Nothing is posted to your server and nothing is stored. There is no tracking in the plugin.
* **Responsive.** Works on a 320px phone and inside a full-width block.
* **Theme friendly.** Colours come from the customiser-style accent setting, and a dark-mode palette follows the visitor's system preference.
* **Translatable.** Every label can be translated into your own language.
* **SEO-friendly output.** Results appear instantly on the page, which keeps visitors on the page longer.

**How to add a calculator**

1. Edit a post or page and click the **+** button, then search for "HisabCalc".
2. Pick the calculator you want from the block sidebar.
3. Or use a shortcode: `[hisabcalc id="loan-emi"]`, `[hisabcalc id="zakat"]`, `[hisabcalc id="bmi"]`.

Available ids: `loan-emi`, `mortgage`, `zakat`, `compound-interest`, `dps`, `bmi`, `percentage`, `age`.

**Settings**

Under *Settings > HisabCalc* you can choose the currency, the number format locale, how many decimal places to show, the accent colour and whether the small credit line is displayed.

== Installation ==

1. Upload the `hisabcalc` folder to `/wp-content/plugins/`, or install it directly from the Plugins screen.
2. Activate the plugin.
3. Add the **HisabCalc Calculator** block to a post, or paste `[hisabcalc id="loan-emi"]`.

== Frequently Asked Questions ==

= Is any data sent to my server? =

No. All calculations run in the visitor's browser with plain JavaScript. The plugin makes no external requests and stores nothing.

= Can I use several calculators on one page? =

Yes. Add as many blocks as you like; they all run independently.

= Do the numbers use my local currency and number format? =

Yes. Set the currency and locale under *Settings > HisabCalc*. If your site language is Bangla, the taka (BDT) is selected automatically.

= Can I use it with the Classic editor or a page builder? =

Yes. Use the shortcode `[hisabcalc id="zakat"]` in the Classic editor, or a shortcode/text block in Elementor, Divi, WPBakery and similar builders. Theme authors can also call `hisabcalc_the_calculator( 'loan-emi' )` in a template.

= Are the results financial advice? =

No. Every calculator is an estimate for planning. Confirm final figures with your bank, employer, tax adviser or doctor.

== Screenshots ==

1. The loan / EMI calculator with the year-by-year breakdown.
2. The zakat calculator with the nisab check.
3. The BMI calculator, with the WHO and South Asian cut-off points side by side.
4. The monthly savings (DPS) calculator in dark mode.

== Changelog ==

= 1.0.2 =
* Renamed the plugin to HisabCalc, as requested during the WordPress.org review.
* The bundled translation files were removed from the package; translations are delivered by translate.wordpress.org.

= 1.0.1 =
* Shortened the readme short description so the directory does not truncate it.

= 1.0.0 =
* First release with eight calculators: loan/EMI, mortgage, zakat, compound interest, DPS, BMI, percentage and age.
* Gutenberg block plus shortcode.
* Currency, locale, decimals, accent colour and credit-line settings.
* Dark-mode palette and full translation support.

== Upgrade Notice ==

= 1.0.2 =
Renamed to HisabCalc.

= 1.0.1 =
Small readme fix for the directory listing.

= 1.0.0 =
First public release.
