Geoart Consumption widget

Just a simple plugin to show oil & gas usage information.

Shortcode

The default [consumption] shortcode displays U.S. oil and natural gas consumption. Use region="world" to select the world presets and fuel="oil" or fuel="gas" to display one fuel. Existing annual value, source, and unit parameters continue to override the presets. Use graphic="https://example.com/image.gif" to replace the default GIF and class="my-widget" to add custom wrapper classes.

Examples:

• [consumption]
• [consumption region="world"]
• [consumption fuel="oil"]
• [consumption region="world" fuel="gas"]

Data sources

• U.S. oil and natural gas: U.S. Energy Information Administration, 2025 data.
• World oil: U.S. Energy Information Administration Short-Term Energy Outlook, 2025 annual average.
• World natural gas: Energy Institute Statistical Review of World Energy 2026, 2025 consumption data.

Changelog

1.1

• Merge the remote custom-class and inherited-typography improvements into the modernized plugin.
• Document the shortcode class parameter and connect Gutenberg additional CSS classes to the complete widget.

1.0

• Add an in-dashboard documentation page for shortcodes, presets, graphics, and blocks.
• Add a Documentation link to the plugin row.

0.9

• Upgrade Plugin Update Checker from 4.9 to 5.7 and use its namespaced API.
• Replace the obsolete Gulp build with the current Sass Embedded CLI.
• Regenerate the dependency lock with no known npm vulnerabilities.
• Verify existing shortcode output and counter behavior in a browser with no console errors.

0.8

• Consolidate the fine-grained oil and natural gas blocks into one Consumption Counter block.
• Keep legacy counter block names renderable while hiding them from the inserter.
• Use the bundled drop, flame, and world GIFs as context-aware widget defaults.
• Run every frontend counter from one shared page timer.
• Extract preset and calculation logic and add automated tests.

0.7

• Add U.S. and world consumption presets.
• Add region and fuel selection to the complete widget block and shortcode.
• Add region selection to the fine-grained oil and natural gas blocks.
• Preserve explicit annual values as overrides for regional presets.
• Allow the complete widget block and shortcode to replace the default GIF.
• Give fine-grained counter blocks paragraph-level typography, color, spacing, alignment, and anchor controls.

0.6

• Add a complete Gutenberg block with options matching the consumption shortcode.
• Add fine-grained crude oil and natural gas number blocks with selectable consumption periods.
• Preserve the existing consumption shortcode and its options.
• Update the default consumption data and source label to 2025.
• Replace per-widget jQuery scripts with one shared vanilla JavaScript counter.
• Make annual and daily calculations timezone-aware and correct for leap years.
• Improve output escaping and plugin metadata.

0.2.11

• Updating the readme

0.2.6

• Plugin made public

0.2.5

• Test update push

0.2.3

• Added readme

0.2.0

• Added update functionality

0.1.2

• Update the year to 2019, data pulled to 2019