Menu definitie en afhandeling version

Transcriptie

1 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>! <item caption=value param=value... />! hoogste niveau menu! <item caption = value >! begin uitklap menu!! <item caption=value param=value.../>!een mneu regel van 2de niveau!! <item caption=value param=value.../>!een mneu regel van 2de niveau! </item>! einde uitklap menu </menu> Voorbeeld: <item caption="live Data" >! <item! nr="21"!! show="wdlpage"!!!! link="wdl/incwdlive.php"!!! caption="wd Live"!!!! title="wd Live Data"!!! />! <item! nr="25"!! show="yes"!!!!! link="gauges/gauge.php"!!! caption="steelseries"!!! title="steel series"!!! head="gauges/topcss.php"!!! /> </item> parameter omschrijving default nr show caption title link uniek nummer/tekst waarmee de pagina wordt opgeroepen 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"] de beschrijvende tekst in het menu meer uitgebreide beschrijving die wordt getoond als er boven het menu even gewacht (ge hover d) wordt met de muis de naam van het programma onderdeel wat de pagina vervaardigt (php) of direct de naam van de af te beelden pagina (html) yes gizmo wordt op de betreffende pagina wel ('1') of niet ('0') de ajax/gizmo in de kop afgebeeld 0 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"

2 parameter omschrijving default head voor een enkel programma moet er soms zeer specifieke informatie in de <head> 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 <ul><li> structuur gegenereerd t.b.v. de display van de menu s en opgeslagen in een tijdelijke tabel waarmee de menukeuze wordt gecontroleerd. Ons voorbeeld: <li class="withimg"><a href="#" title=""> live data </a> <ul> <li><a href="index.php?p=21" title="wd live data">wd live</a></li> <li><a href="index.php?p=25" title="steel series test">steelseries</a></li> </ul> </li> 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 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.

3 Meegeleverde menu (- bij het nummer betekent: in sub menu) 10 wsajaxdashboard.php Basis ajax/ javascript startscherm 12 wswxsim/wswxsimprintfull.php 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 14 inc/rain3sources.php 3 verschillende neerslagradars, zie ook menu 44 Uitklap menu Live Data -21 wdl/incwdlive.php wssettingsweather.php: weather display live op basis eigen clientraw files $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'; Flash pagina van meteoware voor die gebruikers die geen WD live of steelseries willen gebruiken Het programma wordt helaas niet meer actief ondersteund Wordt apart voor ieder weerprogramma ingesteld

4 -23 inc/incwdlive.php wssettingsweather.php: meteoplug versie weather display live (geen eigen bestanden nodig) $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 Uitklap menu Mesonet -31 mesomaps/incbnlwn.php mesomaps/incakwn.php voor beide. Kies en zet de andere op 'no' Benelux Weer Netwerk of Alaska Weer Netwerk: kaart en lijst met alle aangesloten stations -32 ewn/ewnpage.php Alleen voor deelnemers aan EWN. Anders wordt een lege pagina afgebeeld European Weather Network pagina Setting: $SITE['ewnID']= false;

5 -33 glo/incglobalmap.php Wereldkaart (google map) met aangesloten stations Let op, soms is googlemap erg belast en verschijnt er geen kaart -34 buoy/incbuoycss.php 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 Wolken radar stilstaand beeld -44 inc/rain3sources.php Zelfde pagina als apgina 14 maar ingesteld op 'no' Buienradar verwachting 3 volgende uren en een pagina met meerdere buienradars Als u een kleiner (korter) menu wilt, zet 14 op 'no' en 44 op 'yes'

6 -45 inc/onweerradar.php 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 -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 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'] = 'no'; $SITE['yrnoPage'] = 'yes'; $SITE['worldPage'] = 'no'; $SITE['yahooPage'] = 'yes'; -51 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

7 -54 wshwa/hwafullpage.php Alleen voor HWA leden. $SITE['hwaPage']= 'no'; 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 uw eigen wxsim verwachting met iconen, meteogram met meerdere tabs en drie of vier tabellen De METAR van nabijgelegen vliegvelden. -57 meteoalarm/ meteoalarmprintwarnings.php alleen voor Europa Naast de korte informatie in de warnbox bovenaan iedere pagina staan hier iets meer gedetailleerde weer waarschuwingen -58 uv/incuvforecast.php Meerdaagse UV verwachting inc/airqualitybe.php inc/airqualitynl.php Nederlandse en Belgische verwachtingen voor de luchtkwaliteit 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

8 -62-1 wu/wu-history.php Kan alleen afgebeeld worden als u data aanlevert aan WU $SITE['wuHistPage']= 'yes'; $SITE['wuId']! ='yourid'; De standaard Weather Underground pagina met waardes over verschillende periodes in het verleden (dag/week/mnd/jaar) wswugraphs/wswugraphs.php Kan alleen afgebeeld worden als u data aanlevert aan WU $SITE['wuHistPage']= 'yes'; $SITE['wuId']! ='yourid'; WU-graphs van pocasi.hovnet.cz/ De standaard map wordt gebruikt (wxwugraphs) een nieuw release kan zo makkelijk over genimewn worden er is een klein opstart script in wswugraphs -64 inc/graphs.php Afhankelijk van welk weerprogramma wordt gebruikt Weergrafieken geleverd door het weerprogramma -65 inc/allinone.php Afhankelijk van welk weerprogramma wordt gebruikt Weergrafiek alles in 1 geleverd door Meteoplug -66 space/incspace.php Zonneactiviteit, alleen in het engels -67 inc/astronomy.php Zon- en maanstanden

9 -68 quake/quakeprint.php Waargenomen aardbevingen inclusief afstanden -69 soil/soiltotals.php $SITE['soilpage']!= false; 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 -80 about/wsabout.php -81 inc/links.php -82 partners/partners.php standaard pagina over dit weerstation standaard pagina met links naar andere weersites e.d. weer organisatie waarmee wordt samengewerkt -83 inc/status.php -86 contact/inccontact.php standaard pagina met status weer apparatuur en programma bezoeker kan hiermee een sturen aan de webmaster.

10 -88 inc/sitemap.php standaard pagina met menustructuur in tekst -89 inc/whoisonline.php? wie is online. deze pagina moet nog wel wat verbeterd worden 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 inc/meteohubdocs.php info pagina voor website beheerder / ontwikkelaar met meteohub info inc/tagsmh.php inc/tagswd.php inc/tagscw.php inc/tagscu.php inc/tagswl.php inc/tagsmb.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 inc/meteohubdocs.php info page for webmaster / developer contains meteohub info cltraw/cltrawxref.html info pagina voor ontwikkelaars met een xross-reference van alle clientraw velden 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 Voorbeeld voor een nieuwe (lege) pagina met wat toelichting in de source. Gaarne commentaar aan wvdkuil@hotmail.com