Ideal Weather – Documentation
Ideal Weather affiche la météo actuelle de votre ville avec des icônes animées et la vraie phase de la lune. Ce guide couvre l’installation, la clé OpenWeather, l’affichage et les réglages.
Prérequis
- Joomla 4.4, 5 ou 6 et PHP 8.1 ou plus récent
- YOOtheme Pro 4 ou 5 pour l’élément du constructeur (le module fonctionne avec tous les templates)
- Une clé API OpenWeather gratuite (voir ci-dessous)
Installation
- Téléchargez le ZIP depuis Mes licences ou depuis le lien de l’e-mail de commande. Ne le décompressez pas.
- Dans Joomla, ouvrez Système › Installer › Extensions et déposez le ZIP dans Envoyer un paquet.
- Le plugin « Système - Ideal Weather » s’active tout seul. Si vous aviez l’ancien module IdealWeather 8.x, il est mis à jour et vos réglages sont conservés.
Une nouvelle version s’installe de la même façon, par-dessus l’ancienne. Votre contenu et vos réglages sont conservés.
Clé de licence et mises à jour
Votre clé de licence (format IDPC-XXXX-XXXX-XXXX-XXXX) figure dans l’e-mail de commande et sur la page Mes licences. Collez-la une seule fois par site :
- Ouvrez Système › Mettre à jour › Sites de mise à jour.
- Cliquez sur Ideal Weather : Joomla signale « clé de téléchargement manquante ».
- Collez la clé dans le champ Clé de téléchargement, puis Enregistrer et fermer.
Les nouvelles versions apparaissent ensuite dans Système › Mettre à jour › Extensions et s’installent en un clic. Les mises à jour et le support par e-mail sont inclus pendant 12 mois. Ensuite, l’extension continue de fonctionner sans limite de durée ; seul l’accès aux nouvelles versions s’arrête. Vous pouvez renouveler à tout moment depuis Mes licences.
La clé ne se met pas dans les réglages du plugin ni dans YOOtheme. La même clé sert pour toutes vos extensions IdealPC.
Le paquet installe le composant (Composants › Ideal Weather), le module Joomla et l’élément YOOtheme Pro.
1. Clé OpenWeather
Sans clé, pas de météo réelle. La clé est gratuite et l’offre gratuite d’OpenWeather suffit largement grâce au cache intégré.
- Créez un compte sur openweathermap.org.
- Confirmez votre adresse e-mail (lien reçu par e-mail), puis copiez votre clé dans l’onglet « API keys ».
- Dans Joomla, ouvrez Système › Plugins › Système - Ideal Weather et collez la clé. Elle sert à tous les modules et éléments du site.
Une nouvelle clé peut mettre jusqu’à 2 heures à s’activer. Pendant ce temps, un message « Clé API refusée » s’affiche aux administrateurs (jamais aux visiteurs) ; l’extension réessaie toute seule toutes les 5 minutes.
2. Afficher la météo
Avec YOOtheme Pro : dans le constructeur, ajoutez l’élément Ideal Weather (groupe IdealPC), puis indiquez la ville (« Neuchâtel,CH ») ou la latitude et la longitude.
Sans YOOtheme : créez un module Ideal Weather dans Contenu › Modules de site, choisissez sa position et ses pages.
Détails au choix : ville, description, ressenti, min/max, humidité, vent, pression, lever/coucher du soleil, phase de lune. Unités °C ou °F ; vent en km/h, m/s, mph, nœuds ou Beaufort.
3. Styles et mises en page
- Styles d’icônes : Classique, Ligne (prend la couleur du texte), Dégradé, Minimal. Toutes sont animées ; les animations s’arrêtent pour les visiteurs qui ont demandé à réduire les mouvements, ou se coupent avec le réglage « Icônes animées ».
- Mises en page : carte verticale, horizontale, ou en ligne (en-tête, menu).
- Lune la nuit : vraie phase calculée pour le jour même, ou croissant classique.
- Style Classique uniquement : « Couleurs des icônes » pour fond clair ou sombre.
4. Prévisions des jours suivants
Le réglage Prévisions des jours suivants (onglet Contenu du module) ou Prévisions (onglet Contenu de l’élément YOOtheme) ajoute une rangée avec la météo des 1 à 5 prochains jours, à partir de demain : jour, icône, maximum et minimum. Par défaut : « Aucune ».
- Utilise les prévisions gratuites d’OpenWeather (5 jours par tranches de 3 heures) : la même clé suffit.
- Les prévisions sont gardées en cache au moins 1 heure : un seul appel de plus par heure et par lieu.
- Selon l’heure, le 5e jour peut être incomplet (limite de l’offre gratuite).
- Pas de prévisions avec la mise en page « En ligne », ni quand seule l’icône est affichée.
- En mode « Aperçu », des prévisions d’exemple sont affichées.
Mode « Aperçu »
Le réglage Aperçu (sans clé) affiche une météo d’exemple (13 conditions, de jour et de nuit) sans appeler OpenWeather. Pratique pour mettre en page avant l’activation de la clé. La mention « Aperçu · données d’exemple » est toujours affichée : remettez le réglage sur « Météo réelle » avant la mise en ligne.
Sites multilingues
Avec « Langue de la description » sur Automatique, la description et les libellés suivent la langue de chaque page. Les réglages sont traduits en français, anglais, allemand, italien et espagnol.
Reprise de l’ancien module 8.x
Installez simplement le paquet par-dessus l’ancien module : vos modules gardent leur apparence (texte blanc, icônes pour fond sombre, vent en m/s, une décimale). Les anciens fichiers sont supprimés automatiquement.
Questions fréquentes
- La carte n’apparaît pas pour les visiteurs.
- Connectez-vous en administrateur : le message affiché donne la cause (clé manquante, clé pas encore active, ville introuvable). Les visiteurs ne voient jamais d’erreur.
- À quelle fréquence la météo est-elle mise à jour ?
- Toutes les 30 minutes par défaut (réglage « Durée du cache », minimum 10). Si OpenWeather ne répond pas, la dernière météo connue reste affichée jusqu’à 6 heures.
- Puis-je afficher plusieurs villes ?
- Oui : un module ou un élément par ville, autant que vous voulez.
- Les prévisions sur plusieurs jours sont-elles incluses ?
- Non, Ideal Weather affiche la météo actuelle.
Support
Une question, un bug, une idée ? Écrivez à