1
0
Fork
You've already forked Weather-Openweather
0
Ce module permet d'afficher les conditions météorologiques actuelles et les prévisions pour une ville donnée, en utilisant l'API [OpenWeatherMap](https://openweathermap.org/). Il est conçu pour être intégré à [ZwiiCMS](https://zwiicms.fr/).
  • PHP 78.9%
  • CSS 21.1%
Find a file
2025年09月28日 17:24:36 +02:00
view Actualiser view/config/config.php 2025年09月28日 16:48:05 +02:00
changes.md Actualiser changes.md 2025年09月28日 16:43:18 +02:00
enum.json Actualiser enum.json 2025年09月28日 16:42:07 +02:00
readme.md Actualiser readme.md 2025年09月28日 17:24:36 +02:00
weather.php Actualiser weather.php 2025年09月28日 16:40:51 +02:00

Module Weather pour ZwiiCMS

Affiche la météo en temps réel pour une ville donnée, avec prévisions et tendances.

📌 Description

Ce module permet d'afficher les conditions météorologiques actuelles et les prévisions pour une ville donnée, en utilisant l'API OpenWeatherMap. Il est conçu pour être intégré à ZwiiCMS.

Fonctionnalités :

  • Affichage des conditions météo actuelles (température, humidité, vent, etc.).
  • Prévisions sur plusieurs jours (configurable).
  • Cache des données pour limiter les appels à l'API.
  • Interface responsive et moderne.

📋 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é).

🛠 Installation

  1. Copier le module : Placez le dossier weather dans le répertoire /site/module/ de votre installation ZwiiCMS.

  2. Activer le module :

    • Connectez-vous à l'administration de ZwiiCMS.
    • Allez dans Modules et activez le module Weather.

  3. Configurer le module :

    • Accédez à la page de configuration du module (/weather/config).
    • Renseignez votre clé API OpenWeatherMap, la ville par défaut, et les autres paramètres (unité, langue, nombre de jours de prévision).

📂 Structure des données

Les données sont stockées dans le dossier site/data/weather/ sous forme de fichiers JSON (weather.json). Le dossier et le fichier JSON sont créés automatiquement lors de l'installation du module.

⚙ Configuration

Paramètres disponibles

Paramètre Description Valeur par défaut
city Nom de la ville pour laquelle afficher la météo. ""
units Unité de mesure (metric, imperial). metric
apiKey Clé API OpenWeatherMap (obligatoire). ""
lang Langue des descriptions météo (fr, en, etc.). fr
days Nombre de jours de prévision (max 14). 3
dateFormat Format d'affichage de la date (ex: DdMY). ldFY
timeFormat Format d'affichage de l'heure (ex: H;i). H;i

Exemple de configuration

\$config = [
 'city' => 'Paris',
 'units' => 'metric',
 'apiKey' => 'votre_clé_api_openweathermap',
 'lang' => 'fr',
 'days' => 5,
 'dateFormat' => 'DdMY',
 'timeFormat' => 'H:i',
];
🔧 Utilisation
Affichage des données météo
Accédez à la page /weather pour voir les conditions météo actuelles et les prévisions.
Les données sont mises en cache pendant 8 minutes pour éviter les appels fréquents à l'API.
Personnalisation
Vous pouvez modifier le fichier view/index/index.php pour adapter l'affichage.
Les icônes météo sont fournies par OpenWeatherMap et affichées dynamiquement.
📂 Structure du module
weather/
├── weather.php # Logique principale du module
├── view/
│ ├── index/
│ │ ├── index.php # Vue principale (affichage météo)
│ │ └── index.css # Style CSS pour la vue
│ └── config/
│ ├── config.php # Vue de configuration
│ └── config.css # Style CSS pour la configuration
├── README.md # Ce fichier
└── changes.md # Documentation des modifications importantes

⚠️ 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.