Menu definitie en afhandeling
version 2.30 2013-09-30
Dit document bestaat uit twee delen: Eerst een wat technische beschrijving over hoe de menu's worden gegenereerd door de template. Dan voor ieder mogelijk menu item een korte beschrijving van 1. wat wordt getoond en 2. enkele hints over de benodigde instellingen. Een groot deel van het menu kan pas worden getoond nadat u in het wsSettings.php script (= de instellingen) de zaken aangepast heeft voor uw situatie. Loop dit document daarom op uw gemak door en controleer of u wel alle mogelijke informatie aan uw bezoekers toont. Definitie van de menu’s De menu’s zijn gedefinieerd in een xml bestand in de hoofdmap van de template: /weather2/incMenuData.xml
De xml structuur is een verdere ontwikkeling op de Saratoga versie van de template set die de menu’s eveneens in een xml bestand opsloeg. <menu> !
! hoogste niveau menu !
- ! begin uitklap menu ! !
! einde uitklap menu
Voorbeeld:
- !
parameter
omschrijving
nr
uniek nummer/tekst waarmee de pagina wordt opgeroepen
show
wordt de pagina wel of niet afgebeeld. De toegelaten waardes zijn 'yes' 'no' true false of een verwijzing naar de $SITE tabel. Het voorbeeld show="wdlPage" verwijst naar $SITE["wdlPage"]
caption
de beschrijvende tekst in het menu
title
meer uitgebreide beschrijving die wordt getoond als er boven het menu even gewacht (ge “hover”d) wordt met de muis
link
de naam van het programma onderdeel wat de pagina vervaardigt (php) of direct de naam van de af te beelden pagina (html)
gizmo
wordt op de betreffende pagina wel ('1') of niet ('0') de ajax/gizmo in de kop afgebeeld
css
voor die pagina’s die een eigen zeer specifieke CSS tabel nodig hebben wordt hier de verwijzing naar het bestand opgenomen. LET OP inclusief alle mappen onder de hoofdmap weather2. Een css bestand WU-HistoryTan.css in de folder wu wordt dus ingevoerd als css="wu/WU-HistoryTan.css"
default
yes
0
Menu definitie en afhandeling parameter head
version 2.30 2013-09-30 omschrijving
default
voor een enkel programma moet er soms zeer specifieke informatie in de sectie van de te genereren html worden opgenomen. Voornamelijk voor de googlemap-V2 programma’s en voor die programma’s die NIET door google geïndexeerd kunnen worden. De parameter head=”progr_naam.php” zorgt ervoor dat vlak voor het einde van de head sectie het vermelde programma wordt uitgevoerd. Een dergelijk programma genereert dan de specifieke css of voegt een nofollow metatag in. Vermeld altijd het volledige pad vanaf de weather2 map.
Generatie van de menu structuur Tijdens de generatie van de pagina html wordt de /weather2/incMenuData.xml ingelezen en wordt er een
- structuur gegenereerd t.b.v. de display van de menu’s en opgeslagen in een tijdelijke tabel waarmee de menukeuze wordt gecontroleerd. Ons voorbeeld:
- live data
Zoals u ziet wordt in de gegenereerde html GEEN exacte programmanaam en GEEN folder naam weergegeven. De menu keuze wordt met een eenvoudige GET (die in de adresbalk van de browser zichtbaar is) doorgegeven aan de webserver. In ons voorbeeld als de gebruiker WD Live kiest wordt de keuze doorgegeven als http://www.uw_web_site.com/weather/index.php?p=21
Alles wat een eventuele hacker zou kunnen zien is het nummer wat bij de menukeuze hoort. Controle geldigheid van de menu-keuze In index.php wordt iedere menukeuze van de gebruiker met de tabel gecontroleerd. Nummers die niet in de tabel staan mogen niet voorkomen, anders dan doordat Hackers in de adresbalk willekeurige nummers intypen. Zij worden steeds netjes doorverwezen naar de beginpagina. Overige aspecten van de menu’s Horizontaal versus verticaal Er is geen verschil in afhandeling of verschil in html code tussen Horizontale of Verticale menu’s. Gebruik / wijzigingen xml Zoals ook al door Ken van Saratoga in zijn versie van de xml menu structuur wordt vermeld is xml nogal streng en kan de minste slordigheid de totale weer template laten stoppen. In de toekomst moet er een menu-editor komen die eenvoudig menu wijzigingen laat doorvoeren. Maar voor nu: uiterst contentieus werken, altijd een extra back-up achter de hand en zeer frequent testen. Niet alles is geschikt voor echte website. Een aantal pagina’s (met blauw aangegeven in de tabel hieronder) zijn eigenlijk alleen nuttig tijdens de bouw van de website. Om te grote / lange menu’s te vermijden kunnen deze voor een produktie website verwijderd worden met behulp van show=’no’. Niet alles wordt direct afgebeeld na installatie. Een aantal pagina’s (met geel aangegeven in de tabel hieronder) zijn afhankelijk van correct waardes in settingsSite.php. Die worden na de eerste installatie pas getoond als de waardes in de settings zijn aangepast.
Menu definitie en afhandeling
version 2.30 2013-09-30
Meegeleverde menu (- bij het nummer betekent: in sub menu) nr
programma
10
wsAjaxdashboard.php
12
wsWxsim/wsWxsimPrintFull.php
14
omschrijving Basis ajax/ javascript startscherm
Setting $SITE['wxsimPage']= 'no';
voorspellling gebaseerd op uw eigen wxsim voorspellingen Benodigd: uw eigen wxsim programma op een windows pc. wxsim moet twee bestanden opladen naar uw web-server: plaintext.txt en latest.csv of lastret.txt De instellingen voor wxsim zitten in een apart bestand: weather2/wsWxsim/wsWxsimSettings.php
inc/rain3Sources.php
3 verschillende neerslagradars, zie ook menu 44
Uitklap menu Live Data -21
wdl/incWdlive.php
weather display live op basis eigen clientraw files
wsSettingsWeather.php: $SITE['wdlPage'] = 'no';
Dit wordt ingesteld voor ieder weer programma apart. Omdat niet ieder programma de clientraw kan opladen -22
mwlive/wsMWlive.php wsSettingsWeather.php: $SITE['mwPage'] = 'no';
Wordt apart voor ieder weerprogramma ingesteld
Flash pagina van meteoware voor die gebruikers die geen WD live of steelseries willen gebruiken Het programma wordt helaas niet meer actief ondersteund
Menu definitie en afhandeling nr
programma
-23
inc/incWdlive.php
version 2.30 2013-09-30 omschrijving meteoplug versie weather display live (geen eigen bestanden nodig)
wsSettingsWeather.php: $SITE['MeteoplugPage'] = 'no';
Wordt apart voor ieder weerprogramma ingesteld
-24
inc/meteoplugLiveDashboard.php
meteoplug dashboard
standaard ingesteld op 'no'
-25
gauges/gauge.php
Steelseries gauges
standaard ingesteld op 'yes'
Uitklap menu Mesonet -31
mesomaps/incBNLWN.php mesomaps/incAKWN.php standaard ingesteld op 'yes' voor beide. Kies en zet de andere op 'no'
-32
ewn/ewnPage.php Alleen voor deelnemers aan EWN. Anders wordt een lege pagina afgebeeld Setting: $SITE['ewnID']= false;
Benelux Weer Netwerk of Alaska Weer Netwerk: kaart en lijst met alle aangesloten stations
European Weather Network pagina
Menu definitie en afhandeling nr
programma
-33
glo/incGlobalMap.php standaard ingesteld op 'yes'
-34
buoy/incBuoyCss.php standaard ingesteld op 'yes'
version 2.30 2013-09-30 omschrijving Wereldkaart (google map) met aangesloten stations Let op, soms is googlemap erg belast en verschijnt er geen kaart
Kaart met actieve weerboeien voor de kust in west-europa
Uitklap menu Kaarten -41
inc/hwakaartjes.php Alleen voor HWA deelnemers
HetWeerActueel kaarten voor de huidige weer condities in de Benelux
$SITE['hwaPage']= 'no';
-42
inc/cloudRadar.php standaard ingesteld op 'yes'
-44
inc/rain3Sources.php Zelfde pagina als apgina 14 maar ingesteld op 'no' Als u een kleiner (korter) menu wilt, zet 14 op 'no' en 44 op 'yes'
Wolken radar stilstaand beeld
Buienradar verwachting 3 volgende uren en een pagina met meerdere buienradars
Menu definitie en afhandeling nr
programma
-45
inc/onweerRadar.php
version 2.30 2013-09-30 omschrijving Onweer / inslagen over west Europa. Er zijn meerdere kaarten (heel Europa / west Europa / uk etc). Vooralsnog alleen in te stellen via aanpassingen in het programma zelf
standaard ingesteld op 'yes'
-46
ewn/ewnMapsPage.php
Weerkaarten voor EWN deelnemers.
Alleen voor EWN deelnemers Setting: $SITE['ewnID']= false; -47
inc/meteoxWorldMap.html tandaard ingesteld op 'yes'
Weergave van temperaturen wereldwijd, vult hele scherm automatisch dus geen menus meer
Uitklap menu Vooruitzichten --50-3 -51-2 -52 -53
forecasts/incWuForecast2.php forecasts/incYrnoForecast2.php forecasts/ incWorldForecast2.php forecasts/incYahooForecast2.php u moet ook nog de juiste key en andere plaatsgegevens instellen. $SITE['wuPage'] $SITE['yrnoPage'] $SITE['worldPage'] $SITE['yahooPage']
-51
= = = =
'no'; 'yes'; 'no'; 'yes';
wsMetNo/metnoFullPage.php Dit is het standaard script voor de template, ingesteld via $SITE['fctOrg'] = 'metno'; $SITE['fctContent']= 'icons'; $SITE['metnoPage'] = 'yes';
De verschillende verwachtingen verschillen slechts voor het aantal weer parameters (= kolommen in tabel). De iconen kunnen via $SITE gestandaardiseerd worden Zeer uitgebreide Yr.NO (Met.No) voorspelling met iconen, meteogram en tabel met twee tabbladen
Menu definitie en afhandeling nr
programma
-54
wsHwa/hwaFullPage.php Alleen voor HWA leden. $SITE['hwaPage']= 'no';
version 2.30 2013-09-30 omschrijving De HWA verwachting heeft ook de meerdaagse XML verwachting in de bekende HWA/MOS, iconen, meteogram en in tabel Werkt alleen voor HWA leden met hun id en key
-55
wsWxsim/wsWxsimPrintFull.php gelijk aan menu 12, ingesteld 'no'
-56
metar/metarDisplay.php standaard ingesteld op 'yes'
-57
meteoalarm/ meteoalarmPrintWarnings.php alleen voor Europa standaard ingesteld op 'yes'
-58
uv/incUvForecast.php
uw eigen wxsim verwachting met iconen, meteogram met meerdere tabs en drie of vier tabellen De METAR van nabijgelegen vliegvelden.
Naast de korte informatie in de warnbox bovenaan iedere pagina staan hier iets meer gedetailleerde weer waarschuwingen Meerdaagse UV verwachting
standaard ingesteld op 'yes'
-59-1 -59-2
inc/airQualityBE.php inc/airQualityNL.php
Nederlandse en Belgische verwachtingen voor de luchtkwaliteit
standaard ingesteld op 'yes'
Uitklap menu Almanak -61
inc/trends.php wordt afgebeeld afhankelijk van welk weerprogramma wordt gebruikt
De standaard trends pagina met gizmo/ajax ookvoor eigen waardes
Menu definitie en afhandeling nr -62-1
programma wu/WU-History.php Kan alleen afgebeeld worden als u data aanlevert aan WU
version 2.30 2013-09-30 omschrijving De standaard Weather Underground pagina met waardes over verschillende periodes in het verleden (dag/week/mnd/jaar)
$SITE['wuHistPage']= 'yes'; $SITE['wuId']! ='yourID';
-62-2
wsWuGraphs/wsWuGraphs.php
WU-graphs van pocasi.hovnet.cz/
Kan alleen afgebeeld worden als u data aanlevert aan WU
De standaard map wordt gebruikt (wxwugraphs) een nieuw release kan zo makkelijk over genimewn worden
$SITE['wuHistPage']= 'yes'; $SITE['wuId']! ='yourID';
-64
inc/graphs.php Afhankelijk van welk weerprogramma wordt gebruikt
-65
inc/allInOne.php Afhankelijk van welk weerprogramma wordt gebruikt
-66
space/incSpace.php standaard ingesteld op 'yes'
-67
inc/astronomy.php standaard ingesteld op 'yes'
er is een klein opstart script in wsWuGraphs
Weergrafieken geleverd door het weerprogramma
Weergrafiek “alles in 1” geleverd door Meteoplug
Zonneactiviteit, alleen in het engels
Zon- en maanstanden
Menu definitie en afhandeling nr
programma
-68
quake/quakePrint.php standaard ingesteld op 'yes'
-69
soil/soilTotals.php $SITE['soilpage']!= false;
version 2.30 2013-09-30 omschrijving Waargenomen aardbevingen inclusief afstanden
pagina over de gegevens van de bodem sensoren (als aanwezig)
Uitklap menu Diversen -110
mobi/redirect.php
voor doorverwijzing naar mobile website voor telefoons en sommige tablets
standaard ingesteld op 'yes'
-80
about/wsAbout.php standaard ingesteld op 'yes'
standaard pagina over “dit weerstation”
-81
inc/links.php standaard ingesteld op 'yes'
standaard pagina met links naar andere weersites e.d.
-82
partners/partners.php standaard ingesteld op 'yes'
-83
inc/status.php standaard ingesteld op 'yes'
-86
contact/incContact.php standaard ingesteld op 'yes'
weer organisatie waarmee wordt samengewerkt
standaard pagina met status weer apparatuur en programma bezoeker kan hiermee een e-mail sturen aan de webmaster.
Menu definitie en afhandeling
version 2.30 2013-09-30
nr
programma
omschrijving
-88
inc/sitemap.php
standaard pagina met menustructuur in tekst
standaard ingesteld op 'yes' -89
inc/whoIsOnline.php
? wie is online. deze pagina moet nog wel wat verbeterd worden
standaard ingesteld op 'yes'
de volgende pagina is de laatste van het normale menu 200
customize.php
Gebruiker kan hier zijn schermlayout en kleur aanpassen
de volgende pagina’s worden alleen afgebeeld in “debug-mode” -93-0
inc/meteohubDocs.php
info pagina voor website beheerder / ontwikkelaar met meteohub info
-93-1 -93-2 -93-9 -93-3 -93-4 -93-8
inc/tagsMH.php inc/tagsWD.php inc/tagsCW.php inc/tagsCU.php inc/tagsWL.php inc/tagsMB.php
-93-10
inc/meteohubDocs.php
info page for webmaster / developer contains meteohub info
-93-5
cltraw/cltrawXref.html
info pagina voor ontwikkelaars met een xross-reference van alle clientraw velden
-93-6
cltraw/incClientraw4.php
info pagina voor ontwikkelaars met alle velden in de clientraw bestanden die naar de eigen website zijn opgeladen. De pagina kan op een produktiewebsite ook voor bezoekers interessant zijn. Zij kunnen dan de bestanden van hub eigen website analyseren.
-94
wsIcons/wsIcons.php
overzicht pagina’s met alle iconen die binnen de template in gebruik zijn
-95
wsWxsim/wsWXSIMfields.php
field names as used in the wxsim data files
-96
wsWxsim/wsWXSIMconditions.php
descriptive text of the conditions used by the wxsim program
-900
inc/wsNewPage.php
info pagina’s (t.b.v. foutlokatie e.d.) voor de website beheerder met alle veldnamen en de bijbehorende waarde die naar de website zijn opgeladen.
Voorbeeld voor een nieuwe (lege) pagina met wat toelichting in de source.
Gaarne commentaar aan [email protected]
