Calculators · Gutenberg

Fuel Calculator block for WordPress

Calculate road trip fuel costs, consumption, and CO₂ emissions. Supports MPG, L/100km, and km/L efficiency units with round-trip and cost-per-person options.

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.

Get Blockenberg

What it actually does

Calculate road trip fuel costs, consumption, and CO₂ emissions. Supports MPG, L/100km, and km/L efficiency units with round-trip and cost-per-person options.

Inspector panels on this block: Header, Calculator Defaults, Display Options, Sizing. Those titles come from index.js, not from a shared template.

Behavior controls: “Fuel Unit System” options: MPG (US), L/100km, km/L.

Where to find it

Gutenberg inserter → Calculators → search “Fuel Calculator” (block name `blockenberg/fuel-calculator` in block.json). Style it in the sidebar after insert.

How to use Fuel Calculator block for WordPress

  1. Install Blockenberg. Install from WordPress.org and activate the plugin.
  2. Insert the block. Edit a page, click +, search for “Fuel Calculator”, insert it. Category: Calculators.
  3. Configure inspector controls that exist on this block. Open Header. Set “Show Title”, “Header — Title”, “Show Subtitle”, “Subtitle”.
  4. Check the published page. The view script reads HTML data attributes: data-opts. The block editor preview may not run the same view script.

Inspector controls from this block’s code

ControlWhat the code does
Show TitleOn/off toggle in the inspector. On by default. Saved as `showTitle`.
Header — TitleText field in the inspector. block.json default: Fuel Cost Calculator. Saved as `title`.
Show SubtitleOn/off toggle in the inspector. On by default. Saved as `showSubtitle`.
SubtitleText field in the inspector. block.json default: Estimate your road trip fuel costs and emissions.. Saved as `subtitle`.
Fuel Unit SystemSelect control; the chosen value is saved on the block. Options: MPG (US); L/100km; km/L. block.json default: mpg. Saved as `unit`.
Currency SymbolText field in the inspector. block.json default: $. Saved as `currency`.
Default DistanceText field in the inspector.
Default Fuel EfficiencyText field in the inspector.
Default Fuel PriceText field in the inspector.
Default PassengersText field in the inspector.
Show Round-Trip CostOn/off toggle in the inspector. On by default. Saved as `showRoundTrip`.
Show Cost Per PersonOn/off toggle in the inspector. On by default. Saved as `showPerPerson`.
Show Fuel Used (L / gal)On/off toggle in the inspector. On by default. Saved as `showLitres`.
Show CO₂ EmissionsOn/off toggle in the inspector. On by default. Saved as `showCO2`.
AccentColor control in the inspector. block.json default: #6c3fb5. Saved as `accentColor`.
Card BackgroundColor control in the inspector. block.json default: #ffffff. Saved as `cardBg`.
Result Box BGColor control in the inspector. block.json default: #f5f3ff. Saved as `resultBg`.
Result Box BorderColor control in the inspector. block.json default: #ede9fe. Saved as `resultBorder`.
Total Cost ColorColor control in the inspector. block.json default: #6c3fb5. Saved as `totalColor`.
Stat Card BGColor control in the inspector. block.json default: #f9fafb. Saved as `statCardBg`.
CO₂ ColorColor control in the inspector. block.json default: #10b981. Saved as `co2Color`.
Title ColorColor control in the inspector. block.json default: #1e1b4b. Saved as `titleColor`.
Subtitle ColorColor control in the inspector. block.json default: #6b7280. Saved as `subtitleColor`.
Label ColorColor control in the inspector. block.json default: #374151. Saved as `labelColor`.
Section BackgroundColor control in the inspector. Saved as `sectionBg`.
Card Radius (px)Numeric range control in the inspector. Range 0–32. block.json default: 16. Saved as `cardRadius`.
Input Radius (px)Numeric range control in the inspector. Range 0–20. block.json default: 8. Saved as `inputRadius`.
Max Width (px)Numeric range control in the inspector. Range 320–960. block.json default: 620. 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

When this is the right block

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 Fuel Calculator block in WordPress?

Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Fuel Calculator”. It sits under Calculators. After insert, open Header and set “Show Title”, “Header — Title”, “Show Subtitle”, “Subtitle”.

Does Fuel Calculator need a server or extra plugin?

No. After Blockenberg is active, the view script runs in the browser with the values you saved on the block.

Is the Fuel Calculator Gutenberg block free?

Yes. Fuel Calculator ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.

Can I style Fuel Calculator 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: Header, Calculator Defaults, Display Options, Sizing).

Related calculators blocks

Get Blockenberg

Install Blockenberg from WordPress.org, then insert Fuel Calculator from the Gutenberg inserter.

Get Blockenberg