Spelhubben Weather
| 开发者 | spelhubben |
|---|---|
| 更新时间 | 2026年9月7日 21:57 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
详情介绍:
安装:
- Upload/activate the plugin.
- Go to Settings → Spelhubben Weather and set defaults (place, shown fields, layout, providers, cache time, units/format).
- Add weather to your site in any of these ways:
- Edit a page/post → click Add block → search for “Spelhubben Weather”.
- Optional: override defaults in the block sidebar (place/lat,lon, layout, map, forecast).
- Insert
[spelhubben_weather]anywhere shortcodes are supported. - Examples:
- Basic:
[spelhubben_weather] - Compact with map & animation:
[spelhubben_weather place="Gothenburg" layout="compact" map="1" animate="1"] - Inline no map:
[spelhubben_weather lat="57.7089" lon="11.9746" layout="inline" map="0" show="temp,icon"] - Detailed + daily forecast (5 days) + provider mix:
[spelhubben_weather place="Umeå" layout="detailed" forecast="daily" days="5" providers="smhi,yr,openmeteo,fmi"] - With wind direction:
[spelhubben_weather place="Stockholm" show="temp,wind,wind_dir,icon" layout="compact" animate="1"] - Compact hourly forecast:
[spelhubben_weather hourly="1" hours="24" layout="compact"] - OpenLayers map engine:
[spelhubben_weather map="1" map_engine="openlayers"] - Dashboard preset:
[spelhubben_weather preset="dashboard" hourly="1" map="1"]
- Go to Appearance → Widgets → add Spelhubben Weather.
- Configure per-widget options (title, place or lat/lon, fields, layout, map, forecast, days, CSS class).
屏幕截图:
常见问题:
Where does the data come from?
From public APIs such as Open-Meteo, SMHI, Yr/MET Norway, MET Norway Nowcast, FMI (Finnish Meteorological Institute), OpenWeatherMap, and WeatherAPI.com. You choose providers under Settings → Spelhubben Weather or per block/shortcode/widget via the providers attribute.
Do I need an API key?
Usually no. Open-Meteo, SMHI, Yr/MET Norway, MET Norway Nowcast, and FMI do not require keys. OpenWeatherMap and WeatherAPI.com do require API keys, and for Yr/MET Norway it’s recommended to include contact info (email/URL) in Settings → Spelhubben Weather → Yr contact/UA so your User-Agent is compliant.
Block, shortcode or widget — what’s the difference?
All three render the same UI. Use the block in the block editor, the shortcode in classic content areas, and the widget in sidebars (Appearance → Widgets). Each lets you override global defaults.
How do place and coordinates work?
Tide (experimental)
If you're testing experimental tide support:
- Enabling: Turn on
Tidesin Settings → Spelhubben Weather and select a provider (WorldTides, NOAA or Custom endpoint). WorldTides typically requires an API key. - Shortcode: Use
extras="tides"ortides="1"to show tide events, e.g.[spelhubben_weather place="Gothenburg" extras="tides"]. - Providers: WorldTides (global, commercial), NOAA Tides & Currents (US only), or supply a custom endpoint that returns JSON with
events/extremes/dataarrays (items should includetime, and optionallytypeandheight). - Troubleshooting: Use
tests/tide_test.phpto validate provider responses and caching. Ensure provider settings and API key are correct; tide results are cached according to the configured TTL.
lat and lon are provided they take precedence. Otherwise the plugin geocodes the place string (e.g. place="Umeå"). Set a global default place in settings.
What fields can I show/hide?
Use show="temp,wind,icon" (comma separated). Defaults are set in settings. Add wind_dir to show wind direction arrow and label.
How do layouts work?
Choose layout="inline|compact|card|detailed". “Detailed” supports the multi-day forecast row.
Can I see individual provider data (for comparison)?
Yes! Use comparison="1" to show all enabled providers' data side-by-side. Useful for debugging or comparing which providers are available in your location.
Example: [spelhubben_weather place="Stockholm" comparison="1" providers="openmeteo,smhi,yr,fmi,openweathermap,weatherapi"]
What icon themes are available?
The plugin offers multiple themes: Classic (traditional), Modern Flat (clean, minimalist), Modern Gradient (contemporary with subtle gradients), Modern 2026 (duotone/stroke modern style), and Modern 3D (subtle gradients + drop-shadows). Choose in Settings → Spelhubben Weather → Icon style. All themes include icons for sun, partly-cloudy (including alternate), cloud, fog, rain, sleet, snow, storm/thunder, and hail where applicable.
How do I enable the map and set its size?
map="1" shows a smart OpenStreetMap-powered map. By default map_engine="auto" tries OpenLayers first, then Leaflet legacy, then a static fallback with coordinates and an OSM link. You can force map_engine="openlayers|leaflet|static". Control height with map_height="240" (px). Global defaults exist in settings.
How do I get an hourly forecast?
Set hourly="1" and optionally hours="3–24". Example: hourly="1" hours="24". Hour labels follow the active site locale, such as 24-hour time for Swedish/Norwegian sites.
How do I enable animations?
animate="1" adds subtle UI animation. Global default is in settings. The renderer also accepts true, yes, or on as truthy values for convenience.
How do I get a daily forecast?
Set forecast="daily" and days="3–10". Example: forecast="daily" days="5".
How do I use moon phase?
Use extras="moon" to show moon phase in the weather meta area. Use extras="moon_daily" together with forecast="daily" to show moon information in the daily forecast. Example: [spelhubben_weather extras="moon"].
Can I mix providers and get a consensus?
Yes. Set providers="smhi,yr,openmeteo,fmi" (order doesn’t matter). The plugin calculates a simple consensus across available providers for the displayed fields.
Units & format?
Pick a preset with units="metric|metric_kmh|imperial". You can override parts via temp_unit="C|F", wind_unit="ms|kmh|mph", precip_unit="mm|in", and date_format for forecast labels. All have global defaults in settings (Units & format section).
Caching — how long is data stored?
Responses are cached with WordPress transients. Change TTL (minutes) in settings. Clear via the Clear cache button on the Performance page (Settings → Performance) or by changing attributes (which creates a new cache key).
Does it work without JavaScript?
Yes, rendering is server-side. Interactive maps require JS, but the map area can fall back to a static status with coordinates and an OpenStreetMap link.
Translations?
The plugin is fully translatable. Included translations: Swedish (sv_SE), Norwegian Bokmål (nb_NO). Strings are also available on translate.wordpress.org. Bundled translation files live in /languages and include .pot, .po, .mo, .l10n.php, and block editor JSON files.
GDPR / privacy?
The plugin does not set cookies by itself. If you enable the map, OpenStreetMap tiles are requested client-side by the local OpenLayers/Leaflet runtime. Mention OSM in your privacy notice if needed.
Troubleshooting tips
- Nothing shows: check that at least one provider is selected in settings.
- Wrong location: provide exact
lat/lonor a more specificplace(e.g. “Uddevalla, SE”). - Map not visible: ensure
map="1"and that your theme/container is wide/tall enough; increasemap_height. - Rate limiting: reduce refreshes or increase cache TTL.
Translations
The plugin is fully translatable and includes built-in translations for Swedish (sv_SE) and Norwegian Bokmål (nb_NO).
更新日志:
- Fixed: Incomplete installed language packs no longer leave wind, moon and other translated labels in English when bundled translations are available.
- Fixed: PHP and JavaScript catalogs preserve existing translations and use bundled messages to fill gaps, including after WordPress locale changes.
- Improved: Bundled translations are discovered by locale filename without a Swedish/Norwegian allowlist, supporting new languages and variants such as de_DE_formal.
- Fixed: Weather and location caches now distinguish full WordPress locales so language variants do not share translated results.
- Fixed: API language selection no longer forces non-Nordic languages to English. OpenWeatherMap and WeatherAPI use provider-specific language mappings, with English fallback for unsupported languages.
- Improved: Map fallback messages are translatable on the frontend, in the block editor and in admin previews; Swedish and Norwegian translations are included. Preview script data safely escapes translated text.
- Maintenance: Added translation compatibility checks for PHP/MO/JSON catalogs, custom overrides, locale switching, API languages and cache isolation, plus CI coverage using WordPress 6.8 and the latest release. Fixed Windows path handling in the regression test harness.
- Documentation: Updated the translation template and instructions for compiled catalogs, JavaScript translations, custom file locations and adding new locales.
- Security: Custom tide endpoints now require HTTPS and use WordPress's SSRF-safe HTTP client, blocking private and loopback network targets.
- Security: API key fields are masked and opt out of browser credential autofill.
- Security: Hardened generated moon markup output and resolved WordPress Plugin Check security and internationalization findings.
- Compatibility: Verified plugin activation, Gutenberg block insertion in the iframed editor, server-side block rendering, shortcodes, maps, frontend assets, and browser JavaScript with WordPress 7.1 RC2.
- Maintenance: Replaced the deprecated clean-css/glob build chain with esbuild, refreshed the dependency lockfile, and confirmed that npm reports no vulnerabilities or deprecated packages.
- Documentation: Updated the release notes and Tested up to metadata for WordPress 7.1. Obsolete live-demo links are no longer included because the hosted demo is unavailable.
- Fixed: Gutenberg blocks can explicitly disable the map even when maps are enabled globally.
- Fixed: Admin menus and settings are no longer registered twice.
- Fixed: Saving the main settings page now preserves alert thresholds and hidden tide provider settings.
- Fixed: Classic widget forms no longer emit PHP warnings for missing alert or daily moon defaults.
- Improved: Translation loading now runs on
initfor WordPress 6.7+ compatibility. - Improved: Added regression coverage for the WordPress compatibility fixes.
- Improved: WordPress 7.0 compatibility by moving the Gutenberg block and legacy block registration to Block API v3.
- Fixed: Block editor previews now load Spelhubben Weather content assets inside the iframed editor.
- Improved: Plugin metadata and asset versions now target WordPress 7.0 while keeping the minimum requirements at WordPress 6.8 and PHP 7.4.
- Added: Central provider registry shared by settings, renderer, shortcode/block/widget surfaces, diagnostics and documentation.
- Added: Real MET Norway Nowcast 2.0 current-weather provider with explicit
ok,missing_key,no_coverage,request_failed, andno_datadiagnostics. - Added: Compact hourly forecast via Open-Meteo using
hourly="1"andhours="3-24"(default24). - Changed: Removed the external Leaflet CDN fallback. Map scripts and vendor assets are now local-only.
- Changed: OpenWeatherMap and WeatherAPI are disabled by default on fresh installs until API keys are configured.
- Added: Smart map foundation with OpenLayers, Leaflet legacy mode, static fallback,
map_engine, and map diagnostics in Performance. - Improved: Shortcode, Gutenberg block and widget parity for hourly forecast, tides, presets and map engine attributes.
- Fixed: Admin settings layout no longer overlaps on wider forms, and bundled textdomain/script translations load consistently from
/languages. - Improved: Hourly forecast time labels now use a locale-aware compact format, e.g.
13:00for Swedish/Norwegian sites and1:00 PMfor US English. - Improved: CI now separates PHP lint, regression tests, asset-sync checks and release checks.
- Added: Admin settings for OpenWeatherMap and WeatherAPI keys, and runtime calls now send the correct key/query parameters.
- Fixed: Provider docs, settings text, and shortcode guidance now match the actual 7-provider matrix and API-key requirements.
- Fixed:
map_heightis clamped in the renderer too, so shortcode/block/widget overrides consistently honor the documented 120px minimum. - Fixed: Shortcodes admin/provider docs were unified and the Quick Builder now uses the same provider list as the shortcode reference.
- Fixed: Shortcodes admin layout was rebalanced so the examples column stays readable and the Quick Builder wraps more cleanly.
- Improved: Provider order is normalized in cache keys for better cache hit rates.
- Improved: Added reproducible asset-build and release-check scripts; refreshed
assets/map.min.jsand addedassets/style.min.css. - Improved: Privacy/consent documentation clarified for optional Leaflet/OpenStreetMap map fallback behavior.
- Fixed: Added default
unitsandyr_contactoptions to remove undefined index notices on new installs. - Fixed: Widget now initializes options before render so
wind_unitfallback is safe and notice-free. - Fixed: Admin attribution checker now uses the localized AJAX nonce (no more
nonce is not definederror). - Fixed: Rebuilt
assets/map.min.jsfrom the source to eliminate the stray syntax error and keep parity withmap.js.
- Urgent Fix: Ensure
assets/vendoris included in distribution packages (adjusted.distignorerules). This prevents missing Leaflet vendor files after packaging/deploy. - Fixed: Plugin version constant and admin asset versioning made consistent with the release.
- Documentation: Updated packaging notes and deploy recommendations.
- Fixed: Minor asset/enqueue edge-case causing Leaflet/map to fail loading on some paginated or special views where
$postis not available. - Fixed: Plugin version constant and admin asset versioning updated to reflect release
2.0.1. - Improved: Documentation updates and metadata cleaned up for the new release. Features
-
Shortcode
[spelhubben_weather], Gutenberg block, and classic widget - 7 Weather Providers: Open-Meteo, SMHI, Yr (MET Norway), MET Norway Nowcast, FMI, OpenWeatherMap, WeatherAPI.com — enable any combination
- Icon Themes: Classic, Modern Flat, Modern Gradient, Modern 2026, Modern 3D (selectable in admin settings)
- Multiple Layouts:
inline,compact,card,detailed - Daily Forecast: 3–10 days customizable
- Provider Comparison: Side-by-side data from all enabled providers
- Smart Map: OpenLayers by default, Leaflet legacy mode, static fallback and OpenStreetMap attribution (ODbL)
- Hourly Forecast: compact 3–24 hour timeline powered by Open-Meteo with locale-aware time labels
- Wind direction display: Rotated arrow with cardinal labels (optional via
show=wind_dir) - Local Icons: SVG icons (no CDN dependency), responsive scaling
- Performance: 6-30x faster settings page, lazy-loaded plugin showcase, optimized caching
- Fully GDPR Compliant: No cookies, no tracking, no personal data collection
- Translation-Ready: English base strings, Swedish and Norwegian Bokmål translations included Not affiliated with Open-Meteo, SMHI, Yr/MET Norway, MET Norway Nowcast, FMI, OpenLayers, Leaflet, or OpenStreetMap. Names are used for descriptive purposes only. Map data © OpenStreetMap contributors (ODbL).