François Yerg

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:
<ul>
<li>🎨 Modern Weather Widget: Gradient backgrounds, weather icons from OpenWeatherMap, and smooth CSS animations</li>
<li>⚡ Smart Caching System: 1-hour WordPress transient caching improves performance and reduces API usage</li>
<li>🌐 True Multilingual Support: Automatic language detection for weather descriptions in 30+ languages</li>
<li>📊 Complete Weather Data: Temperature, weather description, humidity, wind speed, and weather icons</li>
<li>🎛️ Flexible Display Options: Show/hide weather elements with customizable labels via admin settings</li>
<li>📐 Multiple Unit Systems: Metric (°C), Imperial (°F), and Standard (Kelvin) temperature units</li>
<li>🎯 Powerful Shortcode: <code>[fyplugins_weather]</code> with extensive customization parameters</li>
<li>📱 Responsive Design: Mobile-optimized layout that adapts to any screen size</li>
<li>⚙️ Professional Admin Interface: Clean settings panel with API configuration and default options</li>
<li>🔒 Secure & Reliable: Proper error handling, data validation, and secure API integration</li>
<li>** CSS Customization:** Additional CSS classes and built-in styling options</li>
<li>** ️ Clean Uninstall:** Properly removes all options and cached data when uninstalled</li>
</ul>
This plugin is part of the FYPlugins ecosystem, designed to provide high-quality WordPress solutions with exceptional performance and user experience.
<h3>Usage</h3>
🚀 Quick Start:
<ol>
<li>Get your FREE API key from <a href="https://openweathermap.org/appid" rel="nofollow ugc">OpenWeatherMap</a> (1,000 free calls/day)</li>
<li>Configure the plugin at WordPress Dashboard → FYPlugins → Weather</li>
<li>Add weather anywhere using the <code>[fyplugins_weather]</code> shortcode</li>
</ol>
📋 Basic Examples: 
 <code>[fyplugins_weather] 
[fyplugins_weather city="Paris, France" units="metric"] 
[fyplugins_weather city="New York, NY" units="imperial" show_humidity="false"]</code>
🎨 Styling Examples: 
 <code>[fyplugins_weather class="dark"] 
[fyplugins_weather class="light custom-weather"]</code>
<h3>Shortcode Parameters</h3>
🌡️ Weather Shortcode – <code>[fyplugins_weather]</code>
<pre><code>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
</code></pre>
📝 Advanced Examples:
<pre><code>// 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"]
</code></pre>
🌍 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.
<h3>External Services</h3>
🌐 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 (<a href="https://openweathermap.org/" rel="nofollow ugc">openweathermap.org</a>) 
– Terms of Service: <a href="https://openweathermap.org/terms" rel="nofollow ugc">OpenWeather Terms & Conditions</a> 
– Privacy Policy: <a href="https://openweather.co.uk/privacy-policy" rel="nofollow ugc">OpenWeather Privacy Policy</a> 
– 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)
<h3>Roadmap & Future Enhancements</h3>
🚀 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 <a href="https://wordpress.org/support/plugin/fyp-weather/" rel="ugc">WordPress support forum</a> or visit <a href="https://francoisyerg.net" rel="nofollow ugc">francoisyerg.net</a> for direct contact.

FYP Weather

A beautiful, lightweight weather plugin with stunning visual design, smart caching, and comprehensive multilingual support.

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.

FYP Weather vs wp-forecast