Calculators · Gutenberg
Currency Converter block for WordPress
Interactive currency converter supporting 30+ world currencies with instant conversion, swap button, common pairs quick-select, and customizable styling. Uses built-in indicative rates.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
Interactive currency converter supporting 30+ world currencies with instant conversion, swap button, common pairs quick-select, and customizable styling. Uses built-in indicative rates.
Inspector panels on this block: Content, Defaults, Display Options, Sizing. Those titles come from index.js, not from a shared template.
Where to find it
Gutenberg inserter → Calculators → search “Currency Converter” (block name `blockenberg/currency-converter` in block.json). Style it in the sidebar after insert.
How to use Currency Converter block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Currency Converter”, insert it. Category: Calculators.
- Configure inspector controls that exist on this block. Open Content. Set “Show Title”, “Content — Title”, “Show Subtitle”, “Subtitle”.
- Check the published page. The view script reads HTML data attributes: data-from, data-opts, data-to. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Show Title | On/off toggle in the inspector. On by default. Saved as `showTitle`. |
| Content — Title | Text field in the inspector. block.json default: Currency Converter. Saved as `title`. |
| Show Subtitle | On/off toggle in the inspector. On by default. Saved as `showSubtitle`. |
| Subtitle | Text field in the inspector. block.json default: Convert between major world currencies instantly.. Saved as `subtitle`. |
| Default From Currency | Select control; the chosen value is saved on the block. block.json default: USD. Saved as `defaultFrom`. |
| Default To Currency | Select control; the chosen value is saved on the block. block.json default: EUR. Saved as `defaultTo`. |
| Default Amount | Numeric range control in the inspector. Range 1–100000. block.json default: 100. Saved as `defaultAmount`. |
| Show Swap Button | On/off toggle in the inspector. On by default. Saved as `showSwapBtn`. |
| Show Quick Pair Buttons | On/off toggle in the inspector. On by default. Saved as `showQuickPairs`. |
| Show Disclaimer | On/off toggle in the inspector. On by default. Saved as `showDisclaimer`. |
| Disclaimer Text | Multiline text field in the inspector. block.json default: Rates are indicative and updated periodically. Not for financial use.. Saved as `disclaimer`. |
| Typography — Title | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `typoTitle`. |
| Result Number | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `typoResult`. |
| Label font size (px) | Numeric range control in the inspector. Range 10–18. block.json default: 12. Saved as `labelFontSize`. |
| Accent Color | Color control in the inspector. block.json default: #6c3fb5. Saved as `accentColor`. |
| Result Number Color | Color control in the inspector. block.json default: #6c3fb5. Saved as `resultColor`. |
| Quick Pair Background | Color control in the inspector. block.json default: #f3f4f6. Saved as `quickPairBg`. |
| Result Background | Color control in the inspector. block.json default: #f5f3ff. Saved as `resultBg`. |
| Card Background | Color control in the inspector. block.json default: #ffffff. Saved as `cardBg`. |
| Section Background | Color control in the inspector. Saved as `bgColor`. |
| Card Radius (px) | Numeric range control in the inspector. Range 0–40. block.json default: 16. Saved as `cardRadius`. |
| Max Width (px) | Numeric range control in the inspector. Range 320–1200. block.json default: 580. Saved as `maxWidth`. |
| Padding Top (px) | Numeric range control in the inspector. Range 0–160. block.json default: 60. Saved as `paddingTop`. |
| Padding Bottom (px) | Numeric range control in the inspector. Range 0–160. block.json default: 60. Saved as `paddingBottom`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-from, data-opts, data-to.
When this is the right block
- Interactive currency converter supporting 30+ world currencies with instant conversion, swap button, common pairs quick-select, and customizable styling. Uses built-in indicative rates — that is the job of Currency Converter, not a generic content block.
- Use it when you need the editor control labeled “Show Title”, which exists on this block’s inspector.
- It matches pages about currency, converter, exchange.
- Inserter grouping: tools, lead magnets, and interactive widgets.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Currency Converter block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Currency Converter”. It sits under Calculators. After insert, open Content and set “Show Title”, “Content — Title”, “Show Subtitle”, “Subtitle”.
What makes Currency Converter different from other Blockenberg blocks?
Interactive currency converter supporting 30+ world currencies with instant conversion, swap button, common pairs quick-select, and customizable styling. Uses built-in indicative rates. Inspector labels on this block include “Show Title”, “Content — Title”, “Show Subtitle”, “Subtitle”.
Is the Currency Converter Gutenberg block free?
Yes. Currency Converter ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Currency Converter to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Content, Defaults, Display Options, Sizing).
Related calculators blocks
Savings Calculator
An interactive compound interest savings calculator. Enter initial deposit, monthly contribution, annual interest rate, and years to see total savings, interest earned, and a year-by-year growth breakdown.
Compound Interest Calculator
Calculate compound interest growth with configurable compounding frequency, monthly contributions, and a year-by-year breakdown.
Loan Calculator
Interactive mortgage and loan calculator with sliders for loan amount, interest rate, and term. Displays monthly payment, total interest, and total cost. Optional amortization schedule and doughnut chart.
Monthly Budget Planner
Interactive monthly budget planner with income and expense categories. Track spending, visualise balance and see how much is left to allocate.
Net Worth Calculator
Track assets and liabilities to calculate total net worth. Categorised inputs for cash, investments, real estate, vehicles, and various debt types.
Number Base Converter
Convert numbers between binary, octal, decimal, and hexadecimal with live cross-conversion.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Currency Converter from the Gutenberg inserter.