Préparer votre module
Ce module est un ensemble de fichiers que vous aurez à copier sur votre site; mais au préalable voyons à adapter votre module
Étape 1 : Extraction de l'archive
Ce module est compressé en format .zip pour commodité. Décompressez le contenu du fichier mdq_tableau_Fr_v1.zip sur votre ordinateur. Vous vous retrouverez avec un dossier meteoqc comprenant le module d"affichage et toutes ses composantes.
Contenu de l'archive :
- meteoqc - Ce dossier regroupe vos modules.
- tab_quotidien_large.php - Tableau des données quotidiennes, en format large (1115px).
- tab_quotidien.php - en format condensé (875px).
- tab_observations_ext.php - Toutes les observations (inclu Température et Humidité intérieure)
- tab_observations.php - Toutes les observations
- lib - Dossier des librairies essentielles
- i18n - Dossier de langues disponibles
- accesbd.php - Fichier des informations de connexion
- tableaux - Dossier contenant les fichiers nécessaires à la lecture de la base de donnée.
Étape 2 : Configurer votre module :
Pour que votre module fonctionne correctement, vous devez en premier lieu le renseigner sur les paramêtres de connexion à utiliser pour accèder à votre base de donnée MySQL.
Éditer le fichier accesbd.php (au besoin):
Si vous avez déjà un autre module ou script Météo du Québec sur votre site, il se peut bien que votre installation comprenne déjà le fichier de configuration nécessaire sous le chemin meteoqc/lib/accesbd.php. Si c"est le cas, effacez simplement le fichier accesbd.php que vous venez de décompresser et passez à l'étape suiuvante.
Le fichier accesbd.php sert à emmagasiner vos informations d'accès à MySQL et à les fournir aux Modules Météo du Québec, lorsqu'un accès à la base de donnée est nécessaire.
Le fichier accesbd contient simplement 4 lignes que vous devez éditer
$bdhote = '127.0.0.1';
$bdusager = 'UsagerSQL';
$bdmotpasse = 'MotPasseSQL';
$bdnom = 'NomBase';
- $bdhote: Le nom d'hôte de votre serveur, habituellement : '127.0.0.1' ou 'localhost'.
- $bdusager: Le nom d'usager pour accéder la base de donnée. Ici : 'UsagerSQL'
- $bdmotpasse: Le mot de passe pour accéder la base de donnée. Ici : 'MotPasseSQL'
- $bdnom: Nom de la base de donnée. Exemple, ici : 'NomBase'
Finalement, enregistrez simplement vos modifications. Le lien entre votre base de donnée et votre nouveau module Tableaux Météo est prêt.
Étape 3: Choisir votre affichage
Le module Tableaux météo contien au total 4 affichage différents pour convenir à vos besoins.
Le Tableau Principal
Cet affichage présente les observations quotidiennes telles qu'importées du fichier Dayfile.txt de Cumulus. Les champs proviennent de votre base de donnée 'Dayfile" sur le serveur web.
Colonnes du tableau principal :
| Titre |
Champ |
Description |
| Date |
LogDate |
la date, format jj-mm-aa |
| Rafale max (Km/h) |
HighWindGust |
le plus fort coup de vent |
| Direc. du Vent |
HWindGBear |
direction du plus fort coup de vent |
| Heure rafale |
THWindG |
heure du fort haut coup de vent |
| Temp Min.(°C) |
MinTemp |
température minimale |
| Heure Min. |
TMinTemp |
heure de température minimale |
| Temp Max.(°C) |
MaxTemp |
température maximale |
| Heure Max. |
TMaxTemp |
heure de température maximale |
| Temp moy (°C) |
AvgTemp |
température moyenne pour la journée |
| + Basse pression (mb) |
MinPress |
pression minimale |
| Heure +Basse |
TMinPress |
heure de pression minimale |
| + Haute pression (mb) |
MaxPress |
pression maximale |
| Heure +Haute |
TMaxPress |
heure de pression maximale |
| Averse max (mm/h) |
MaxRainRate |
averse maximale |
| Heure averse |
TMaxRR |
heure de l'averse maximale |
| Pluie Totale (mm) |
TotRainFall |
pluie totale pour le jour |
| Course du Vent (Km) |
TotWindRun |
le parcours total du vent |
Ce tableau est offert en 2 formats :
- tab_quotidien_large.php - Pour le format de 1115px de large
- tab_quotidien.php - Pour le format condensé en 875px.
Choisissez simplement le fichier selon la taille qui vous convient.
Le Tableau des Observations
Cet affichage présente toutes les observations telles qu'importées des fichiers mensuels de Cumulus. Les champs proviennent de votre base de donnée 'Monthly' sur le serveur web.
Colonnes du tableau Observations :
| Titre |
Champ |
Description |
| Date |
LogDate |
la date sous la forme jj/mm/aa |
| Heure |
LogTime |
heure actuelle |
| Temp ext (°C) |
Temp |
température actuelle |
| Hum ext (%) |
Humidity |
humidité actuelle |
| Point rosée (°C) |
Dewpoint |
point de rosée actuel |
| Vitesse Vent (°C) |
Windspeed |
vitesse actuelle du vent |
| Rafale (Km/h) |
Windgust |
rafale de vent actuelle |
| Direct Vent |
Windbearing |
direction actuelle du vent |
| Averse Max.(mm) |
RainRate |
pluie actuelle |
| Pluie aujour (mm) |
TodayRainSoFar |
pluie totale aujourd'hui pour l'instant |
| Pression (mb) |
Pressure |
pression actuelle |
| Pluie (mm) |
Raincounter |
pluie totale à date |
| Temp int.(°C) |
InsideTemp |
température intérieure |
| Hum int.(%) |
InsideHumidity |
humidité intérieure |
| Dernière rafale (Km/h) |
LatestWindGust |
rafale actuelle (la dernière) |
| Facteur Éolien (°C) |
WindChill |
refroidissement éolien |
| Humidex (°C) |
HeatIndex |
indice de chaleur |
Ce tableau est offert en 2 variantes :
- tab_observations_ext.php - Pour les données extérieures seulement
(Pour que les internautes ne sachent pas que vous êtes radin sur le chauffage ou la climatisation de votre domicile! ;-))
- tab_observations.php - Toutes les données incluant la température et l'humidité intérieure.
(Pratique pour trouver des extrêmes erronés qui faussent vos statistiques.)
Choisissez simplement le(s) fichier(s) qui vous convient.
Chacun des affichages étant optionnel, vous pouvez effacer les tableaux qui vous sont inutiles.
Mise en place de votre module
Maintenant que vous avez configuré votre module et choisi les tableaux qui vous intéressent, il ne reste plus qu'à copier le tout sur votre site et à y insérer ces tableaux.
Étape 1: Copie des fichiers
- Copiez le dossier meteoqc et tout son contenu à la racine de votre site.
Note: Ne craignez pas pour vos autres modules Météo du Québec, même si vous avez déjà le dossier meteoqc, tous les modules sont intégrables et ont étés conçus pour s'installer sans heurt (seul le fichier accesbd.php doit être protégé comme mentionné ci-haut)
Étape 2: Afficher les tableaux
Pour intégrer vos nouveaux tableaux dans votre site web, vous devez lier les fichiers choisis précédement. Pour ce faire, je vous propose 2 solutions:
- Option 1: Dans un cadre
Cette option permet d'incorporer votre tableau à une page existante, pré-stylisée; donnant ainsi une apparence plus harmonieuse à votre Module Tableaux.
Pour ce faire, à l'endroi voulu sur votre page, insérez une commande "iframe" comme celle-ci:
<iframe src="meteoqc/tab_quotidien.php" width="875px" height="460px" marginheight="0px" marginwidth="0px" scrolling ="no" ></iframe>
Cet exemple de cadre permet d'intégrer le module Module Tableau à une de vos pages. Vous n'avez qu'à copier cette ligne dans votre page Web pour avoir un encadré de 875 x 460 points
- Option 2: En page autonome
Vous pouvez aussi intégrer vos tableaux comme page distincte et autonome. Cette méthode à pour avantage de permettre une mise en page impécable; puisque le texte s'adaptera au tableau, au lieu de s'adapter au cadre
Pour ce faire à l'intérieur des fichiers tableau (tab_...php), repérez les commentaires suivants:
<!-- Votre texte au dessus du tableau -->
et
<!-- Votre texte au dessous du tableau -->
Insérez vos modifications sous le commentaire approprié, en prenant garde de ne pas modifier la division tableau et son contenu!
Et Voilà! Vous disposez d'un nouveau module d'affichage riche en possibilités
