TheAVCoach Weather Station for WeatherLink
| 开发者 | theavcoach |
|---|---|
| 更新时间 | 2026年10月28日 13:28 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
TheAVCoach Weather Station for WeatherLink is a powerful WordPress plugin that seamlessly integrates your Davis WeatherLink station data into your website. Display current weather conditions using a shortcode and/or sidebar widget with extensive customization options, automatic station detection, universal field compatibility, and built-in mock data testing.
🌤️ Key Features
- Real-time Weather Data: Connect to your WeatherLink API for live weather updates
- Automatic Station Detection: Automatically identifies your Davis station type and available sensors
- Universal Field Compatibility: Automatically detects and maps ALL weather variables from ANY Davis station model
- Flexible Display Options: Use a shortcode in posts/pages or a widget in sidebars
- Two Display Styles: Choose between a Traditional responsive data table or a Graphical weather-app-style display with a hero temperature, wind compass, and color-coded stats panel
- Comprehensive Styling: Full control over fonts, colors, borders, and layout
- Variable Control System: Show/hide individual weather variables with Primary/Secondary priority
- Drag & Drop Ordering: Reorder weather variables via intuitive admin interface
- Mock Data Testing: Built-in testing framework for demonstration and development
- Auto-Refresh Mock Data: Automatically updates mock data when station type changes
- Responsive Design: Works perfectly on desktop, tablet, and mobile devices
- Smart Caching: Efficient data caching to minimize API calls
- Flexible Units: Imperial, Metric, UK, or individually configured units
- Future-Proof: Automatically adapts to new Davis station models and API changes
- Temperature (current, dew point, heat index, wind chill)
- Humidity
- Wind speed, direction, and gusts
- Rainfall (daily, storm total, monthly, yearly)
- Barometric pressure and trend (with enhanced field detection)
- UV Index (for stations with UV sensor)
- Solar Radiation (for stations with solar sensor)
- Timestamp information (with customizable styling)
- Font Control: Google Fonts integration with size, color, and weight options
- Table Styling: Header background color, opacity control, and cell border options
- Widget Styling: Separate color settings for labels, values, and backgrounds
- Layout Options: 4-column table layout with customizable header styling
- Variable Management: Unified interface for show/hide, priority settings, and drag & drop reordering
- Responsive Design: CSS grid and table layouts that adapt to any screen size
- Timestamp Styling: Customizable timestamp position, color, and alignment
- Hero Panel: A large, color-coded temperature reading paired with a wind compass ring (direction + speed) when wind data is enabled
- Temperature-Family Grouping: Heat Index, Wind Chill, and Dew Point display together beneath the hero as related "feels like" readings
- Stats Panel: Remaining variables (humidity, rain, pressure, UV, etc.) as clean, aligned vertical rows
- Semantic Color Coding: Temperature gradient scale, moisture/rain blues, EPA UV Index colors, wind intensity scale, solar radiation scale, and a rising/falling barometric pressure trend indicator (green = rising, red = falling)
- Light / Dark / Auto Color Scheme: Set manually, or automatically follow the visitor's device preference
- Background Gradient Options: Choose from four built-in blue-toned gradient presets (Ocean, Sky, Midnight, Steel), or select Custom to pick your own two brand colors
- Mobile-Optimized: Stats stack into single-column rows on narrow screens rather than shrinking a multi-column grid
- Toggle Anytime: Switch between Traditional and Graphical from the admin settings page - your existing Traditional styling options are preserved and unaffected either way
- Automatic Identification: Detects Davis station type from API data
- Universal Field Detection: Automatically maps ALL weather variables from ANY Davis station model
- Future-Proof: No manual updates needed for new station models or API changes
- Sensor Mapping: Shows available sensors based on your station model
- Station Types Supported:
- Vantage Vue (basic weather data)
- Vantage Pro2 (includes UV and Solar Radiation)
- Vantage Pro2 Plus (full sensor suite)
- Vantage Vue Plus (Vue + UV sensor)
- Wireless variants of all models
- ANY future Davis station model (automatically supported)
- API Integration: Direct WeatherLink API v2 integration with proper error handling
- Dynamic Field Detection: Automatically discovers and maps all available weather data fields
- Enhanced Barometric Pressure: Comprehensive field mapping for pressure and trend data
- Smart Caching: Configurable cache duration (1-60 minutes)
- Security: Proper sanitization, nonce verification, and capability checks
- WordPress Standards: Follows all WordPress coding best practices
- Debug Mode: Built-in debugging for troubleshooting with comprehensive API structure analysis
- Smart Mock Data Management: Auto-refresh when station type changes, manual refresh/clear options
- Font Awesome Icons: Professional weather icons throughout
- Mobile Responsive: Optimized for all device sizes
- Automatic Error Recovery: Graceful handling of missing or corrupted data
[theavcoach_weather]
Widget in Sidebar:
Simply drag the "TheAVCoach Weather Station for WeatherLink" widget to any sidebar area. All widget settings are configured globally in the plugin settings.
🚀 Quick Start
- Install & Activate the plugin
- Configure API Credentials in Settings → TheAVCoach Weather Station for WeatherLink
- Add your WeatherLink API key, secret, and station ID
- Station type will be automatically detected
- All weather variables will be automatically mapped
- Customize styling to match your theme
- Configure variable display (show/hide and priority)
- Reorder variables using drag and drop
- Use the shortcode or widget to display weather data
- Test without API credentials - perfect for development and demonstration
- Multiple station types - test different Davis station configurations
- Realistic data generation - creates believable weather values with dynamic variation
- Interactive testing interface - test all features before going live
- Automatic mock mode - seamlessly switch between mock and live data Quick Start:
- Go to Settings → TheAVCoach Weather Station for WeatherLink Mock Tester
- Select a station type (Vantage Vue, Pro2, Pro2 Plus, etc.)
- Click "Generate Mock Data" to create realistic weather values
- Click "Inject Into Plugin" to test your plugin with mock data
- Test shortcode and widget functionality
- Use "Disable Mock Mode" to return to normal API operation Supported Station Types:
- Vantage Vue - Basic weather data (temp, humidity, wind, rain, pressure)
- Vantage Pro2 - Full suite including UV Index and Solar Radiation
- Vantage Pro2 Plus - Complete sensor array
- Vantage Vue Plus - Vue capabilities + UV sensor
- Wireless variants of all models Testing Benefits:
- Verify plugin functionality before purchasing API credentials
- Test different station configurations
- Demonstrate features to clients
- Develop and debug without real weather data
- Test responsive design with various data sets
- Validate all weather variable mappings
- Weather stations and meteorological websites
- Local news and community sites
- Outdoor activity and sports websites
- Educational institutions with weather programs
- Personal weather enthusiast blogs
- Professional weather service providers
- Developers testing weather integrations
- Any Davis station owner regardless of model or configuration
安装:
Automatic Installation (Recommended)
- Go to Plugins → Add New in your WordPress admin
- Search for "TheAVCoach Weather Station for WeatherLink"
- Click Install Now and then Activate
- Download the plugin ZIP file
- Go to Plugins → Add New → Upload Plugin
- Choose the ZIP file and click Install Now
- Click Activate Plugin
- Navigate to Settings → TheAVCoach Weather Station for WeatherLink
- Enter your WeatherLink API credentials
- Configure display options and styling
- Test with mock data if needed
- Add the shortcode
[theavcoach_weather]to any post or page
屏幕截图:
常见问题:
What Davis weather stations are supported?
The plugin automatically detects and supports ALL Davis WeatherLink stations including Vantage Vue, Vantage Pro2, Vantage Pro2 Plus, and their wireless variants. Station type is automatically detected from your API data, and ALL weather variables are automatically mapped regardless of your specific model.
Do I need real WeatherLink API credentials to test the plugin?
No! The plugin includes a comprehensive mock data testing framework that allows you to test all features with simulated weather data. Perfect for development and demonstration.
Can I customize which weather variables are displayed?
Yes! You have full control over which variables to show, their priority level (Primary/Secondary), and the display order using an intuitive drag and drop interface.
Is the plugin mobile responsive?
Absolutely! The plugin uses modern CSS Grid and responsive design principles to ensure perfect display on all devices from mobile phones to desktop computers.
What's the difference between Traditional and Graphical display styles?
Traditional shows your weather data as a linear, responsive data table - straightforward and information-dense. Graphical presents the same data as a weather-app-style layout with a large color-coded temperature, a wind compass ring, and the rest of your variables in an aligned stats panel, with light/dark scheme and gradient background options. Switch between them anytime in Settings → Display Style; your Traditional styling settings are preserved even while using Graphical.
How often does the plugin fetch weather data?
You can configure the standard cache duration from 1 to 60 minutes. Optionally, enable live display refresh at a custom interval from 15 seconds to 60 minutes; it refreshes only the weather component and uses a shared short-lived cache to minimize API calls.
Can I use both the shortcode and widget simultaneously?
Yes! You can use the shortcode in posts/pages and the widget in sidebars at the same time. Both will use the same global configuration settings.
What if my Davis station has different field names than expected?
The plugin automatically detects ALL available weather data fields from your station and maps them intelligently. No manual configuration is needed - it works with any Davis station model automatically.
How does the plugin handle missing or corrupted weather data?
The plugin gracefully handles missing data by displaying "N/A" and includes comprehensive error handling. Debug mode provides detailed information about available data fields and any issues.
更新日志:
1.3.0
- Fixed shortcode and widget rendering, cache handling, mock-data detection, and weather-variable formatting.
- Restored working cache-clear and API-test controls with clear status messages; the detailed test now uses WeatherLink's documented current-conditions endpoint.
- Added UK units (Celsius, mph, mBar, and mm) plus a Custom mode with individual temperature, wind, pressure, and rain-unit choices.
- Corrected Metric, UK, and Custom unit conversions from WeatherLink source values.
- Added optional live display refresh from 15 to 3,600 seconds. It refreshes only the weather component and uses a shared short-lived cache.
- Minor Improvement - Wind Compass & Temperature Placement: Enlarged the Graphical display's wind compass and moved the N/E/S/W direction letters outside the ring, matching how most compass/wind-rose UIs place them; the wind-direction arrow now rides along the inside of the ring instead of sharing space with the letters, so it can no longer overlap a direction letter or the center temperature reading at any wind direction
- Bug Fix - Temperature Overflow Safeguard: The center temperature reading now scales its font size down slightly for longer values (a negative reading, or a third digit before the decimal) so it can't grow wide enough to reach the compass arrow
- Bug Fix - Barometric Pressure Column Width: Widened the Barometric Pressure value column and prevented it from wrapping, since a theme's font rendering could occasionally push "inHg" onto its own line even on desktop where there was otherwise room for it
- Accessibility - Light Mode Rain/Humidity Contrast: Darkened the light-mode color scale used for Rain and Humidity values. The lightest two tiers previously measured well under the WCAG AA minimum contrast ratio against the light theme's background - and since rain readings use 1 inch as their "heavy" reference point, everyday low/no-rain readings were the ones most often landing in those hard-to-read colors. All five tiers now meet AA contrast while keeping the same blue color family.
- New Feature - Graphical Display Style: Added an alternative to the Traditional data table - a weather-app-style layout with a large color-coded temperature, a wind compass ring showing live direction and speed, and remaining variables presented in an aligned stats panel
- New Feature - Display Style Toggle: New admin setting to switch between Traditional (table) and Graphical display per site, without affecting existing Traditional styling configuration
- New Feature - Semantic Color Coding: Temperature gradient scale, moisture/rain blue scale, EPA UV Index color scale, wind speed/gust scale, solar radiation scale, and barometric pressure trend indicator, with a toggle to disable color coding entirely
- New Feature - Light/Dark/Auto Color Scheme: Graphical display can follow the visitor's device preference automatically, or be forced to always-light or always-dark
- Gradient Presets: Four built-in blue-toned background gradient presets (Ocean, Sky, Midnight, Steel) for the Graphical display's outer container
- Custom Gradient Option: Custom gradient option with two color pickers, so the outer background can be matched to any brand's colors
- Mobile Layout Fixes: Resolved several overlap issues in the Graphical display on narrow/phone-width screens - the wind-direction arrow no longer overlaps the hero temperature and wind-speed text, the temperature no longer wraps its unit onto a second line, the Barometric Pressure value no longer wraps "inHg" under the number, the Barometric Pressure / Trend labels no longer overflow into the value column, and the Heat Index / Wind Chill / Dew Point row is now reliably centered instead of overflowing past the right edge
- Bug Fix - Pressure Trend Icon: Fixed a mismatch where the trend arrow icon could disagree with the trend text (e.g. showing a "steady" dash next to "Rising") due to two separate threshold checks; the icon is now derived directly from the computed label so they can't disagree
- Bug Fix - CSS Output: Removed incorrect
esc_html()escaping that was being applied to the Graphical display's CSS output, which could corrupt quoted values (e.g. font names) and cause the browser to drop or misparse rules - Bug Fix - Color Coding Specificity: Fixed a CSS cascade issue where color-coded values (temperature, humidity, rain, UV, etc.) could silently be overridden by a base style rule of equal specificity, causing colors not to render
- Pressure Trend Colors: Switched trend colors to the conventional weather-site pairing (green = rising, red = falling)
- Layout Refinements: Hero panel (temperature + wind compass) enlarged and restructured with related "feels like" readings (Heat Index, Wind Chill, Dew Point) grouped beneath it; stats panel values aligned into a consistent column; timestamp moved inside the outer gradient container; mobile stats now stack one per row instead of shrinking into a multi-column grid
- Initial Release: Complete TheAVCoach Weather Station for WeatherLink plugin
- WeatherLink API v2 Integration: Direct API connection with proper error handling
- Automatic Station Detection: Automatically identifies Davis station type and available sensors
- Universal Field Detection: Automatically detects and maps ALL weather variables from ANY Davis station model
- Enhanced Barometric Pressure: Comprehensive field mapping for pressure and trend data with multiple field variations
- Dynamic Field Mapping: Future-proof solution that adapts to new station models and API changes automatically
- Comprehensive Styling Options: Full control over fonts, colors, borders, and layout
- Variable Management System: Unified interface for show/hide, priority settings, and drag & drop reordering of weather variables
- Mock Data Testing Framework: Built-in testing for demonstration and development
- Auto-Refresh Mock Data: Automatically regenerates mock data when station type changes
- WordPress Best Practices Compliance: Follows all WordPress coding standards and security requirements
- Mobile Responsive Design: Optimized for all device sizes with clean mobile layout
- Font Awesome Integration: Professional weather icons throughout
- Smart Caching: Configurable cache duration to minimize API calls
- Multiple Units Support: Imperial and Metric units
- Debug Mode: Built-in debugging for troubleshooting with comprehensive API structure analysis
- WordPress 6.8 Compatibility: Tested and optimized for latest WordPress versions