FinEngine WordPress Ecosystem: Deterministic Computational Engine & FSE Block Theme
Conceived and architected by Md Golam Mubasshir Rafi under the institutional governance of the Centre for Fintech and Strategic Business Research (CFSBR). An open-source, dual-architecture solution for WordPress delivering audited actuarial reducing-balance loan computation (finengine-calculator) and a modern Full-Site Editing block theme (finengine-fintech, Trac #293749).
finengine-calculator). Passed official WordPress Plugin Check (PCP) inspection with 0 errors and 0 warnings. Executes actuarial reducing-balance amortization, Poisha sub-unit scaling, and guaranteed terminal zero reconciliation (Bₙ ≡ 0.00).
finengine-fintech). Automated review check returned PASS status. Official Trac review ticket opened under #293749. Powered by theme.json v3 design tokens, WCAG AAA accessibility, and native Elementor canvas support.
The FinEngine WordPress Ecosystem
FinEngine decomposes WordPress financial engineering into two interconnected but fully decoupled layers: an audited computational engine for actuarial math and a modern Full-Site Editing theme for corporate finance layout.
FinEngine Calculator (Plugin)
Eliminates IEEE-754 binary floating-point drift and enforces zero terminal reconciliation for all multi-year loans and financial schedules.
- Sub-Unit Poisha Scaling: Operates strictly via integer arithmetic (1 BDT = 100 Poisha), eliminating float representation drift.
- Terminal Zero Balance (Bₙ ≡ 0.00): Enforces rigorous boundary condition so the final installment liquidates the balance to zero.
- South Asian Numbering: Native Lakh and Crore grouping (
২,৪৫,৮৭,৫০০.০০) for local banking clarity. - Dual Embed Options: Native Gutenberg block with InspectorControls and universal shortcode
[finengine_calculator]. - Client-Side Privacy: Zero AJAX, zero server telemetry, and zero database queries.
FinEngine Fintech (FSE Block Theme)
Full-Site Editing (FSE) block theme engineered specifically for banks, microfinance institutions, and quantitative fintech portals.
- Full-Site Editing (FSE): Modern
theme.jsonv3 token architecture for complete visual and template control. - WCAG AAA Color System: Curated Emerald (
#0f766e), Slate Navy (#0f172a), and Cyan (#0ea5e9) meeting highest contrast rules. - Pre-Built Financial Patterns: High-conversion financial hero, actuarial KPI grid, and calculator containers.
- Elementor Canvas Compatibility: Dedicated
page-elementor-fullwidth.htmlcanvas template for drag-and-drop page builders. - Zero-Bloat Performance: Native system font stack, 0 external CDN requests, and pure CSS variables.
Cohesive Interoperability: How They Function Together
Both components are engineered to function independently or coalesce into a turnkey financial website solution:
Install finengine-calculator on any existing WordPress theme (Astra, GeneratePress, Twenty Twenty-Four, or custom agency themes). The shortcode and Gutenberg block adapt to any stylesheet.
Deploy finengine-fintech as a complete, lightweight FSE block theme for corporate banking, investment newsletters, and institutional finance portals with or without loan calculators.
When installed together, the theme's calculator-section pattern automatically embeds the plugin's interactive calculator inside a pre-styled, high-contrast financial layout with zero configuration.
Pre-Built Financial Block Patterns
finengine-fintech delivers three pre-engineered block patterns built into the WordPress block pattern inserter under the FinEngine Finance category:
Financial Hero & Metrics
High-conversion landing page hero featuring institutional value propositions, key metrics (BDT volume, reducing balance, precision tier), primary and secondary call-to-action buttons, and trust badges.
Actuarial KPI Card Grid
3-column precision KPI cards highlighting integer sub-unit Poisha scaling, terminal zero balance guarantee (Bₙ ≡ 0.00), and localized South Asian numbering formats for transparent auditing.
Loan Calculator Container
A pre-styled, responsive container pre-wired to embed live loan and EMI calculators. Pre-configured with heading, advisory disclaimer copy, and seamless drop-in shortcode or block integration.
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ₙ ≡ 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, site editors, and builders:
| Editor / Framework | Integration Method | Live Status | Notes |
|---|---|---|---|
| FinEngine Fintech (FSE Theme) | Full-Site Editing & Patterns | 100% Native | Official FSE theme with pre-wired financial block patterns and theme.json v3 tokens |
| 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 | Canvas Template / Shortcode / HTML | 100% Compatible | Includes dedicated page-elementor-fullwidth.html canvas template with zero style bleed |
| 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 |
| Third-Party FSE Themes | Block Theme Templates & Patterns | 100% Compatible | Twenty Twenty-Four, Astra, GeneratePress, Kadence, Blocksy |
FinEngine Computational Parity Matrix
FinEngine maintains identical mathematical parity between client-side JavaScript, Python scientific backends, and WordPress interfaces:
| Package / Repository | Version | Registry | Purpose | Status |
|---|---|---|---|---|
| @finengine/core | 0.3.0 |
npm | Integer sub-unit arithmetic, BDT currency primitives, double-entry ledger. | Published |
| @finengine/math | 0.3.0 |
npm | Actuarial reducing-balance loan amortization, EMI schedules, XIRR solver. | Published |
| @finengine/ui | 0.3.0 |
npm | Accessible view-models for repayment summaries and burden gauges. | Published |
| finengine (Python) | 0.1.1 |
PyPI | Python actuarial math, Pandas DataFrames, and alternative credit risk AI. | Published |
| finengine-calculator | 1.0.0 |
WP.org / GitHub | Deterministic reducing-balance Loan & EMI Calculator WordPress plugin. | Review Queue |
| finengine-fintech | 1.0.0 |
WP.org / GitHub | Full-Site Editing (FSE) block theme for fintech and banking portals (Trac #293749). | Trac #293749 PASS |
Upcoming Horizon: FinEngine for WooCommerce (E-Commerce EMI)
Expanding our WordPress footprint into e-commerce: FinEngine EMI for WooCommerce brings automated, Daraj-style "Pay in Monthly EMI" simulation widgets directly to WooCommerce single product pages and checkout flows.
Automatically calculates and renders 3, 6, and 12-month installment options below product prices with partner bank schedules.
Dynamic checkout preview showing downpayment splits, monthly deductions, and bank processing fees with zero checkout lag.
Executes in browser JavaScript without database lookups or external server calls, preserving lightning-fast page loading speeds.
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 the FinEngine WordPress suite in under 5 seconds:
gmrafi/FinEngine-WP, activates both the plugin and theme, and routes directly to a pre-configured sample page displaying both the native block and shortcode implementations inside the financial layout.
Governance & Attribution
CFSBR Open Science Integrity
The FinEngine WordPress Ecosystem is developed and maintained under the institutional governance of the Centre for Fintech and Strategic Business Research (CFSBR). Conceived and architected by Md Golam Mubasshir Rafi, the initiative adheres to strict open science principles, deterministic actuarial reducing-balance specifications, and permanent CERN Zenodo archival.
- Author & Architect: Md Golam Mubasshir Rafi (gmrafi.com.bd ↗)
- Institutional Governance: Centre for Fintech and Strategic Business Research (CFSBR)
- WordPress Profile: profiles.wordpress.org/gmrafi ↗
- Contact: rafi@gmrafi.com.bd
- Software License: GNU General Public License v2 or later (GPL-2.0-or-later)
- Documentation License: Creative Commons Attribution 4.0 International (CC-BY 4.0)
Official Resources & Repositories
- Theme Trac Ticket: Trac #293749 (Review Queue) ↗
- Theme Trac Browser: finengine-fintech/1.0.0 ↗
- Central WordPress Suite Repo: gmrafi/FinEngine-WP ↗
- FinEngine Core Monorepo: gmrafi/FinEngine ↗
- Methodology Working Paper: CFSBR-FE-2026-001 (DOI: 10.67226/cfsbr.fe.2026.001.v1) ↗
- Zenodo Concept Archive: DOI: 10.5281/zenodo.22769501 ↗