PDS Weather
| 开发者 | proodos |
|---|---|
| 更新时间 | 2026年5月31日 17:54 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 |
| 版权网址: | 版权信息 |
详情介绍:
PDS Weather shows current conditions in your area using the OpenWeatherMap API (free tier).
The plugin fetches and displays:
- Current weather description
- Current temperature (°C and/or °F)
- "Feels like" temperature
- Weather font icon (optional)
- City name display (optional)
- A free OpenWeatherMap API key — Get one here
- Go to PDS Weather > Settings in your WordPress admin.
- Enter your OpenWeatherMap API key.
- Select your country and enter your city name.
- Choose display options (icon, degrees, feels like, weather label, city name).
- Save settings.
- Use the PDS Weather Gutenberg block in the Block Editor.
- Use the PDS Weather classic widget (Appearance > Widgets).
- Use the
[pdsweather]shortcode in any post or page. - Or call
<?php echo pdsweather_display(); ?>in your theme template. - Legacy function
pdsWeather()is still supported for backward compatibility.
安装:
- Upload the
pdsweatherfolder to/wp-content/plugins/. - Activate the plugin through the 'Plugins' menu in WordPress.
- Go to PDS Weather > Settings and enter your OpenWeatherMap API key.
- Configure country, city, and display preferences.
- Add the widget or use
<?php echo pdsweather_display(); ?>in your templates.
常见问题:
Where do I get an API key?
Sign up for a free account at OpenWeatherMap and create an API key. The free tier allows up to 1,000 calls per day.
The old Weather Underground API key no longer works. What do I do?
Weather Underground shut down their free API in 2019. Version 4.0 of this plugin uses OpenWeatherMap instead. Simply enter your new OpenWeatherMap API key in the settings.
How often does the weather data refresh?
The plugin caches data for one hour to minimize API calls.
更新日志:
4.0.2
- Added Gutenberg block — insert weather directly from the Block Editor with live server-side preview.
- Added
[pdsweather]shortcode for easy embedding in posts and pages. - Added "Show city name" option in settings.
- Modernized front-end CSS: switched from floats to flexbox layout, added temperature separator.
- Added
.pdsweather-cityCSS class for city name styling.
- Fixed widget not appearing properly in Appearance > Widgets admin screen.
- Added configurable widget title field with proper sanitization.
- Widget now outputs title using before_title/after_title theme wrappers.
- Widget no longer outputs empty wrapper when no weather data is available.
- Added explicit 'classname' to widget constructor for proper CSS targeting.
- Added link to settings page inside widget form for easier configuration.
- BREAKING: Replaced defunct Weather Underground API with OpenWeatherMap API.
- Added nonce verification for all admin forms.
- Added capability checks (manage_options) on all admin pages.
- Added input sanitization (sanitize_text_field) for all user inputs.
- Added output escaping (esc_html, esc_attr, esc_url) for all outputs.
- Added option whitelist — only pdsweather_* options are accepted.
- Added ABSPATH checks to prevent direct file access.
- Moved inline JavaScript to separate enqueued file (js/pdsweather-admin.js).
- Replaced file_get_contents() with wp_remote_get().
- Added proper error handling for API calls.
- Updated plugin header (Tested up to: 6.7, Requires PHP: 7.4).
- Added Text Domain and load_plugin_textdomain() support.
- Renamed all functions/options with pdsweather_ prefix.
- Removed Weather Underground icon set options (no longer available).
- Improved uninstall.php with WP_UNINSTALL_PLUGIN check and legacy option cleanup.
- Added weather icon mapping for OpenWeatherMap condition codes.
- Legacy pdsWeather() function preserved as wrapper for backward compatibility.
- Bugfix when weather string is blank — set clear for weather.
- Solved bug for conditions after new year has started.
- Tested on 4.7.
- Removed print of the results after save.
- Tested on 4.5.
- Implement selective refresh for widget.
- Solved more bugs.
- Added input field for API key to the settings area.
- Made sure API key is required for widget to be shown.
- Added drag & drop widget in widgets section.
- Solved some bugs.
- Added input field for API key.
- Added uninstall functions.
- Another little bug solved.
- Solved bug with showing of the countries.
- Added F and °C for temperature strings.
- First version of the plugin.
- Weather conditions change once per hour.
- Shows conditions and feels like string.
- Uses WU icons and weather font.