🌦️ 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

1. Installation du module

   • Copier le dossier du module forecast dans site/module/ de votre installation ZwiiCMS.

2. Obtenir une clé API OpenWeatherMap

   • Créez un compte sur OpenWeatherMap.
   • Générez une clé API gratuite.

3. 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.

© 2018-2025 Fred Tempez & Michel Tuboeuf

Remerciements

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