ROBOTSTXT/fontdelbosc-combustible
Watch
0
0
Fork
You've already forked fontdelbosc-combustible
 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions

v1.0.0

Browse source
This commit is contained in:
Javier Casares 2026-10-12 13:25:09 +00:00
commit e1f5a47c96
22 changed files with 3155 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

52
readme.txt Normal file
View file

@ -0,0 +1,52 @@
=== 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.