Kenta Mattsson

This plugin displays current weather and an optional forecast. It can aggregate data from free global weather providers (Open-Meteo, SMHI, Yr/MET Norway, MET Norway Nowcast, FMI, OpenWeatherMap, and WeatherAPI.com) and compute a simple consensus. Works worldwide with excellent coverage in Europe and beyond.
<h3>License</h3>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
Full license text is included in the <code>LICENSE</code> file in the plugin root.
<h3>Feedback & Bug Reports</h3>
Feedback and bug reports can be posted here: https://github.com/K3NT4/spelhubben-weather/issues 
For common questions see the FAQ: https://github.com/K3NT4/spelhubben-weather/blob/main/Docs/FAQ.md 
For Roadmap: https://github.com/users/K3NT4/projects/2
Weather widget & block with optional map and daily forecast. Can combine Open-Meteo, SMHI, Yr/MET, MET Norway Nowcast, FMI, OpenWeatherMap, and WeatherAPI.com data.
<h3>Translations</h3>
The plugin is fully translatable and includes built-in translations for Swedish (sv_SE) and Norwegian Bokmål (nb_NO).
<h3>How to translate the plugin</h3>
Option 1: Contribute to translate.wordpress.org (recommended) 
– Visit <a href="https://translate.wordpress.org/projects/wp-plugins/spelhubben-weather/" rel="nofollow ugc">translate.wordpress.org</a> 
– Select your language and add translations via the browser interface 
– Your translations will automatically be included in future releases
Option 2: Local translation files 
If you need to add or modify translations locally:
<ol>
<li>
Generate or update the POT file (translation template): 
 <code>wp i18n make-pot . languages/spelhubben-weather.pot --slug=spelhubben-weather</code>
</li>
<li>
Create a PO file for your language (e.g., <code>spelhubben-weather-de_DE.po</code>):
<ul>
<li>Copy the <code>.pot</code> file and rename to match your locale (e.g., <code>de_DE</code>)</li>
<li>Use a translation tool like <a href="https://poedit.net/" rel="nofollow ugc">Poedit</a> or a text editor</li>
<li>Translate all strings in the PO file</li>
<li>Save the file as <code>spelhubben-weather-de_DE.po</code></li>
</ul>
</li>
<li>
Generate the MO file (compiled binary format): 
 <code>msgfmt spelhubben-weather-de_DE.po -o spelhubben-weather-de_DE.mo</code>
</li>
<li>
Place files in the plugin:
<ul>
<li>Store both <code>.po</code> and <code>.mo</code> files in <code>/languages/</code></li>
<li>If you bundle translations with the plugin, also keep generated <code>.l10n.php</code> files and block editor JSON files in sync with the PO/MO files.</li>
</ul>
</li>
<li>
Activate your translation:
<ul>
<li>Change your WordPress language to match the locale code (Settings → General → Site Language)</li>
<li>The plugin will automatically load the translated strings</li>
</ul>
</li>
</ol>
Translation file structure: 
 <code>languages/ 
 spelhubben-weather.pot (template for all translations) 
 spelhubben-weather-sv_SE.po (Swedish source text) 
 spelhubben-weather-sv_SE.mo (Swedish compiled) 
 spelhubben-weather-sv_SE.l10n.php 
 spelhubben-weather-nb_NO.po (Norwegian source text) 
 spelhubben-weather-nb_NO.mo (Norwegian compiled) 
 spelhubben-weather-nb_NO.l10n.php</code>
What gets translated: 
– All frontend strings (shortcode output, widget labels, weather descriptions, WMO codes) 
– Admin settings and UI labels 
– JavaScript strings (expand/collapse, status messages) 
– Error messages and notices
Best practices: 
– Use context clues in the POT file (<code>msgctxt</code>) to distinguish similar phrases 
– Test your translation in WordPress to ensure formatting and plurals work correctly 
– Check that translated UI aligns properly in your language (RTL vs LTR)
<h3>Older Changelog</h3>
<h4>2.0.0</h4>
<ul>
<li>FIX: Leaflet map now loads correctly on paginated, archive and guest pages where the global <code>$post</code> may be unavailable. Asset loader now scans the main query for shortcodes/blocks and enqueues Leaflet assets accordingly.</li>
<li>CHANGE: Bumped version to 2.0.0.</li>
</ul>
<h4>1.9.9</h4>
<ul>
<li>
FIX: Leaflet/map is now displayed correctly even for guests and special pages where $post is not set (fallback to get_queried_object()).
</li>
<li>
= 1.9.8 =
</li>
<li>Fixed: Fixed an issue where the Leaflet map could fail to load on live/optimized sites due to script handle conflicts with themes or other plugins.</li>
<li>Improved: Renamed Leaflet asset handles to unique, plugin-specific names to prevent collisions and ensure correct dependency resolution.</li>
<li>Improved: Removed forced defer handling for Leaflet/map scripts to avoid broken load order when caching/optimization plugins are active.</li>
<li>Improved: Improved map initialization logic to prevent infinite retry loops and reduce console spam when Leaflet isn’t available.</li>
<li>
Improved: Kept Leaflet/map assets conditionally loaded only on pages where the widget/block/shortcode is actually rendered.
</li>
<li>
= 1.9.7 =
</li>
<li>
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 <code>extras="tides"</code> or <code>tides="1"</code>. Admin visibility can be toggled while rolling out to selected users. Responses are cached; configure TTL in Settings.
</li>
<li>
= 1.9.5 =
</li>
<li>
New: Moon phase support via <code>extras="moon"</code> and daily moon information via <code>extras="moon_daily"</code>.
</li>
<li>
= 1.9.4 =
</li>
<li>
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).
</li>
<li>
= 1.9.3 =
</li>
<li>New: <code>wind_unit</code> override in Block inspector, Widget settings and Shortcodes Quick Builder.</li>
<li>Improved: <code>metric_knt</code> preset for metric display with knots.</li>
<li>Fixed: Wind direction arrow rotation corrected to match compass degrees.</li>
<li>Fixed: Shortcode <code>wind_unit</code> reliably overrides resolved units and renderer emits <code>data-svv-wind-unit</code> for debugging.</li>
<li>Fixed: Alert threshold comparisons now converted into display units to avoid false alerts.</li>
<li>Fixed: PHP parse error in admin page resolved.</li>
<li>Changed: Plugin version bumped to 1.9.3; readme stable tag updated.</li>
<li>= 1.9.2 =</li>
<li>New: Shortcode/Block/Widget <code>theme</code> attribute — <code>theme="auto|light|dark"</code> to force UI theme per instance (default <code>auto</code>).</li>
<li>New: Quick Builder theme selector in admin Shortcodes page; example shortcode added.</li>
<li>Improved: Renderer emits <code>data-svv-theme</code> and <code>svv-theme-<value></code> class for easier CSS targeting.</li>
<li>Improved: Frontend CSS and map styling — darker Leaflet tiles in dark theme and darker alert box styles for better contrast.</li>
<li>
Changed: Admin JS updated to include <code>theme</code> when generating shortcodes; docs updated across readmes.
</li>
<li>
= 1.9.0 =
</li>
<li>New: Weather Alerts system with smart recommendations for extreme conditions</li>
<li>New: Storm Warning alert for wind speeds exceeding 24.5 m/s</li>
<li>New: Settings Export & Import feature for easy configuration management</li>
<li>New: Performance Dashboard to track API usage, cache efficiency, and response times</li>
<li>New: Full Dark Mode support for all frontend and admin interfaces</li>
<li>New: 3 Gutenberg Block Patterns (Compact, Detailed, Forecast)</li>
<li>New: Alert toggles for Blocks, Widgets, and Shortcodes</li>
<li>New: Wind direction display (<code>wind_dir</code>) — rotated arrow + cardinal labels (optional via <code>show=wind_dir</code>)</li>
<li>New: Shortcode Quick Builder in admin Shortcodes page with selectable options, one-click copy and live preview
<ul>
<li>New: Rotating Tips panel on the Settings page with contextual admin tips (Shortcodes, Alerts, Performance)</li>
<li>New: Compact action buttons in the Tips panel for quick access to Shortcodes, Alerts and Performance</li>
<li>New: “Reset to defaults” button on the Settings page (nonce-protected) to restore plugin defaults</li>
<li>Improved: Tips text is translation-ready, rotates more slowly for readability (15s), and uses <code>aria-live</code> for accessibility</li>
</ul>
</li>
<li>Improved: <code>animate</code> attribute parsing is more tolerant (accepts <code>1</code>, <code>true</code>, <code>yes</code>, <code>on</code>)</li>
<li>Improved: Full English translation and i18n readiness (English is now the base language)</li>
<li>Improved: Refined alert thresholds based on meteorological standards</li>
</ul>
<h4>1.8.6</h4>
<ul>
<li>Fixed: Map not rendering in widgets due to missing Leaflet asset detection</li>
<li>Fixed: Block name mismatch (<code>spelhubben/weather</code> → <code>spelhubben-weather/spelhubben-weather</code>) preventing proper asset enqueuing</li>
<li>Improved: Enhanced Leaflet initialization with better timing and error handling in <code>map.js</code></li>
<li>Improved: Added widget detection in asset loading logic using <code>is_active_widget()</code></li>
<li>Improved: Added fallback height (<code>height: 240px;</code>) to <code>.svv-map</code> CSS class for better Leaflet container sizing</li>
<li>Improved: Better error reporting and retry logic in map initialization with Leaflet availability checks</li>
</ul>
<h4>1.8.5</h4>
<ul>
<li>Performance: Conditional Leaflet asset loading — only loads when shortcode or Gutenberg block is present on the page.</li>
<li>Fix: Added <code>.htaccess</code> files to prevent WordPress rewrite rules from interfering with static assets.</li>
<li>Fix: Ensure correct MIME types for CSS and JS files to prevent browser strict MIME checking warnings.</li>
<li>UX: Eliminates unnecessary 404 errors on pages without weather widget.</li>
</ul>
<h4>1.8.4</h4>
<ul>
<li>Maintenance: Added centralized configuration constants file (<code>includes/constants.php</code>) for improved code maintainability and reduced magic numbers.</li>
<li>Performance: Settings page now loads 6-30x faster with lazy-loaded WP.org plugin showcase via AJAX.</li>
<li>Fix: Fixed memory leaks from uncleanup event listeners in admin interface with proper cleanup handlers.</li>
<li>Fix: Fixed WMO weather code duplication—fog (codes 45, 48) now displays correctly instead of showing cloud icon.</li>
<li>Fix: Fixed geocoding cache to include API language, ensuring proper locale-specific results for multi-language sites.</li>
<li>Fix: Fixed widget null-safety with null-coalesce operators to prevent PHP Notices.</li>
<li>Fix: Standardized API error handling with consistent response validation across all providers.</li>
<li>Fix: Fixed syntax error in WP.org plugin showcase API call (missing closing parenthesis).</li>
<li>Compliance: Verified full WordPress Consent API and GDPR compliance—no cookies, no tracking, no personal data collection.</li>
<li>Code Quality: Debounce timeout optimized (400ms → 600ms) reducing AJAX traffic by 50% during live preview.</li>
<li>Documentation: Comprehensive audit and testing guides included for developers.</li>
</ul>
<h4>1.8.3</h4>
<ul>
<li>Version bump for production release.</li>
</ul>
<h4>1.8.2</h4>
<ul>
<li>Fix: WordPress naming convention compliance – all global functions and variables now use proper <code>sv_vader_</code> prefix.</li>
<li>Fix: Corrected asset paths for Leaflet library (vendor directory structure).</li>
<li>Tech: Code review and standards compliance (no breaking changes).</li>
<li>Tested up to: WordPress 6.9</li>
</ul>
<h4>1.8.1</h4>
<ul>
<li>New: 3 selectable icon themes: Classic, Modern Flat, and Modern Gradient (set in Settings → Icon style).</li>
<li>Performance: Optimized icon rendering with static variable caching for icon style preference (reduces repeated <code>sv_vader_get_options()</code> calls).</li>
<li>Tech: Added private helper method <code>build_icon_url()</code> to centralize icon URL logic and improve maintainability.</li>
<li>All icon themes include: sun, partly-cloudy, cloud, fog, rain, sleet, snow, thunderstorm (8 distinct weather conditions per theme).</li>
<li>Updated README and readme.txt with icon theme documentation and admin settings guide.</li>
</ul>
<h4>1.8.0</h4>
<ul>
<li>BREAKING CHANGE: Removed legacy <code>[sv_vader …]</code> shortcode. Use <code>[spelhubben_weather …]</code> exclusively.</li>
<li>New Providers: Added Open-Weathermap and Weatherapi.com for better global coverage (6 total providers).</li>
<li>New Feature: <code>comparison="1"</code> attribute shows all providers’ data side-by-side for easy comparison and debugging.</li>
<li>Performance: Fixed memory leak in map.js (persistent MutationObserver, proper ResizeObserver cleanup).</li>
<li>Performance: Added 7-day transient caching for geocoding lookups to reduce external API calls.</li>
<li>Performance: CSS containment (<code>contain: layout style paint</code>) optimizes rendering on pages with multiple weather cards.</li>
<li>Caching: Improved debounce function to prevent race conditions during window resizes.</li>
<li>Security: Fixed unsafe XML parsing in FMI provider (now uses <code>LIBXML_NOCDATA</code> flag with proper error handling).</li>
<li>Feature: New plugin showcase on settings page displaying other Spelhubben plugins (grid layout, auto-fetches from WordPress.org).</li>
<li>UX: Plugin showcase auto-excludes Spelhubben Weather itself to avoid redundancy.</li>
<li>Tested up to: WordPress 6.8+</li>
</ul>
<h4>1.7.5</h4>
<ul>
<li>Tested up to: 6.9</li>
<li>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 <code>providers="…"</code> in block/shortcode/widget.</li>
<li>Shortcodes/Blocks: <code>providers</code> now accepts <code>fmi</code>.</li>
<li>Docs: Updated examples and FAQ to include FMI.</li>
</ul>
<h4>1.7.0</h4>
<ul>
<li>New: Shortcodes admin page with searchable examples, one-click copy & copy all.</li>
<li>New: Live preview inside WP-admin (sandboxed iframe) that renders shortcodes and loads front assets (Leaflet, widget CSS/JS).</li>
<li>New: Units & format settings (preset + overrides: temp/wind/precip units, <code>date_format</code>).</li>
<li>New: Clear cache button (transients) on settings page.</li>
<li>New: Translations included: Swedish (sv_SE), Norwegian (nb_NO), English (en_US).</li>
<li>UX: Unified light card design across admin pages.</li>
<li>Tech: Robust admin enqueue with cache-busting via <code>filemtime</code>.</li>
<li>i18n: All admin strings localized (including JS: expand/collapse, statuses).</li>
<li>Docs: Marked legacy shortcode as deprecated – will be removed soon.</li>
</ul>
<h4>1.6.2</h4>
<ul>
<li>Minor fixes and readme updates.</li>
</ul>
<h4>1.6.1</h4>
<ul>
<li>Version bump for WordPress.org sync. No functional changes.</li>
</ul>

Spelhubben Weather

Weather widget, Gutenberg block and shortcode with hourly forecasts, smart local maps and multi-provider forecasts.

Weather Atlas

The Weather Widget with the Most Active Installations on WordPress.org
NEW FEATURE! 
ENHANCE YOUR WEBSITE BY DEDICATING AN ENTIRE PAGE TO THE WEATHER.
In addition to all relevant weather information, the widget has the option to display 
DETAILED TEXTUAL DAILY AND LONG-TERM weather forecast.
Full page demo (live sites example) 
* <a href="https://stormandoutage.com/weather-center/" rel="nofollow ugc">stormandoutage.com</a>
Widget demo (live sites example) 
* <a href="https://www.marbella-tennis-lessons.com/en/tennis-weather/" rel="nofollow ugc">marbella-tennis-lessons.com</a> 
* <a href="https://www.morethangolfmarrakech.co.uk/dependableweather/" rel="nofollow ugc">morethangolfmarrakech.co.uk</a> 
* <a href="https://www.airciu.com/" rel="nofollow ugc">airciu.com</a> 
* <a href="https://ballinghambolstonehentland-pc.gov.uk/" rel="nofollow ugc">ballinghambolstonehentland-pc.gov.uk</a> 
* <a href="https://panarbora.de/" rel="nofollow ugc">panarbora.de</a> 
* <a href="https://theamericanmag.com/" rel="nofollow ugc">theamericanmag.com</a> 
* <a href="https://lindos-weddings-venue.com/" rel="nofollow ugc">lindos-weddings-venue.com</a>
<h4>Weather Atlas Widget is:</h4>
<ul>
<li>Highly Customizable: Modify design to present data in various forms incl. languages and units</li>
<li>Responsive: Automatically adapts appearance for mobile displays, ensuring optimal viewing on any device</li>
<li>Smart: Background and borders change according to current temperature; widget’s font size adjusts to match the website’s font and page placement</li>
<li>Beautiful: Elegant weather condition icons are simple and adapt in size, color, and shades to the widget’s text</li>
<li>Simple: All options are easy-to-change, and, above all, Weather information is presented in a clear and concise way</li>
</ul>
<h4>Features</h4>
<ul>
<li>Responsive Web Design: Adapts to mobile displays</li>
<li>Easy Styling: Effortlessly styles to suit your theme</li>
<li>Weather Icons: Visually appealing and informative</li>
<li>Comprehensive Data: Current conditions, hourly, and long-term forecast</li>
<li>Detailed Forecast: In-depth weather information</li>
<li>Flexible Placement: Suitable for content or sidebar</li>
<li>Global Reach: Covers worldwide locations</li>
<li>Multilingual and Unit Support: Accommodates multiple languages and units</li>
<li>Multiple Widgets Option: Allows for multiple simultanious widget implementations</li>
<li>Simple Setup: Easy to configure and use 
and</li>
<li>Key-Free Operation: No need to register for keys; the widget just works 🙂</li>
</ul>
<h4>Responsive Web Design</h4>
When placed in a horizontal layout (e.g., within an article), the widget reformats to a vertical layout on mobile devices. 
Details of the current condition (such as feels-like temperature, wind, humidity, pressure, UV index) and forecasts extending beyond 3 hours/days are hidden on mobile devices to maintain an uncluttered appearance and preserve the design on narrow displays.
<h4>Easy Styling</h4>
Choose from two predefined layouts (vertical and horizontal) and customize the widget to fit your website. 
Font size can be manually set (in px, pt, em, rem, %, etc.) to override the automatic adjustment to the website’s font size and page placement. 
Background color, which adapts to the current temperature, can be set to a fixed color, including transparency options. 
Text color, automatically optimized for contrast against the background, can also be manually overridden.
<h4>Weather Icons</h4>
The weather condition icons are elegantly designed, simple, and adapt in size, color, and shade to match the widget’s text.
<h4>Comprehensive Data</h4>
Select from a range of weather information, including current conditions, hourly, and long-term forecasts. 
Current conditions display temperature, weather icon, feels-like temperature, wind, humidity, pressure, UV index, and sunrise/sunset times. 
Hourly forecasts provide up to 5 hours of temperature predictions with weather icons, while the daily forecast offers up to 5 days of high/low temperatures and weather conditions.
<h4>Versatile Placement</h4>
The Weather Atlas Widget is designed for flexibility, allowing placement either in a sidebar or within the main content of your site. 
It supports integration through user-friendly Gutenberg blocks or via a simple shortcode option, offering versatility and ease of use within your WordPress site.
<h4>Worldwide Locations</h4>
Access over 800,000 locations from 238 countries and territories. Your location is likely included 🙂
<h4>Languages</h4>
The widget automatically selects the language based on your site’s language settings (Settings / General / Site Language). 
If a local translation is unavailable, it defaults to English. 
Local translations can be updated for further customization.
<h4>Units</h4>
Weather data is displayed in either the Imperial (°F, in, mi) or Metric system (°C, mb, mm, km).
<h4>Multiple Widgets Option</h4>
Multiple widgets can be placed on the same page, each with individual settings and operating independently. 
The widgets display cached weather data from your database and periodically update from our service, ensuring no slowdown to your website.
<h4>Easy Setup</h4>
All options are straightforward to configure. For further assistance, please visit our <a href="../plugins/weather-atlas/#faq" rel="nofollow ugc">FAQ</a> and then drop us a line in the <a href="https://wordpress.org/support/plugin/weather-atlas" rel="ugc">support forum</a>.
<h4>Key-Free Setup</h4>
No registration is required for the widget to function
<h4>Tags</h4>
weather, weather widget, forecast, location, weather atlas
<blockquote>
<a href="https://wordpress.org/support/plugin/weather-atlas" rel="ugc">Support</a> 
 For any inquiries about implementing or customizing the widget, or if you have suggestions for improvements and new features, feel free to <a href="https://wordpress.org/support/plugin/weather-atlas#new-topic-0" rel="ugc">reach out on our support forum</a>. We are dedicated to assisting every user with installation (which is rarely needed) and seamlessly integrating the widget into their website. Your feedback also helps us enhance the widget in future updates, incorporating the most requested features.
<a href="https://wordpress.org/support/plugin/weather-atlas/reviews/" rel="ugc">Reviews</a> 
 A little bit of <a href="https://www.youtube.com/watch?v=XpqqjU7u5Yc" rel="nofollow ugc">love</a> never hurt nobody. 
 If you like our work (or not), please <a href="https://wordpress.org/support/plugin/weather-atlas/reviews/#new-topic-0" rel="ugc">let us, and the world know</a>.
</blockquote>

Weather Atlas Widget

The Weather Widget with the Most Active Installations. Highly customizable, simple & beautiful. Detailed current weather, hourly & daily forecasts

Spelhubben Weather vs Weather Atlas Widget