Spelhubben Weather
| 开发者 | spelhubben |
|---|---|
| 更新时间 | 2026年1月31日 05:06 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
详情介绍:
- Shortcode
[spelhubben_weather], Gutenberg block, and classic widget - 6 Weather Providers: Open-Meteo, SMHI, Yr (MET Norway), FMI, Open-Weathermap, 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
- Leaflet Map: OpenStreetMap tiles with proper attribution (ODbL)
- 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 translations included Not affiliated with Open-Meteo, SMHI, Yr/MET Norway, FMI, Leaflet, or OpenStreetMap. Names are used for descriptive purposes only. Map data © OpenStreetMap contributors (ODbL).
安装:
- 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"]
- 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, and FMI (Finnish Meteorological Institute). You choose providers under Settings → Spelhubben Weather or per block/shortcode/widget via the providers attribute.
Do I need an API key?
No. Open-Meteo, SMHI, and FMI do not require keys. 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 tide support in version 1.9.7:
- 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 Leaflet map (OpenStreetMap). Control height with map_height="240" (px). Global defaults exist in settings.
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 the new phase and illumination fields to show moon information. Example shortcode: [spelhubben_weather show="temp,icon,phase,illumination"] — available in Block inspector and Widget options as well.
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. The map (Leaflet) requires JS.
Translations?
The plugin is fully translatable. Included translations: Swedish (sv_SE), Norwegian (nb_NO). Strings are also available on translate.wordpress.org. Ship .pot/.po/.mo in /languages.
GDPR / privacy?
The plugin does not set cookies by itself. If you enable the map, Leaflet/OpenStreetMap tiles are requested client-side. 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).
更新日志:
- = 1.9.7 =
- Experimental: Tide support added for testing — opt-in feature. Adds support for WorldTides (API key), NOAA (US-only), and a configurable custom endpoint. Shortcode support via
extras="tides"ortides="1". Admin visibility can be toggled while rolling out to selected users. Responses are cached; configure TTL in Settings. - = 1.9.5 =
- New: Moon phase support —
phase(name) andillumination(percent) available in renderer, shortcodes, block and widget. - = 1.9.4 =
- Fixed: Wind direction cardinal calculation and arrow rotation; ensured text-domain i18n call fixed for VC integration; asset sanitization workaround for wind arrow rotation (data-deg + frontend JS).
- = 1.9.3 =
- New:
wind_unitoverride in Block inspector, Widget settings and Shortcodes Quick Builder. - Improved:
metric_kntpreset for metric display with knots. - Fixed: Wind direction arrow rotation corrected to match compass degrees.
- Fixed: Shortcode
wind_unitreliably overrides resolved units and renderer emitsdata-svv-wind-unitfor debugging. - Fixed: Alert threshold comparisons now converted into display units to avoid false alerts.
- Fixed: PHP parse error in admin page resolved.
- Changed: Plugin version bumped to 1.9.3; readme stable tag updated.
- = 1.9.2 =
- New: Shortcode/Block/Widget
themeattribute —theme="auto|light|dark"to force UI theme per instance (defaultauto). - New: Quick Builder theme selector in admin Shortcodes page; example shortcode added.
- Improved: Renderer emits
data-svv-themeandsvv-theme-<value>class for easier CSS targeting. - Improved: Frontend CSS and map styling — darker Leaflet tiles in dark theme and darker alert box styles for better contrast.
- Changed: Admin JS updated to include
themewhen generating shortcodes; docs updated across readmes. - = 1.9.0 =
- New: Weather Alerts system with smart recommendations for extreme conditions
- New: Storm Warning alert for wind speeds exceeding 24.5 m/s
- New: Settings Export & Import feature for easy configuration management
- New: Performance Dashboard to track API usage, cache efficiency, and response times
- New: Full Dark Mode support for all frontend and admin interfaces
- New: 3 Gutenberg Block Patterns (Compact, Detailed, Forecast)
- New: Alert toggles for Blocks, Widgets, and Shortcodes
- New: Wind direction display (
wind_dir) — rotated arrow + cardinal labels (optional viashow=wind_dir) - New: Shortcode Quick Builder in admin Shortcodes page with selectable options, one-click copy and live preview
- New: Rotating Tips panel on the Settings page with contextual admin tips (Shortcodes, Alerts, Performance)
- New: Compact action buttons in the Tips panel for quick access to Shortcodes, Alerts and Performance
- New: "Reset to defaults" button on the Settings page (nonce-protected) to restore plugin defaults
- Improved: Tips text is translation-ready, rotates more slowly for readability (15s), and uses
aria-livefor accessibility - Improved:
animateattribute parsing is more tolerant (accepts1,true,yes,on) - Improved: Full English translation and i18n readiness (English is now the base language)
- Improved: Refined alert thresholds based on meteorological standards
- Fixed: Map not rendering in widgets due to missing Leaflet asset detection
- Fixed: Block name mismatch (
spelhubben/weather→spelhubben-weather/spelhubben-weather) preventing proper asset enqueuing - Improved: Enhanced Leaflet initialization with better timing and error handling in
map.js - Improved: Added widget detection in asset loading logic using
is_active_widget() - Improved: Added fallback height (
height: 240px;) to.svv-mapCSS class for better Leaflet container sizing - Improved: Better error reporting and retry logic in map initialization with Leaflet availability checks
- Performance: Conditional Leaflet asset loading — only loads when shortcode or Gutenberg block is present on the page.
- Fix: Added
.htaccessfiles to prevent WordPress rewrite rules from interfering with static assets. - Fix: Ensure correct MIME types for CSS and JS files to prevent browser strict MIME checking warnings.
- UX: Eliminates unnecessary 404 errors on pages without weather widget.
- Maintenance: Added centralized configuration constants file (
includes/constants.php) for improved code maintainability and reduced magic numbers. - Performance: Settings page now loads 6-30x faster with lazy-loaded WP.org plugin showcase via AJAX.
- Fix: Fixed memory leaks from uncleanup event listeners in admin interface with proper cleanup handlers.
- Fix: Fixed WMO weather code duplication—fog (codes 45, 48) now displays correctly instead of showing cloud icon.
- Fix: Fixed geocoding cache to include API language, ensuring proper locale-specific results for multi-language sites.
- Fix: Fixed widget null-safety with null-coalesce operators to prevent PHP Notices.
- Fix: Standardized API error handling with consistent response validation across all providers.
- Fix: Fixed syntax error in WP.org plugin showcase API call (missing closing parenthesis).
- Compliance: Verified full WordPress Consent API and GDPR compliance—no cookies, no tracking, no personal data collection.
- Code Quality: Debounce timeout optimized (400ms → 600ms) reducing AJAX traffic by 50% during live preview.
- Documentation: Comprehensive audit and testing guides included for developers.
- Version bump for production release.
- Fix: WordPress naming convention compliance – all global functions and variables now use proper
sv_vader_prefix. - Fix: Corrected asset paths for Leaflet library (vendor directory structure).
- Tech: Code review and standards compliance (no breaking changes).
- Tested up to: WordPress 6.9
- New: 3 selectable icon themes: Classic, Modern Flat, and Modern Gradient (set in Settings → Icon style).
- Performance: Optimized icon rendering with static variable caching for icon style preference (reduces repeated
sv_vader_get_options()calls). - Tech: Added private helper method
build_icon_url()to centralize icon URL logic and improve maintainability. - All icon themes include: sun, partly-cloudy, cloud, fog, rain, sleet, snow, thunderstorm (8 distinct weather conditions per theme).
- Updated README and readme.txt with icon theme documentation and admin settings guide.
- BREAKING CHANGE: Removed legacy
[sv_vader …]shortcode. Use[spelhubben_weather …]exclusively. - New Providers: Added Open-Weathermap and Weatherapi.com for better global coverage (6 total providers).
- New Feature:
comparison="1"attribute shows all providers' data side-by-side for easy comparison and debugging. - Performance: Fixed memory leak in map.js (persistent MutationObserver, proper ResizeObserver cleanup).
- Performance: Added 7-day transient caching for geocoding lookups to reduce external API calls.
- Performance: CSS containment (
contain: layout style paint) optimizes rendering on pages with multiple weather cards. - Caching: Improved debounce function to prevent race conditions during window resizes.
- Security: Fixed unsafe XML parsing in FMI provider (now uses
LIBXML_NOCDATAflag with proper error handling). - Feature: New plugin showcase on settings page displaying other Spelhubben plugins (grid layout, auto-fetches from WordPress.org).
- UX: Plugin showcase auto-excludes Spelhubben Weather itself to avoid redundancy.
- Tested up to: WordPress 6.8+
- Tested up to: 6.9
- New: FMI (Finnish Meteorological Institute) as a free, optional provider (t2m, ws_10min, r_1h, n_man via WFS). Toggle in Settings → Providers and via
providers="…"in block/shortcode/widget. - Shortcodes/Blocks:
providersnow acceptsfmi. - Docs: Updated examples and FAQ to include FMI.
- New: Shortcodes admin page with searchable examples, one-click copy & copy all.
- New: Live preview inside WP-admin (sandboxed iframe) that renders shortcodes and loads front assets (Leaflet, widget CSS/JS).
- New: Units & format settings (preset + overrides: temp/wind/precip units,
date_format). - New: Clear cache button (transients) on settings page.
- New: Translations included: Swedish (sv_SE), Norwegian (nb_NO), English (en_US).
- UX: Unified light card design across admin pages.
- Tech: Robust admin enqueue with cache-busting via
filemtime. - i18n: All admin strings localized (including JS: expand/collapse, statuses).
- Docs: Marked legacy shortcode as deprecated – will be removed soon.
- Minor fixes and readme updates.
- Version bump for WordPress.org sync. No functional changes.