Affiche la météo et les prévisions pour une ville donnée via [WeatherAPI](https://www.weatherapi.com/).
Permet également de configurer les unités, le nombre de jours de prévisions, la langue, la qualité de l’air et les alertes météo.
- PHP 94.9%
- CSS 5.1%
| view | Actualiser view/index/index.php | |
| changes.md | Actualiser changes.md | |
| enum.json | Téléverser les fichiers vers "/" | |
| readme.md | Actualiser readme.md | |
| weather.php | Téléverser les fichiers vers "/" | |
Module Weather pour ZwiiCMS
Affiche la météo et les prévisions pour une ville donnée via WeatherAPI.
Permet également de configurer les unités, le nombre de jours de prévisions, la langue, la qualité de l’air et les alertes météo.
Fonctionnalités
- Météo courante : température, humidité, vent, UV, pression, visibilité, précipitations.
- Tendances heure par heure.
- Prévisions sur plusieurs jours (configurable, par défaut 3 jours, jusqu'à 14 jours maximum).
- Affichage de la qualité de l’air (PM2.5, PM10, O3, NO2, SO2, CO) si activé.
- Alertes météo via WeatherAPI.
- Gestion du cache simple pour réduire les appels à l’API (10 minutes par défaut).
- Configuration facile via l’interface admin.
Installation
- Copier le module dans le répertoire
modules/weatherde votre ZwiiCMS. - Assurez-vous que le dossier
site/data/weather/est accessible en écriture (pour le cache et la configuration). - Créer un compte gratuit sur WeatherAPI et récupérer une clé API.
- Configurer le module via l’interface admin :
- Ville par défaut (ou latitude/longitude)
- Clé API
- Unités : métrique ou impérial
- Langue
- Nombre de jours de prévisions
- Activation ou non des alertes et de la qualité de l’air
- Formats date/heure
Configuration
Exemple des options disponibles dans le formulaire admin :
| Option | Description |
|---|---|
| city | Ville pour laquelle récupérer la météo |
| Ou indiquez la latitude et la longitude du lieu. Pour Paris : 48.86, 2.35 | |
| units | Unités : metric (°C, km/h) ou imperial (°F, mph) |
| apiKey | Clé API WeatherAPI |
| lang | Langue des données (fr, en, de, es, it, pt, el, tr) |
| days | Nombre de jours pour les prévisions (1 à 14) |
| aqi | Activer la qualité de l’air |
| alerts | Activer les alertes météo |
| dateFormat | Format de la date (ex: %A %d %B %Y) |
| timeFormat | Format de l’heure (ex: %H:%M) |
Utilisation
-
Page publique :
/weather/index
Affiche la météo courante et les prévisions. -
Page de configuration :
/weather/config
Accessible aux utilisateurs avec droit d’édition.
Notes techniques
- Module écrit en PHP orienté objet (classe
weather). - Utilise WeatherAPI pour récupérer les données météo.
- Cache simple stocké dans
site/data/weather/weather.json. - Compatibilité avec PHP >= 7.4 recommandée.
- Gestion automatique des formats de date et heure selon la locale.
Auteurs et contributeurs
- Fred Tempez – auteur principal
- Michel Tuboeuf – contributeur (mises à jour et améliorations)
Licence
Ce module est sous CC Attribution-NonCommercial-NoDerivatives 4.0 International.
Pour plus d’informations, voir https://creativecommons.org/licenses/by-nc-nd/4.0/
Remerciements
Données météo fournies par WeatherAPI.