Title: FYP Weather
Author: François Yerg
Published: <strong>2025 年 8 月 20 日</strong>
Last modified: 2026 年 1 月 4 日

---

搜尋外掛

![](https://ps.w.org/fyp-weather/assets/banner-772x250.png?rev=3347669)

![](https://ps.w.org/fyp-weather/assets/icon-256x256.png?rev=3347669)

# FYP Weather

 由 [François Yerg](https://profiles.wordpress.org/francoisyerg/) 開發

[下載](https://downloads.wordpress.org/plugin/fyp-weather.1.1.1.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/fyp-weather/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/fyp-weather/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/fyp-weather/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/fyp-weather/#developers)

 [技術支援](https://wordpress.org/support/plugin/fyp-weather/)

## 外掛說明

**Transform your website with beautiful weather displays that your visitors will
love!**

FYP Weather is a professional WordPress plugin that brings stunning, real-time weather
information to your website. With its modern gradient design, smooth animations,
and responsive layout, this plugin delivers both functionality and visual appeal.

Built for performance and ease of use, FYP Weather features intelligent caching 
through WordPress transients, automatic language detection supporting 30+ languages,
and a comprehensive admin interface that makes configuration simple and straightforward.

**Why Choose FYP Weather?**

🌟 **Beautiful Visual Design** – Modern gradient backgrounds with weather icons 
and elegant typography
 🚀 **Performance Optimized** – Built-in transient caching
system (1-hour cache) reduces API calls 🌍 **Multilingual Support** – Automatic 
language detection for 30+ languages based on WordPress locale 📱 **Fully Responsive**–
Mobile-first design that works perfectly on all devices ⚙️ **Easy Configuration**–
Comprehensive admin interface under FYPlugins  Weather 🎨 **Theme Integration** –
Works seamlessly with any WordPress theme 🔧 **Professional Code** – Clean, secure,
and following WordPress coding standards

**Key Features:**

 * **🎨 Modern Weather Widget:** Gradient backgrounds, weather icons from OpenWeatherMap,
   and smooth CSS animations
 * **⚡ Smart Caching System:** 1-hour WordPress transient caching improves performance
   and reduces API usage
 * **🌐 True Multilingual Support:** Automatic language detection for weather descriptions
   in 30+ languages
 * **📊 Complete Weather Data:** Temperature, weather description, humidity, wind
   speed, and weather icons
 * **🎛️ Flexible Display Options:** Show/hide weather elements with customizable
   labels via admin settings
 * **📐 Multiple Unit Systems:** Metric (°C), Imperial (°F), and Standard (Kelvin)
   temperature units
 * **🎯 Powerful Shortcode:** `[fyplugins_weather]` with extensive customization
   parameters
 * **📱 Responsive Design:** Mobile-optimized layout that adapts to any screen size
 * **⚙️ Professional Admin Interface:** Clean settings panel with API configuration
   and default options
 * **🔒 Secure & Reliable:** Proper error handling, data validation, and secure 
   API integration
 * ** CSS Customization:** Additional CSS classes and built-in styling options
 * ** ️ Clean Uninstall:** Properly removes all options and cached data when uninstalled

This plugin is part of the FYPlugins ecosystem, designed to provide high-quality
WordPress solutions with exceptional performance and user experience.

### Usage

**🚀 Quick Start:**

 1. **Get your FREE API key** from [OpenWeatherMap](https://openweathermap.org/appid)(
    1,000 free calls/day)
 2. **Configure the plugin** at WordPress Dashboard  FYPlugins  Weather
 3. **Add weather anywhere** using the `[fyplugins_weather]` shortcode

**📋 Basic Examples:**
 `[fyplugins_weather] [fyplugins_weather city="Paris, France"
units="metric"] [fyplugins_weather city="New York, NY" units="imperial" show_humidity
="false"]

**🎨 Styling Examples:**
 `[fyplugins_weather class="dark"] [fyplugins_weather class
="light custom-weather"]

### Shortcode Parameters

**🌡️ Weather Shortcode – `[fyplugins_weather]`**

    ```
    city string (default: Empty or Set in settings) City name for weather data (e.g., "London, UK")
    api_key string (default: Empty or Set in settings) Your OpenWeatherMap API key
    units string (default: metric or Set in settings) Temperature units: `metric` (°C), `imperial` (°F), `standard` (K)
    language string (default: Auto-detected) Language code for weather descriptions
    show_description boolean (default: true or Set in settings) Display weather description
    show_humidity boolean (default: true or Set in settings) Display humidity information
    humidity_label string (default: "Humidity:" or Set in settings) Custom label for humidity display
    show_wind boolean (default: true or Set in settings) Display wind speed information
    wind_label string (default: "Wind Speed:" or Set in settings) Custom label for wind speed display
    class string | Empty (default: Empty or Set in settings) Additional CSS classes for styling
    ```

**📝 Advanced Examples:**

    ```
    // Different cities with custom styling
    [fyplugins_weather city="Tokyo, Japan" class="dark"]
    [fyplugins_weather city="Sydney, Australia" units="imperial" class="light"]

    // Minimal display
    [fyplugins_weather show_description="false" show_humidity="false" show_wind="false"]

    // Custom labels in different languages
    [fyplugins_weather humidity_label="Humidité:" wind_label="Vent:" language="fr"]

    // Multiple weather widgets on same page
    [fyplugins_weather city="London, UK" class="weather-london"]
    [fyplugins_weather city="Paris, France" class="weather-paris"]
    ```

**🌍 Supported Languages:**
 English, French, German, Spanish, Italian, Portuguese,
Russian, Chinese (Simplified & Traditional), Japanese, Korean, Dutch, Swedish, Danish,
Norwegian, Finnish, Polish, Czech, Slovak, Hungarian, Romanian, Bulgarian, Croatian,
Slovenian, Estonian, Latvian, Lithuanian, Ukrainian, Greek, Turkish, Arabic, Hebrew,
Hindi, Thai, Vietnamese

_Language support is based on the WordPress locale and OpenWeatherMap API capabilities._

### External Services

**🌐 OpenWeatherMap API Integration**

This plugin connects to the OpenWeatherMap API to retrieve current weather information.
This external service is essential for providing accurate, real-time weather data.

**🔒 Privacy & Data Protection:**
 – **No user data collection:** The plugin only
sends the city name, your API key, WordPress language setting, and units preference–**
No personal information:** No user IPs, emails, or browsing data is transmitted –**
Secure connections:** All API calls use HTTPS encryption – **Local caching:** Weather
data is cached locally using WordPress transients for 1 hour

**📋 Service Details:**
 – **Provider:** OpenWeatherMap ([openweathermap.org](https://openweathermap.org/))–**
Terms of Service:** [OpenWeather Terms & Conditions](https://openweathermap.org/terms)–**
Privacy Policy:** [OpenWeather Privacy Policy](https://openweather.co.uk/privacy-policy)–**
Rate Limits:** Free tier provides 1,000 API calls per day

**⚙️ What Data is Sent:**
 – City name (as specified in shortcode or settings) –
API key (your personal OpenWeatherMap key) – Language code (WordPress locale for
localized weather descriptions) – Temperature units preference (metric/imperial/
standard)

### Roadmap & Future Enhancements

**🚀 Version 1.1 – Enhanced Caching & Performance**
 * Configurable cache duration
options in admin settings * Background API refresh to eliminate user-facing delays*
Database optimization for better transient management

**🌤️ Version 1.2 – Extended Weather Features**
 * 5-day weather forecast display
option * Additional weather parameters (feels like temperature, pressure) * Weather
alerts and warnings integration

**🎨 Version 1.3 – Design & Customization**
 * More built-in theme variants and 
color schemes * Custom weather icon sets * Enhanced CSS customization options in
admin

**🔧 Version 1.4 – WordPress Integration**
 * Gutenberg block for visual editor 
integration * WordPress Widget support for sidebar placement * Enhanced shortcode
builder with live preview

**🌍 Version 1.5 – Advanced Features**
 * Geolocation-based automatic city detection*
Multiple weather data provider support * Air quality index integration

**💡 Have Feature Ideas?**
 We welcome feedback and feature requests! Contact us
through the [WordPress support forum](https://wordpress.org/support/plugin/fyp-weather/)
or visit [francoisyerg.net](https://francoisyerg.net) for direct contact.

## 螢幕擷圖

 * [[
 * **Stunning Weather Widget Display** – Beautiful gradient design showing temperature,
   weather icon, description, humidity, and wind speed with smooth animations
 * [[
 * **Multiple Theme Variants** – Default, dark, and light theme options with custom
   CSS class support
 * [[
 * **Easy to use shortcode** – Clear and intuitive shortcode usage
 * [[
 * **Comprehensive Admin Settings** – User-friendly configuration panel for API 
   key, default settings, and display options
 * [[
 * **FYPlugins ready** – Faster, stronger, easier with FYPlugins core integrated

## 安裝方式

**🚀 Automatic Installation (Recommended)**
 1. Login to your WordPress admin dashboard
2. Navigate to **Plugins  Add New** 3. Search for **“FYP Weather”** 4. Click **“
Install Now”** and then **“Activate”**

**📁 Manual Installation**
 1. Download the plugin ZIP file 2. Upload to `/wp-content/
plugins/fyp-weather/` directory 3. Activate the plugin through the **Plugins** menu
in WordPress

**⚙️ Configuration Setup**
 1. **Get your API key:** Visit [OpenWeatherMap](https://openweathermap.org/appid)
and register for a free account 2. **Configure the plugin:** Go to **WordPress Admin
FYPlugins  Weather** 3. **Enter your API key** and set your default city and preferences
4. **Start using:** Add `[fyplugins_weather]` shortcode anywhere on your site

**✅ Quick Test**
 Add `[fyplugins_weather city="London, UK"]` to any post or page
to test the plugin immediately!

## 常見問題集

### 🎨 Does this plugin work with any theme?

**Absolutely!** FYP Weather is designed to work flawlessly with all WordPress themes.
The plugin uses modern CSS that adapts to your theme’s styling while maintaining
its beautiful design. It includes built-in responsive design and theme variants (
default, dark, light).

### 🔑 Do I need an API key?

**Yes, but it’s free and easy!** You need a free API key from [OpenWeatherMap](https://openweathermap.org/appid).
The free tier generously provides 1,000 API calls per day, which is more than enough
for most websites. Getting an API key takes just 2 minutes.

### ⚡ How does the caching system work?

**Smart and automatic!** The plugin uses WordPress transients to cache weather data
for exactly 1 hour (3600 seconds). This means faster loading times for your visitors
and efficient use of your OpenWeatherMap API quota. The cache updates automatically
when the data expires.

### 🎛️ Can I customize the weather display?

**Extensively!** You can customize almost everything:
 – Show/hide weather description,
humidity, wind speed – Custom labels for all elements – Different temperature units(
°C, °F, K) – Custom CSS classes for unique styling – Multiple display locations 
with different settings

### 🌍 What languages are supported?

**30+ languages automatically!** The plugin detects your WordPress language setting
and requests weather descriptions in that language from OpenWeatherMap. The supported
languages are mapped from WordPress locales including English, French, German, Spanish,
Italian, Portuguese, Russian, Chinese, Japanese, Korean, Arabic, and many others.
If your language isn’t supported, it defaults to English.

### 🏙️ Can I display weather for multiple cities?

**Yes, unlimited cities!** Use multiple shortcodes with different city parameters
anywhere on your site. Each can have different styling and display options. Perfect
for travel sites, international businesses, or multi-location organizations.

### 🚀 Does it affect my site’s performance?

**Minimal impact, maximum performance!** FYP Weather is optimized for speed with:
–
WordPress transient caching (1-hour weather data storage) – Lightweight CSS file(
under 3KB) – Efficient API calls with 10-second timeout protection – Clean, optimized
PHP code following WordPress standards – No JavaScript dependencies

### ⏱️ How often is weather data updated?

**Real-time with smart caching!** Weather data is fetched in real-time from OpenWeatherMap
but cached using WordPress transients for exactly 1 hour. This provides up-to-date
information while ensuring fast loading times and efficient API usage.

### 🛠️ What happens if the API is unavailable?

**Graceful error handling!** The plugin includes comprehensive error handling:
 –
User-friendly error messages like “Error: Unable to fetch weather data” – Secure
error display when API key is missing – Timeout protection (10 seconds max) – No
site breaking or white screens of death

### 📱 Is it mobile-friendly?

**100% responsive!** The plugin includes mobile-first design with:
 – Responsive
layouts that adapt to any screen size – Touch-friendly interface elements – Optimized
typography for mobile reading – Adaptive animations and transitions

### 🎨 Can I customize the styling?

**Multiple ways to style!** You can customize the appearance through:
 – Custom 
CSS classes via shortcode parameters (class attribute) – Built-in CSS classes like.
dark and .light variants – Override default styles in your theme’s CSS – Developer-
friendly CSS structure with semantic class names

### 🔧 Is it developer-friendly?

**Absolutely!** The plugin features:
 – Clean, documented PHP code following WordPress
coding standards – PSR-4 autoloading with proper namespacing (FYPlugins\Weather)–
WordPress transient system for caching – Translation-ready with .pot file included–
Proper uninstall cleanup (removes options and clears cache) – Semantic HTML structure
for easy styling

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈FYP Weather〉的開發相關工作。

參與者

 *   [ François Yerg ](https://profiles.wordpress.org/francoisyerg/)

[將〈FYP Weather〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/fyp-weather)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/fyp-weather/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/fyp-weather/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/fyp-weather/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/fyp-weather/)。

## 變更記錄

#### 1.1.1 – Core update

**UPDATED:** Core version 1.3.4

#### 1.1.0 – Templates & UI Enhancements

** ✨ New in 1.1.0 **
 * Add support for multiple templates via the `template` shortcode
attribute and global Template settings * New modern `split` template (left icon 
+ temp, right details) and `compact` template * New **Template** admin tab to manage
default template and default display options * Shortcode examples updated to demonstrate`
template="split"` and `template="compact"` * Minor CSS improvements for the split
layout and responsive behavior

#### 1.0.1 – Core upgrade

** 🚀 Update FYPlugin core to version 1.2.1 **
 * Introduce switch fields for admin
forms * Use switch fields instead of checkbox for settings

#### 1.0.0 – Initial Release 🎉

**🌟 Core Features:**
 * OpenWeatherMap API integration with secure HTTPS connections*
Beautiful, responsive weather widget with modern gradient design * Customizable 
shortcode `[fyplugins_weather]` with 10+ parameters * Comprehensive admin settings
panel at FYPlugins  Weather * Support for metric (°C), imperial (°F), and standard(
K) temperature units

**🌍 Multilingual & Accessibility:**
 * Automatic language detection supporting 
30+ languages based on WordPress locale * Internationalization ready with .pot translation
file * Semantic HTML structure for accessibility compliance * Weather descriptions
in user’s language from OpenWeatherMap

**⚡ Performance & Reliability:**
 * WordPress transient caching system with 1-hour
data retention (3600 seconds) * Optimized API calls with 10-second timeout protection*
Lightweight CSS file (under 3KB) with no JavaScript dependencies * Memory-efficient
code following WordPress standards

**🎨 Design & Customization:**
 * Modern gradient design with weather icons from
OpenWeatherMap * Smooth CSS animations and transitions with fadeInUp animation *
Mobile-first responsive design that adapts to all screen sizes * Custom CSS class
support for unlimited styling options * Built-in dark and light theme variants

**🔧 Developer Features:**
 * Clean, documented PHP code with PSR-4 autoloading *
Proper WordPress namespacing (FYPlugins\Weather) * WordPress transient system for
efficient caching * Translation-ready with proper text domain usage * Proper uninstall
cleanup (removes all options and cached data)

**🛡️ Security & Error Handling:**
 * Comprehensive input validation and sanitization*
Graceful error handling with user-friendly messages * Secure API key storage and
transmission * Protection against API timeouts and invalid responses

**📊 Display Options:**
 * Configurable weather description display * Optional humidity
information with custom labels * Optional wind speed display with custom labels *
Flexible city selection per shortcode instance * Weather icon integration from OpenWeatherMap
servers

## 中繼資料

 *  版本 **1.1.1**
 *  最後更新 **3 個月前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.8 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.9.4**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/fyp-weather/)
 * 標籤
 * [openweather](https://tw.wordpress.org/plugins/tags/openweather/)[shortcode](https://tw.wordpress.org/plugins/tags/shortcode/)
   [temperature](https://tw.wordpress.org/plugins/tags/temperature/)[weather](https://tw.wordpress.org/plugins/tags/weather/)
   [widget](https://tw.wordpress.org/plugins/tags/widget/)
 *  [進階檢視](https://tw.wordpress.org/plugins/fyp-weather/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/fyp-weather/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/fyp-weather/reviews/)

## 參與者

 *   [ François Yerg ](https://profiles.wordpress.org/francoisyerg/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/fyp-weather/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://buymeacoffee.com/francoisyerg)