WordPress Ecosystem v1.0.0 · Plugin & FSE Block Theme · CFSBR Computational Initiative

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).

Launch WordPress Playground Demo (1-Click) ↗ Theme Trac Ticket #293749 ↗ GitHub Repository ↗ FSE Patterns ↓ Shortcode Generator ↓
WordPress Plugin Review Active Theme Trac Ticket #293749 PASS FinEngine-WP on GitHub Version 1.0.0 GPL-2.0-or-later License Full Site Editing theme.json v3 100% Client-Side Privacy Sub-25KB Vanilla JS Bundle
FinEngine WordPress Suite: Official Visual Architecture Banner
FinEngine WordPress Ecosystem: Official Plugin & Block Theme Visual Architecture
PCP AUDIT: 100% PASS Submitted Oct 2, 2026
FinEngine Calculator (Plugin Review Queue)
Official computational plugin (slug: 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).
Explore Plugin Repository ↗
SCAN: PASS (TRAC #293749) Theme Directory Review
FinEngine Fintech (FSE Block Theme)
Full-Site Editing (FSE) block theme (slug: 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.
Trac Ticket #293749 ↗ Trac Browser ↗
Dual Architectural Design

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 WordPress Suite │ └──────────────────────────────┬──────────────────────────────┘ │ ┌───────────────┴───────────────┐ ▼ ▼ ┌─────────────────────────────┐ ┌─────────────────────────────┐ │ FinEngine Calculator │ │ FinEngine Fintech │ │ (WordPress Plugin) │ │ (WordPress Theme) │ ├─────────────────────────────┤ ├─────────────────────────────┤ │ • Actuarial reducing balance│ │ • Full-Site Editing (FSE) │ │ • Integer Poisha arithmetic │ │ • theme.json v3 token system│ │ • Terminal zero (Bₙ=0.00) │ │ • Financial block patterns │ │ • South Asian Lakh/Crore │ │ • Native Elementor support │ │ • Gutenberg Block & Code │ │ • Zero-bloat system fonts │ │ • 100% Client-side privacy │ │ • WCAG AAA accessible colors│ └─────────────────────────────┘ └─────────────────────────────┘
Component A · The Computational Engine

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.
Directory Slug: finengine-calculator GitHub Repo ↗
Component B · The Visual Architecture

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.json v3 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.html canvas template for drag-and-drop page builders.
  • Zero-Bloat Performance: Native system font stack, 0 external CDN requests, and pure CSS variables.
Directory Slug: finengine-fintech Trac Ticket #293749 ↗
System Integration

Cohesive Interoperability: How They Function Together

Both components are engineered to function independently or coalesce into a turnkey financial website solution:

Scenario 01
Standalone Plugin

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.

Scenario 02
Standalone Theme

Deploy finengine-fintech as a complete, lightweight FSE block theme for corporate banking, investment newsletters, and institutional finance portals with or without loan calculators.

Scenario 03
Combined Ecosystem

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.

Full-Site Editing (FSE) Patterns

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:

finengine-fintech/hero-finance

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.

Components: Heading, Metrics Grid, Action CTAs
finengine-fintech/kpi-grid

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.

Components: 3 Cards, Metric Counters, Accent Borders
finengine-fintech/calculator-section

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.

Components: Header, Embed Container, Compliance Notice
Live Demonstration

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:

Loan Principal Amount BDT 5,00,000
BDT 50,000 BDT 1,00,00,000 (1 Crore)
Annual Interest Rate (%) 12.0%
4.0% 28.0%
Repayment Tenure (Months) 36 Months (3 Years)
6 Months 120 Months (10 Years)
Monthly EMI
-
Total Interest
-
Total Repayment
-
Amortization Schedule (First 6 & Terminal Month) Bn == 0.00 Verified
Month Payment Principal Interest Balance
Mathematical Integrity

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:

Guarantee 01

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.

Guarantee 02

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).

Guarantee 03

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.

Guarantee 04

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.

Guarantee 05

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.

Guarantee 06

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.

Universal Shortcode

Interactive Shortcode Generator

Configure your desired parameters below to generate a production-ready shortcode snippet for any WordPress page, post, or widget:

[finengine_calculator currency="BDT" default_principal="500000" default_rate="12.0" default_tenure="36" locale="bn-BD" primary_color="#10b981"]

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.
Block Editor (Gutenberg)

Native WordPress Block Experience

FinEngine Calculator includes an official React block built against the WordPress Block API (v3):

Step 1
Insert Block

Type /finengine or search for FinEngine Loan Calculator in the block inserter.

Step 2
Sidebar Inspector

Fine-tune min/max ranges, step increments, default values, and accent colors in the sidebar settings panel.

Step 3
Live Editor Preview

Inspect the exact interactive calculator preview directly inside the Gutenberg editing canvas in real time.

Step 4
Instant Publishing

Publish or save changes. The calculator loads seamlessly for desktop, tablet, and mobile visitors.

Universal Compatibility

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
Ecosystem Parity

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
Future Roadmap · 1st Priority Expansion

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.

Feature 01
Single Product EMI Breakdown

Automatically calculates and renders 3, 6, and 12-month installment options below product prices with partner bank schedules.

Feature 02
Cart & Checkout Calculator

Dynamic checkout preview showing downpayment splits, monthly deductions, and bank processing fees with zero checkout lag.

Feature 03
100% Client-Side Privacy

Executes in browser JavaScript without database lookups or external server calls, preserving lightning-fast page loading speeds.

Track strategic progress on our Strategic Roadmap ↗
WebAssembly Sandbox

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:

Launch Disposable Blueprint Instance
No server, no database, no setup required. Runs entirely client-side.
Open Blueprint in Playground ↗
Blueprint Details: Provisions WordPress 6.6 with SQLite, clones the suite from 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