Deterministic Financial Calculations & Loan Amortization for WordPress
FinEngine Calculator (FinEngine-WP) is the official WordPress plugin delivering audited actuarial reducing-balance loan calculators, integer-scaled sub-unit arithmetic (Poisha: 1 BDT = 100 Poisha), terminal zero reconciliation ($B_n \equiv 0.00$), and South Asian Lakh/Crore grouping directly into WordPress CMS pages and WooCommerce storefronts.
Interactive Loan & EMI Calculator Simulator
This interactive surface runs the identical deterministic calculation engine and presentation logic deployed inside the [finengine_calculator] shortcode and Gutenberg block:
| Month | Payment | Principal | Interest | Balance |
|---|
Core Architectural Guarantees for WordPress Sites
Standard web calculators rely on binary floating-point math that drifts over 36 or 60 monthly periods. FinEngine solves this natively inside WordPress:
Zero Floating-Point Drift
All currency calculations scale monetary values to integer sub-units (Poisha: 100 Poisha = 1 BDT). This eliminates the representation error inherent in JavaScript IEEE-754 double precision.
Terminal Reconciliation Rule
Multi-period amortization schedules enforce the CFSBR boundary condition: the remaining principal balance on month n liquidates cleanly to identically zero ($B_n \equiv 0.00$).
South Asian Lakh/Crore Formats
Native South Asian 2,2,3 grouping (e.g., 25,00,000 for 25 Lakhs) alongside standard ISO international 3,3,3 thousands commas. Formatted smoothly across Bengali (bn-BD) and English locales.
100% Client-Side Privacy
Zero tracking, zero database writes, and zero external AJAX queries. User loan amounts and personal finance estimates remain entirely private inside the visitor browser runtime.
Dual Integration Architecture
Includes both a Full Site Editing Gutenberg Block with live sidebar InspectorControls and a universal shortcode [finengine_calculator] compatible with all page builders.
Ultra-Lightweight Performance
Zero external dependencies and no jQuery overhead. The compiled client runtime is under 25KB, achieving sub-10ms render times and flawless Google PageSpeed Core Web Vitals.
Interactive Shortcode Generator
Configure your desired parameters below to generate a production-ready shortcode snippet for any WordPress page, post, or widget:
Shortcode Attributes Reference
| Attribute | Type | Default | Description |
|---|---|---|---|
currency |
string |
"BDT" |
ISO currency code (e.g., BDT, USD, EUR, GBP, INR). |
default_principal |
numeric |
500000 |
Initial principal amount loaded in the slider and numeric input. |
default_rate |
numeric |
12.0 |
Annual interest rate percentage loaded by default. |
default_tenure |
integer |
36 |
Repayment duration in months (e.g., 12, 24, 36, 60). |
locale |
string |
"bn-BD" |
BCP 47 language tag for comma formatting and localized digits. |
primary_color |
hex color |
"#10b981" |
Primary brand theme color applied to sliders, active tabs, and primary KPI metrics. |
show_schedule |
boolean |
"true" |
Controls whether the month-by-month amortization schedule breakdown is rendered. |
Native WordPress Block Experience
FinEngine Calculator includes an official React block built against the WordPress Block API (v3):
Type /finengine or search for FinEngine Loan Calculator in the block inserter.
Fine-tune min/max ranges, step increments, default values, and accent colors in the sidebar settings panel.
Inspect the exact interactive calculator preview directly inside the Gutenberg editing canvas in real time.
Publish or save changes. The calculator loads seamlessly for desktop, tablet, and mobile visitors.
WordPress Page Builder & Theme Matrix
Rigorous automated testing ensures zero style conflicts with modern WordPress themes and builders:
| Editor / Framework | Integration Method | Live Status | Notes |
|---|---|---|---|
| Gutenberg Block Editor | Native React Block & Shortcode | 100% Compatible | Official Block API v3 with InspectorControls |
| Classic Editor (TinyMCE) | Universal Shortcode | 100% Compatible | Drop [finengine_calculator] into visual or text mode |
| Elementor Page Builder | Shortcode Widget / HTML Block | 100% Compatible | Zero style bleed, fully responsive in mobile editor mode |
| Divi Builder | Code Module / Shortcode | 100% Compatible | Operates cleanly inside Divi Visual Builder sections |
| Beaver Builder & Bricks | Shortcode Module | 100% Compatible | Clean layout scaling without CSS specificity collisions |
| Full Site Editing (FSE) Themes | Block Theme Templates & Patterns | 100% Compatible | Twenty Twenty-Four, Astra, GeneratePress, Kadence |
Zero-Install Testing via WordPress Playground
WordPress Playground executes full PHP, SQLite, and WordPress inside WebAssembly right in your browser. With our custom blueprint.json, you can evaluate FinEngine Calculator in under 5 seconds:
gmrafi/FinEngine-WP, activates the plugin, and routes directly to a pre-configured sample page displaying both the native block and shortcode implementations.
Governance & Attribution
CFSBR Open Science Integrity
FinEngine Calculator is maintained under the computational research standards of the Centre for Fintech and Strategic Business Research (CFSBR). All mathematical formulations follow deterministic actuarial reducing-balance specifications, permanent CERN Zenodo archival, and Crossref methodology indexing.
- Author & Architect: Md Golam Mubasshir Rafi (gmrafi.com.bd ↗)
- Contact: rafi@gmrafi.com.bd
- WordPress Profile: profiles.wordpress.org/gmrafi ↗
- License: GNU General Public License v2 or later (GPL-2.0-or-later)
Community & Source Code
- Plugin Repository: gmrafi/FinEngine-WP ↗
- Monorepo & Core Engine: gmrafi/FinEngine ↗
- Issue Tracker & Bug Intake: FinEngine-WP Issues ↗
- Methodology Working Paper: CFSBR-FE-2026-001 ↗