Widget Météo pour ZwiiCMS

Module d'affichage météo autonome, ou fichier externe, basé sur Open-Meteo

📌 Description

• Ce module permet d'afficher un widget météo complètement autonome avec un appel direct à l'API OpenMeteo.
• Une option permet d'afficher des prévisions complètes générées par un module externe forecast_openmeteo.
• Il propose :
  • Un affichage compact des conditions météo actuelles.
  • Une prévision horaire sur 6 heures.
  • Une redirection personnalisable vers une page météo détaillée.
  • Une configuration simple via l'interface admin.

---

📦 Installation

1. Copier le module :

   • Placez le dossier widget_meteo dans le répertoire module/ de votre installation ZwiiCMS.

2. Configurer le module :

   • Ajoutez le module à une page via l'éditeur ZwiiCMS.
   • Accédez à la configuration du module pour définir les options proposées.

---

🛠️ Configuration

Paramètres disponibles

• Mode API Open-Meteo (direct) Les données sont récupérées directement depuis l'API Open-Meteo. Configuration par défaut.
• Mode Fichier externe Les données sont lues depuis site/data/weather_openmeteo/weather.json.
  • Ce fichier doit être généré par le module forecast_openmeteo (à installer séparément).
• URL de redirection Lien vers une page météo détaillée (laisser vide pour désactiver). | https://mon-site.com/meteo |

Fichier de données

Le module lit les données météo depuis : site/data/weather_openmeteo/weather.json.

• Ce fichier doit être généré par le module forecast_openmeteo (à installer séparément).

Capture de la position actuelle

Un bouton "📍 Capturer ma position actuelle" est disponible dans la page de configuration du module.
Ce bouton utilise la géolocalisation du navigateur pour remplir automatiquement les champs latitude, longitude et ville.

Conditions requises :

Le site doit être en HTTPS (obligatoire pour la géolocalisation).
L'utilisateur doit autoriser l'accès à sa position.

Fonctionnement :

Les coordonnées GPS sont récupérées via l'API de géolocalisation HTML5.
Le nom de la ville est déterminé grâce au service gratuit OpenStreetMap/Nominatim.
Aucune donnée n'est enregistrée sur le serveur, elles servent uniquement à configurer le module.

---

📝 Utilisation

Affichage du widget

• Le widget s'affiche automatiquement sur les pages où il est inséré.

• En mode visiteur, il montre :

  • La température actuelle.
  • Les conditions météo (soleil, pluie, etc.).
  • Le vent, l'humidité, et les heures de lever/coucher du soleil.
  • Une prévision horaire sur 6 heures.

• Clic sur le widget :

  • Si une URL de redirection est configurée, le clic redirige vers cette page.

Mode admin

• En mode configuration, le module affiche un formulaire pour personnaliser l'URL de redirection.

---

💡 Astuces

Positionnement des modules dans ZwiiCMS

Les modules ZwiiCMS ne peuvent pas être alignés à un endroit précis sur votre page avec l'éditeur intégré. Par défaut, ils sont centrés en haut ou en bas de page, ou à l'endroit de l'appel via le mot-clé [MODULE].

Pour remédier à cela :

• Créez un tableau à une ou deux colonnes avec l'éditeur intégré de ZwiiCMS.
• Avec Épaisseur de la bordure réglée à 0, le tableau sera transparent.
• Insérez le mot-clé [MODULE] dans la cellule de votre choix.
• Le module s'affichera alors exactement à l'endroit souhaité dans votre mise en page.

---

🔧 Dépendances

• ZwiiCMS (version 13.7 ou supérieure).
• Module forecast_openmeteo (pour générer le fichier weather.json), en mode Fichier externe.

---

📜 Licence

Ce module est distribué sous licence CC BY-NC-ND 4.0 (Attribution - Pas d’Utilisation Commerciale - Pas de Modification).

• Auteur : Michel Tuboeuf
• Site : ZwiiCMS

---

Remerciements

• Open-Meteo : Pour leur API météo gratuite et open-source.
• ZwiiCMS : Pour ce CMS simple et efficace, et à @Fred pour son idée de module complètement autonome 💡