Le module **forecast** est l’évolution du module **Weather** qui utilise l'API [WeatherApi] (https://www.weatherapi.com/). Il permet d’afficher la météo actuelle et les prévisions d’une ville, directement sur votre site, en utilisant l’API [OpenWeatherMap](https://openweathermap.org/).

5 commits 1 branch 0 tags 49 KiB

PHP 80.4%
CSS 19.6%

Find a file

Lemimi d661f16ad6 Actualiser readme.md		2025年09月30日 14:50:15 +02:00
view	Téléverser les fichiers vers "view/config"	2025年09月30日 14:47:40 +02:00
changes.md	Téléverser les fichiers vers "/"	2025年09月30日 14:43:04 +02:00
enum.json	Téléverser les fichiers vers "/"	2025年09月30日 14:43:04 +02:00
forecast.php	Téléverser les fichiers vers "/"	2025年09月30日 14:43:04 +02:00
readme.md	Actualiser readme.md	2025年09月30日 14:50:15 +02:00

readme.md

🌦️ Module forecast pour ZwiiCMS

Le module forecast est l’évolution du module Weather qui utilise l'API [WeatherApi] (https://www.weatherapi.com/).
Il permet d’afficher la météo actuelle et les prévisions d’une ville, directement sur votre site, en utilisant l’API OpenWeatherMap.

✨ Fonctionnalités

Affiche la météo actuelle (température, humidité, pression, vent, visibilité, lever et coucher du soleil).
Prévisions détaillées sur plusieurs jours.
Choix du format de date et d’heure.
Système de cache pour limiter les appels à l’API.
Configuration simple via l’interface d’administration de ZwiiCMS.
Multilingue (basé sur les paramètres de l’API OpenWeatherMap).

📋 Prérequis

Un serveur web compatible avec PHP 8.1 ou supérieur.
ZwiiCMS installé et fonctionnel.
Une clé API OpenWeatherMap (gratuite pour un usage limité).

🔧 Configuration

Installation du module
- Copier le dossier du module forecast dans site/module/ de votre installation ZwiiCMS.
Obtenir une clé API OpenWeatherMap
- Créez un compte sur OpenWeatherMap.
- Générez une clé API gratuite.
Configurer le module dans ZwiiCMS
- Accédez à l’administration de votre site.
- Rendez-vous sur la page de configuration du module forecast.
- Renseignez :
  - Ville (ex : Paris)
  - Clé API
  - Unités (métrique ou impérial)
  - Langue (ex : fr)
  - Nombre de jours de prévisions (jusqu’à 14, limité à 5 avec l'API gratuite)
  - Formats de date et d’heure selon vos préférences

📂 Fichiers créés

Cache JSON : site/data/weather/weather.json
Contient la configuration et les données météo en cache (8 minutes par défaut).

⚠️ Limitations

Limite d'appels API : OpenWeatherMap limite le nombre d'appels à 60/minute pour les comptes gratuits. Précision des prévisions : Les prévisions sont basées sur les données fournies par OpenWeatherMap.

📜 Licence Ce module est distribué sous la licence CC Attribution-NonCommercial-NoDerivatives 4.0 International.

Remerciements

Données météo fournies par OpenWeatherMap.