=== Font del Bosc — Combustible ===
Contributors: robotstxt
Tags: fuel, petrol stations, prices, mediona
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 1.0.0
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Fuel prices at the petrol stations nearest to Font del Bosc (Mediona, Alt Penedès), from the official MITECO open data.

== Description ==

Shows current fuel prices at the petrol stations closest to Font del Bosc, using the official Spanish Ministry (MITECO / MINETUR) open data API. No API key required.

* Nearest stations within a configurable radius (5–50 km), sorted by distance or price, rendered as a card grid with a Google Maps link per station.
* Fuel types configurable per site and per shortcode (defaults: Gasoline 95 E5, Gasoline 98 E5, Diesel A, Premium Diesel).
* Hourly cache with stale-on-error fallback, so an API outage never breaks the page.
* Sidebar widget with the three nearest stations for one fuel type.
* Built-in documentation section on the settings page, including the live fuel catalog with product IDs.
* English, Spanish and Catalan.

Attribution (mandatory, Orden ITC/2308/2007): Ministerio para la Transición Ecológica (MITECO), Spain.

== Installation ==

1. Upload the `fontdelbosc-combustible` folder to `/wp-content/plugins/`.
2. Activate the plugin on the Plugins screen.
3. Configure radius, fuels and display options under Settings → Font del Bosc Combustible.
4. Add `[fontdelbosc_combustible]` to a page or the widget to a sidebar.

No API keys are needed; data works out of the box.

== Frequently Asked Questions ==

= How fresh is the data? =

The Ministry updates prices at most once per day. The plugin caches for one hour by default and shows the API's own data timestamp.

= Where does the data come from? =

https://datos.gob.es/es/catalogo/e05068001-precio-de-carburantes-en-las-gasolineras-espanolas

== Screenshots ==

1. Station list rendered by the shortcode.

== Changelog ==

= 1.0.0 =
* Initial release: shortcode, widget, admin settings, caching with stale fallback, es_ES/ca translations.