52 lines
2.1 KiB
Text
52 lines
2.1 KiB
Text
=== 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.
|