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.

tuxlog

You are reading the readme.txt file for the wp-forecast plugin. 
wp-forecast is a plugin for the famous wordpress blogging package, 
showing the weather-data from open-meteo.com and/or openweathermap.com. 
please also refer to the terms of usage of open-meteo.com and/or openweathermap.com.
Features:
<ul>
<li>Displays the weather data from Open-Meteo.com and OpenWeatherMap.com 
 at your wordpress pages, posts or sidebar</li>
<li>Displays OpenUV.io data</li>
<li>Let you choose the
<ul>
<li>location (of course)</li>
<li>the time after the weather data is refreshed</li>
<li>the langugage</li>
<li>metric or american measures</li>
<li>windspeed unit</li>
<li>the forecast days</li>
<li>the forecast for up to six/seven days</li>
</ul>
</li>
<li>support wordpress widgets, easy placement 🙂</li>
<li>customize the information you want to show</li>
<li>supports pull-down forecast data to efficiently use space</li>
<li>multiple wp-forecast widget support</li>
<li>integration into your site via css (see below)</li>
<li>comes with an api for wordpress-pro’s 😉</li>
</ul>
Credits:
<ul>
<li>Barbary Jany testing a lot and bring it to valid XHTML</li>
<li>Nike Gilhuijs, 
Frans Lieshout, Wim Scholtes translation to dutch</li>
<li>Luís Reis translation to portugues</li>
<li>Håkan Carlström, 
Susanne Svensso translation to swedish</li>
<li>Gabriele von der Ohe translation to german with entities (for iso-8859-1 or latin1 blogs)</li>
<li>Martin Loyer/Jean-Pierre translation to french</li>
<li>Robert Lang language file for en_US</li>
<li>Detti Giulio/Stefano Boeri translation to italian</li>
<li>Eilif Nordseth translation to norwegian</li>
<li>Michael S.R. Petersen translation to dansk</li>
<li>Jaakko Kangosjärvi translation to finish</li>
<li>Lukasz “linshi” Linhard translation to polish</li>
<li>Castmir & Alejandro translation to spanish</li>
<li>Tamas Koos translation to hungarian</li>
<li>Valeria Pellegrini translation to russian</li>
<li>Valentina Boeri translation to romanian</li>
<li>Roland Geci translation to slovak</li>
<li>Pavel Soukenik translation to czech</li>
<li>Pavel Karnaukhov translation to ukraine</li>
<li>Zoran Maric translation to serbian (latin)</li>
<li>Petar Petrov translation to bulgarian</li>
<li>Udi Burg translation to hebrew</li>
<li>Uli Kozok translation to indonesian</li>
<li>Ali Zemani translation to persian</li>
<li>Amizda Idriz translation to bosnian</li>
<li>Lovrenco Vladislavić translation to croatian</li>
<li>All the others giving feedback about missing features and bugs. 
Thank you very much for your contribution to wp-forecast.</li>
<li>
Weather Icon Font by me Erik FLowers Weather Icons licensed under SIL OFL 1.1
Installation:
</li>
</ul>
<ol>
<li>
Install via the WordPress plugin admin dialog (search for wp-forecast) or
</li>
<li>
Upload to your plugins folder, usually <code>wp-content/plugins/</code>, keeping 
the directory structure intact (i.e. wp-forecast.php should end up 
in <code>wp-content/plugins/wp-forecast/</code>).
</li>
<li>
Activate the plugin on the plugin screen.
</li>
<li>
Visit the configuration page (<code>Options -> WP-forecast</code>) to pick the 
number of widgets, data to display and to change any other option.
</li>
<li>
Visit the Themes/Widgets page to place your wp-forecast widget within 
your themes sidebars or insert it manually and edit your template 
file and put the wp-forecast function where you want your weather 
data to show up. 
Example: <code><ul><li> 
 <?php if(function_exists(wp_forecast)) { 
 wp_forecast( <widget_id> ); 
 } ?> 
 </li></ul></code>
You have to replace <widget_id> with the choosen widget id. 
 For the first widget use wp_forecast(“A”), for the second 
 wp_forecast(“B”) and so on. 
 In most cases it is advisable to put the call into a div environment.
</li>
<li>
Optional 
If you would like to have another set of icons download it 
from <a href="http://accunet.accuweather.com/wx/accunet/graphics_icons.htm" rel="nofollow ugc">http://accunet.accuweather.com/wx/accunet/graphics_icons.htm</a> 
and put it into the wp-content/plugins/wp-forecast/icons folder
</li>
<li>
Optional 
If you would like to change the style, just edit wp-forecast.css 
there are three classes div.wp-forecast for outer formatting, 
table.wp-forecast for the middle part or iconpart and 
wp-forecast-details for everything below the icon
</li>
</ol>
<h3>Translations</h3>
wp-forecast comes with various translations, located in the directory <code>lang</code>. 
 if you would like to add a new translation, just take the file 
 wp-forecast.pot (in the wp-forecast main directory) copy it to 
 wp-forecast_-.po and edit it to add your translations 
 (e.g. with poedit).
Please be aware that the number codes stand for the weather-situations. 
 you can see the mapping in wp-forecast-en_US-en_US.po. there are also 
 the letters N, S, W, E they stand for the winddirections and can be 
 translates either.
To use your own translation, a different one as the default just rename the 
 appropriate file wp-forecast_-.po and 
 wp-forecast_-.mo
To add your translations online at the Translate WordPress project please visit 
 https://translate.wordpress.org/projects/wp-plugins/wp-forecast. This should be the prefered 
 way from now on.

wp-forecast

wp-forecast is a highly customizable plugin for wordpress, showing weather-data from open-meteo.com and/or openweathermap.com.

Spelhubben Weather vs wp-forecast