Title: WFY24 Weather Widget
Author: wfy24
Published: April 29, 2026
Last modified: August 24, 2026
---
Search plugins
# WFY24 Weather Widget
By [wfy24](https://profiles.wordpress.org/wfy24/)
[Download](https://downloads.wordpress.org/plugin/wfy24-weather-widget.2.4.0.zip)
* [Details](https://vec.wordpress.org/plugins/wfy24-weather-widget/#description)
* [Reviews](https://vec.wordpress.org/plugins/wfy24-weather-widget/#reviews)
* [Installation](https://vec.wordpress.org/plugins/wfy24-weather-widget/#installation)
* [Development](https://vec.wordpress.org/plugins/wfy24-weather-widget/#developers)
[Support](https://wordpress.org/support/plugin/wfy24-weather-widget/)
## Description
WFY24 Weather Widget lets you embed a free, fully-featured weather widget on any
WordPress site — in any post, page, or sidebar — with a single shortcode, Gutenberg
block, or built-in sidebar widget.
#### Zero-friction setup
On activation, a welcome wizard walks you through three clicks:
1. **Activate** — we auto-register your site with wfy24.com using your admin email.
No external signup. No copy/paste.
2. **Create Weather page** — optionally publish a “Weather” page with the widget ready
to go.
3. **Add to sidebar** — one-click inject a compact weather widget into your first
sidebar.
#### Features
* **Free version** with a small “Weather by WFY24” attribution link under each
widget (disclosed and consented to during activation). No credit card, no hidden
fees, no ads. [Upgrade to Pro](https://www.wfy24.com/en/widgets/pro) to remove
the attribution
* **Lightweight** — 6.6 KB gzipped
* **Real-time data** — temperature, conditions, wind, humidity, 5-day forecast
* **50 languages** — auto-detected from your site or set manually
* **Admin interface in 15 locales** — the settings screen and setup wizard are
fully translated into Bulgarian, Czech, Dutch, French, German (de_DE / de_AT /
de_CH), Greek, Hungarian, Italian, Polish, Portuguese (pt_PT / pt_BR), Spanish
and Swedish, and the activation link opens wfy24.com in your own language
* **Auto location** — GPS (with consent) or IP-based geolocation, or pin a specific
city
* **Light / Dark / Auto theme** — matches your site automatically
* **7 layouts** — Classic, Compact, Minimal, Badge, Forecast, Air Quality, Air
Quality + Weather (wide)
* **Shadow DOM isolation** — zero CSS conflicts with your theme
* **Zero dependencies** — no jQuery, no React, no bloat
* **Multi-source data** — ICON-D2/EU/Global NWP + GFS fallback, with ML post-processing
#### Usage
Shortcode:
```
[wfy24_weather]
```
Override per instance:
```
[wfy24_weather city="paris-fr2988507" theme="dark" variant="forecast" lang="fr"]
```
Or use the **WFY24 Weather Widget** block in the Gutenberg editor for a visual interface.
#### Attribution
The free version of this plugin displays a small “Weather by WFY24” link under each
rendered widget. The onboarding wizard shows an explicit disclosure notice and asks
for your consent before the “Activate now (free)” button; clicking that button is
your explicit permission to enable the link. To remove the attribution, a Pro version
is available at [wfy24.com/en/widgets/pro](https://www.wfy24.com/en/widgets/pro).
#### External service
This plugin connects to the WFY24 weather service at `https://www.wfy24.com`:
* **Plugin activation**: POSTs to `/api/widget/register-from-plugin` with the email
you confirmed in the onboarding form (pre-filled from Settings General; editable
inline before activation), site name, site domain, WordPress version, and plugin
version, in order to automatically provision your free API key. No activation
happens without your explicit click on the “Activate now (free)” button.
* **City search** (admin only, when typing in the Default City field): the plugin’s
REST endpoint `/wp-json/wfy24/v1/cities` proxies your search query (e.g. “athens”)
to `/api/places/search` server-side. Your search query is sent along with a User-
Agent identifying the plugin. Results (slug + label + country flag) are cached
for 5 minutes per query. The admin’s IP is never exposed cross-origin because
the request is server-to-server.
* **Widget rendering** (client-side on visitor browsers): loads `widget.js` and
queries `/api/widget/data`. The widget sends the API key, optional city slug,
language/units/theme preferences, and a `data-geolocation` flag (off by default—
visitor location is not detected unless the admin explicitly opts in via the “
Auto-detect visitor location” toggle). When the toggle is on AND the visitor
grants permission, the visitor’s latitude/longitude is sent; when geolocation
is denied, the visitor’s IP address is used for IP-based city detection (still
gated by the toggle). No personal data is stored beyond standard anonymized request
logs for rate limiting.
* **Pro upgrade flow** (only if the user clicks “Upgrade to Pro” in Settings):
GETs `/api/widget/pro/status` and POSTs to `/api/widget/pro/checkout` and `/api/
widget/pro/portal` to provision a Stripe Checkout session and a Stripe Billing
Portal session. No data is sent unless the admin clicks the relevant button.
Links:
* WFY24 Terms of Service: [https://www.wfy24.com/en/terms](https://www.wfy24.com/en/terms)
* WFY24 Privacy Policy: [https://www.wfy24.com/en/privacy-policy](https://www.wfy24.com/en/privacy-policy)
### Multisite Support
The plugin is multisite-compatible. All settings (API key, defaults, page) are stored
per-subsite using `get_option()`/`add_option()`, so each subsite operates independently.
* **Network Activation does not contact wfy24.com.** It only loads the plugin code
on every subsite. No `admin_email` is sent, no API key is created, no automatic
phone-home occurs.
* **Each subsite admin completes onboarding individually.** When the admin opens
the welcome wizard on a subsite and clicks “Activate now (free)”, the plugin
sends _that subsite’s_ domain and `Settings → General → Email Address` to wfy24.
com to obtain a domain-bound API key. The admin is shown a dynamic disclosure
of the exact values that will be transmitted before clicking — no consent is
collected on behalf of admins of other subsites.
* **New subsites added later remain inactive** until their admin runs onboarding
manually. The widget will not render on a subsite that has not been activated;
no data leaves WordPress until an admin explicitly clicks Activate on that subsite.
* **No centralized network admin panel** exists in this version — each subsite
has its own settings page. A network-level overview is on the roadmap.
* **API keys are domain-bound.** A key issued for `site-a.example.com` will not
function on `site-b.example.com`, which means subdomain and domain-mapped multisite
installs work correctly out of the box (each subsite gets its own key for its
own domain).
## Screenshots
[⌊Welcome wizard after activation — live widget preview, key status, progress bar⌉⌊
Welcome wizard after activation — live widget preview, key status, progress bar⌉[
Welcome wizard after activation — live widget preview, key status, progress bar
[⌊Welcome wizard on first open — three-step onboarding, zero copy/paste⌉⌊Welcome
wizard on first open — three-step onboarding, zero copy/paste⌉[
Welcome wizard on first open — three-step onboarding, zero copy/paste
[⌊Classic widget layout rendered on a live WordPress page⌉⌊Classic widget layout
rendered on a live WordPress page⌉[
Classic widget layout rendered on a live WordPress page
## Blocks
This plugin provides 1 block.
* WFY24 Weather Widget Embed a free, lightweight weather widget — real-time forecasts
in 50 languages.
## Installation
1. Upload the plugin to `/wp-content/plugins/wfy24-weather-widget/`, or install via
Plugins Add New.
2. Activate the plugin via the Plugins menu.
3. Follow the welcome wizard that opens automatically. Three clicks: Activate, Create
page, Add to sidebar. Done.
If you prefer manual setup:
1. Go to **Settings WFY24 Weather**.
2. Paste your API key (get one at [wfy24.com/en/widgets](https://www.wfy24.com/en/widgets)).
3. Add `[wfy24_weather]` to any post, page, or widget area.
## FAQ
### Is it really free?
Yes. No credit card, no trial, no ads in the widget. Fair-use rate limits apply (
plenty for normal sites).
### Do I need to create an account manually?
No. The plugin registers your site automatically on activation using your WordPress
admin email. You can also enter a key manually if you already have one.
### Can I revoke / change my key later?
Yes — visit [wfy24.com/en/widgets](https://www.wfy24.com/en/widgets) to manage keys.
Any changes you make there apply to this plugin immediately (keys are shared).
### What data is sent to wfy24.com?
Minimal. See the “External service” section above. The plugin only contacts wfy24.
com on actions you explicitly trigger (activation click, widget rendering on visitor
pages, Pro upgrade click). There is no background telemetry, no scheduled cron,
and no analytics.
### Can I customize the look?
The widget uses Shadow DOM for style isolation, so it won’t clash with your theme.
Choose from 7 layouts (Classic, Compact, Minimal, Badge, Forecast, Air Quality,
Air Quality + Weather wide) and 3 themes (Auto, Light, Dark).
### What languages are supported?
50 languages. Set the `lang` attribute to any ISO 2-letter code.
### How do I find a city slug?
Go to [wfy24.com](https://www.wfy24.com), search for your city, and copy the slug
from the URL (e.g. `paris-fr2988507`).
### Does it work with caching plugins?
Yes. The widget loads client-side, so full-page cache has no impact on weather freshness.
### Does it work with Gutenberg / block editor?
Yes — we ship a “WFY24 Weather Widget” block under the Widgets category.
### What data sources does WFY24 use?
WFY24 combines multiple NWP models (DWD ICON-D2, ICON-EU, ICON-Global, GFS fallback)
with ML post-processing (XGBoost) and real observations from 19,000+ weather stations(
METAR, SYNOP, CWOP, DWD, etc.).
### Is there an attribution / “powered by” link?
Yes. The free version of this plugin displays a small “Weather by WFY24” link under
each rendered widget. This is disclosed explicitly during activation — the onboarding
wizard shows a notice asking you to agree before you click “Activate now (free)”.
Clicking “Activate” is your explicit consent. The link is how we keep the service
free for everyone.
### Can I remove the “Weather by WFY24” link?
Yes — by [upgrading to Pro](https://www.wfy24.com/en/widgets/pro), which removes
the link, increases the request rate limit, and unlocks additional features. The
free version keeps the attribution as a fair trade for unlimited free data.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“WFY24 Weather Widget” is open source software. The following people have contributed
to this plugin.
Contributors
* [ wfy24 ](https://profiles.wordpress.org/wfy24/)
[Translate “WFY24 Weather Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/wfy24-weather-widget)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/wfy24-weather-widget/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wfy24-weather-widget/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wfy24-weather-widget/)
by [RSS](https://plugins.trac.wordpress.org/log/wfy24-weather-widget/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 2.4.0
* **Admin interface in 15 locales.** Adds Bulgarian, Czech, Dutch, French, Greek,
Hungarian, Italian, Polish, Portuguese (European and Brazilian), Spanish and
Swedish to the German set. Each one uses its own WordPress core admin vocabulary
rather than a literal translation — Apparence Widgets, Vzhled Widgety, Външен
вид Джаджи — because that is what the person reading the screen already knows.
* Separate European and Brazilian Portuguese, for the same reason the German set
is split three ways: WordPress does not fall back between regional variants,
and definições/configurações, guardar/salvar and ecrã/tela are different words
in exactly the vocabulary an admin screen uses.
* Tested up to WordPress 7.1.
#### 2.3.0
* **German admin interface** — settings screen, setup wizard and all notices translated,
with separate files for Germany (de_DE), Austria (de_AT) and Switzerland (de_CH).
WordPress does not fall back from de_AT or de_CH to de_DE, so a site set to “
Deutsch (Österreich)” or “Deutsch (Schweiz)” would otherwise have stayed in English;
de_CH uses ss for the eszett throughout.
* **Activation link now opens in your own language.** The “activate” and “manage
keys” buttons pointed at the English page for every site in every language; they
now follow your WordPress admin language to the matching wfy24.com page, falling
back to English for languages the widget does not speak.
* Translation template rebuilt from source: it covered 44 strings, 22 of which
no longer existed in the plugin, against 98 strings actually in the code. Anyone
translating from the old template was working from a file that was 22% complete
and partly fictional.
#### 2.2.0
* Completely redesigned widget: crisp SVG icons (no more emoji), condition-tinted
accents, temperature range bars in the 5-day forecast, stat meters, and a refreshed
light/dark look.
* Country names now localized in all 50 languages (was: always Greek).
* 5-day forecast (was 3), correct day/night icons worldwide, per-place local noon
for daily icons.
* Full right-to-left layout for Arabic, Hebrew, Farsi and Urdu.
* Accessibility: reduced-motion support, screen-reader labels, WCAG AA contrast
throughout.
* Imperial mode now converts precipitation (in/h) as well.
* Faster and lighter on the host page: no more page-wide DOM observers, refreshes
pause in background tabs, geolocation resolved once per page view.
* Block editor: width control now cache-busts correctly; admin live preview reflects
width and Pro attribution.
#### 2.1.1
* **Fixed: aqi-wide live preview crushed in the 360px sticky sidebar.** When the
saved/selected variant is `aqi-wide`, the settings-page preview now breaks out
of the right-hand sidebar and renders in a full-width row above the form, so
the horizontal weather + AQI bar has room to show its actual layout. On the published
page nothing changes — the variant has always rendered correctly when given content-
width room.
#### 2.1.0
* **NEW: Wide AQI variant (weather + air quality side-by-side).** A new `variant
="aqi-wide"` style places the location, current weather (icon, temperature, conditions,
feels-like, daily high/low) on the left and a horizontal European-AQI bar (0–
100+) with category label on the right. Designed for embeds that span the full
content width, where the compact AQI card looks too narrow.
* **NEW: User-controlled width.** All variants now accept a `width` attribute —`[
wfy24_weather variant="aqi-wide" width="800px"]` or `width="100%"`. Accepts `
400`, `400px`, `80%`, `100%`; invalid values are dropped silently. Set a site-
wide default in _Settings WFY24 Weather Widget Default width_ or override per
shortcode / Gutenberg block. Empty value keeps each variant’s built-in default.
* Tested up to WordPress 7.0.
#### 2.0.2
* **Fixed: Badge variant truncated text mid-word.** The badge layout has `overflow:
hidden` and `white-space:nowrap`, but the segments inside didn’t carry `data-
fit-priority` hints — so when the embed sat in a narrow column (e.g. the admin’s
live-preview sidebar) the fit observer didn’t know which parts to hide and the“
Powered by WFY24” link was clipped mid-letter. Now the powered-by link, the description,
the “Feels like” segment, and their dividers each have priorities; the observer
hides them cleanly in priority order until everything fits.
* **Fixed: “Add to sidebar” quick action shown for block-based themes.** On themes
like Twenty Twenty-Three that register no classic sidebars, the action would
always end in “Could not auto-add to sidebar — please add the widget manually
from Appearance Widgets”. The button is now hidden on block-theme installs and
replaced with a short note pointing to the Site Editor and the shortcode option.
* **Requires PHP 8.1 (was 7.4).** PHP 7.4 reached end-of-life in November 2022
and is no longer receiving security patches. 8.1 is the lowest version Plugin
Check / WordPress.org still recommends.
#### 2.0.1
* **Fixed: AQI variant chips unreadable in dark theme.** The pollutant chips (PM2.5,
PM10, O₃, NO₂) were using a translucent overlay that resolved to near-invisible
against the dark theme’s navy backdrop, leaving the value text floating on what
looked like the bare widget bg. The chip background, text, and border now use
solid theme-aware colors (slate-700 on navy in dark, white on pale-blue in light),
and the chip text reads from a dedicated set of CSS variables that stay legible
regardless of the cascade.
* Version bump also serves as a Cloudflare-cache buster — the `?ver=2.0.0` query
had been cached on the CDN with the original 2.0.0 bundle, so even after the
widget.js fix landed on the origin, sites embedding the script kept loading the
stale copy. `?ver=2.0.1` is a fresh cache key.
#### 2.0.0
* **NEW: Air Quality (AQI) widget variant.** A new `variant="aqi"` style renders
European-AQI air quality for the configured city — the big AQI index number,
category band (good through hazardous, color-coded per the EEA scale), and the
four headline pollutants (PM2.5, PM10, O₃, NO₂). Data comes from the Copernicus
Atmosphere Monitoring Service (CAMS) via wfy24.com. Pick it from the “Style variant”
dropdown in settings, or set it inline with `[wfy24_weather variant="aqi"]`.
* **Premium admin redesign.** The plugin’s two separate admin screens — the onboarding
wizard and the settings page — have been merged into a single unified screen
at _Settings WFY24 Weather Widget_. New 2-column layout with a sticky live preview
on the right plus inline quick actions (create Weather page, add to sidebar)
so you never need to leave the page to set up an embed. The old `wfy24-welcome`
URL still works — it now redirects to the unified screen.
* **Re-organized settings.** Essentials (city, language, theme, units, style) are
upfront; visitor location, SEO JSON-LD, and the API key sit in a collapsible
Advanced panel.
* **Embed snippet card** with one-click copy-to-clipboard.
* **Removed: multi-city (`cities="..."`).** The v1.7.x multi-city feature is removed
in this major release — the implementation needed a dedicated admin picker UI
to be discoverable, and the new unified layout focuses on the most common single-
city flow. If you had multi-city enabled, your shortcodes without `cities=` now
fall back to your Default City; explicit `[wfy24_weather cities="..."]` shortcodes
will only render the first city. The `wfy24_default_cities` option is preserved
on update so no data is lost in case the feature returns later.
* `widget.js` is unchanged, so every existing shortcode and Gutenberg block in
published posts continues to render exactly as before.
#### 1.6.0
* **NEW: Schema.org JSON-LD output.** Each widget instance now emits a server-rendered`
WebPageElement` block describing the city (as `Place`), language, units, and
provider. Helps search engines and AI agents understand that the page contains
a weather forecast for a specific location — useful for semantic search, AI overviews,
and future rich-result eligibility. Toggle from the settings screen (on by default).
* **Canonical URLs + localized names.** The JSON-LD resolves each shortcode’s city
against the wfy24.com search API on the server side, so the emitted `url` is
the real canonical (e.g. `https://www.wfy24.com/el/weather/thessaloniki-gr57554537`)
and the `Place.name` uses the language-correct form pulled from the translations
table (`İstanbul` for `tr`, `Θεσσαλονίκη` for `el`, etc.). Cached in a WP transient
for 24h on hit, 5min on miss — first page load makes one upstream call, all subsequent
renders are cache hits.
* Filter hooks for third-party customization: `wfy24_jsonld_enabled` (per-widget
on/off) and `wfy24_jsonld_data` (modify the payload before emission).
* No change to the visual widget — `widget.js` is unchanged. Existing shortcodes
and blocks render exactly as before with the new JSON-LD appended.
#### 1.5.6
* **Language combobox: clicking the field now shows all 50 languages, not just
the saved selection.** Previously, focusing the field with “English” already
saved would self-match the filter and the dropdown would only show the single
English entry — useless for switching language. Now the picker detects when the
input value equals an existing language’s native or English name (i.e. the saved
selection) and shows the full list so you can browse.
* Both city and language inputs now select-all on focus, so typing immediately
replaces the saved value instead of appending to it.
* Removed the 12-item / 20-item slicing on the language list — the dropdown is
scrollable, all 50 are now reachable.
#### 1.5.5
* **Fixed: city and language suggestion dropdowns never opened.** The combobox
stylesheet sets `display: none` as the default state for the suggestion list;
the JavaScript was clearing the inline override (`element.style.display = ''`)
which fell back to that CSS default — so the dropdown was always hidden, even
though the REST proxy was returning matches and no console errors were thrown.
Now sets `display: block` explicitly. Affects both the Default City picker and
the Language combobox on the settings and onboarding screens.
#### 1.5.4
* **City picker UX matches the public wfy24.com search.** The Default City dropdown
now renders each result as a two-line item — country flag, bold place name, and
a grey secondary line with region + country (e.g. “Athens” / “Attica, Greece”)—
instead of a single concatenated label. The picker also forwards the admin’s
locale to the upstream search so localized place names are returned.
* **Keyboard navigation in the city picker.** / to move through results, Enter
to select, Escape to close — same shortcuts as the public site’s search dialog.
Hovered and keyboard-active items share a single highlight state.
* Internal: `/wp-json/wfy24/v1/cities` now returns structured fields (`slug`, `
name`, `country_code`, `country_name`, `flag`, `region`) instead of a single
pre-formatted `label`. Cache key includes the locale so per-language responses
don’t collide.
#### 1.5.3
* **Onboarding overhaul.** Step 1 is now a complete configuration form — admin
email (editable inline; no need to leave the wizard for Settings General), default
city (autocomplete search backed by wfy24.com places API), language (searchable
combobox with all 50 supported languages shown in their native script and English
name), theme, units, and a visitor-geolocation toggle — all set in one place
before activation. Click Activate and the widget is live with your exact configuration.
* **Visitor geolocation is now off by default.** Previously the widget would call`
navigator.geolocation` whenever no default city was set, which triggered a browser
permission prompt on every visitor and silently broke when declined. Auto-detect
is now an explicit opt-in checkbox; the default is to honour the admin-set city,
which matches what 95%+ of sites actually want (e.g. a tourism site for Crete
shouldn’t show a Swedish visitor’s local weather).
* **City picker.** Type a city name and pick from results (slug + flag + country)
instead of needing to know the wfy24.com slug format. Powered by a server-side
proxy (`/wp-json/wfy24/v1/cities`) so the admin’s IP is never exposed cross-origin.
* **Language combobox.** All 50 supported languages now appear in a searchable
dropdown with native + English names; type-ahead filters by either. The free-
text 2-letter code input is gone.
* **Stronger Pro pitch.** The free-version notice now lists the full Pro feature
set inline (no attribution, higher rate limits, priority support, custom CSS
via theme tokens, historical data + analytics) instead of just “removes the link.”
* **Sticky settings access.** A “Open plugin settings” button is now pinned on
the onboarding screen, and a “Skip onboarding” link routes admins straight to
Settings if they prefer to configure manually.
* **CORP header on widget.js + /api/widget/.** The hosted bundle now ships `Cross-
Origin-Resource-Policy: cross-origin`, which makes the widget work in cross-origin-
isolated environments (e.g. playground.wordpress.net) that ship `Cross-Origin-
Embedder-Policy: require-corp`.
#### 1.5.2
* **Activation transparency.** The onboarding wizard now displays an explicit,
dynamic disclosure listing exactly what is sent to wfy24.com on click — the site
domain, the administrator email currently configured in Settings General (rendered
live so the admin sees their own email before consenting), the site name, the
WordPress version, the plugin version, and the locale. No visitor data is collected.
Admins who want to register with a different email are pointed to Settings General
and asked to change it before clicking Activate.
* Documented multisite behaviour explicitly: per-subsite onboarding, no automatic
phone-home on Network Activation, domain-bound API key per subsite. See the new“
Multisite Support” section.
#### 1.5.1
* Plugin Check compliance — replaced two `wp_redirect()` calls in the Pro flow (
Stripe Checkout and Billing Portal) with `wp_safe_redirect()` plus a scoped `
allowed_redirect_hosts` filter that whitelists `checkout.stripe.com`, `billing.
stripe.com`, and `pay.stripe.com`. The redirect helper validates the target host
against this list before issuing the redirect, falling back to a safe admin URL
on mismatch.
* Tightened the readme upgrade notice for 1.5.0 to fit the 300-character limit.
* Cleaned up readme: the “External service” section and FAQ no longer reference
the daily telemetry ping (removed in 1.4.0) — the plugin makes no scheduled outbound
calls.
#### 1.5.0
* **WP.org compliance: replaced inline `