Taivaanvahdin materiaalin liitokset ja linkitys

Sisältö

Taivaanvahdin sisällön liitos tapahtu kahdessa vaiheessa: ensin muodostetaan hakuosoite ja sitten liitetään kotisivulle koodi joka sisältää hakuosoitteen. Pärjäät hyvin kun et hätäile, luet ohjeet ja tarvittaessa kysyt apua (mellon[ät]iki.fi).

URL-osoitteen muodostus
Liitostavat: iframella (ilman muotoilua) ja PHP:lla (muotoilumahdollisuuksin).

URL-osoitteen muodostus

Jotta taivaanvahdin tietoa voidaan liittää muille sivuille, tarvitaan osoite liitettävään dataan. Osoite muodostetaan yhdistämällä perusosa (http://www.taivaanvahti.fi/observations/searchPlain/) hakukriteereihin.

Hakukriteerit

Yleiset hakuehdot

name: nimihaku ehdolla voidaan suorittaa haku havaitsijan nimen, sähköpostiosoitteen tai puhelinnumeron perusteella. Hakukenttään voi laittaa myös tiimin nimen.
loc: sijaintihaku ehdolla voidaan suorittaa haku havaintopaikkakunnan perusteella. Huom: voit käyttää haussa useita paikkakuntia erottamalla ne toisistaan alaviivalla (_). Esim. helsinki_espoo_vantaa
cat: ilmötyyppihaku hakuehdolla voidaan valita näkymään vain valitut ilmiötyypit. Mahdolliset ilmiötyypit ovat: revontuli, tulipallo, halo, tahtikuva, pimennys,yopilvi, myrsky ja muu. Samaan ilmiöehtoon voi kuulua useita eri ilmiöluokkia. Tässä tapauksessa ilmiöt tulee erotella hakuehdossa väliviivalla esim. "/cat/pimennys-muu".
limit: lukumäärä asettaa näytettävien hakutulosten maksimimäärän.
sort: järjestyskriteeri arvo asettamalla voidaan määritellä minkä perusteella hakutulokset järjestellään. Vaihtoehtoja on kaksi: observation_start_time (havaintopäivän mukaan) ja observation_id (viimeeksi julkaistu ensin).
order: järjestys hakutulokset voidaan esittää joko nousevassa (desc) tai laskevassa (asc) järjestyksessä.

Päivämääräkriteerit

start_day Alkupäivä
start_month Alkukuukausi
start_year Alkuvuosi
start_hours Alkutunnit
start_minutes Alkuminuutit
end_day Loppupäivä
end_month Loppukuukausi
end_year Loppuvuosi
end_hours Lopputunnit
end_minutes Loppuminuutit

Huom! Jos alku- tai loppuajan haulle antaa, täytyy kaikille viidelle ehtokentälle asettaa arvot.

Esimerkkihakuja:

http://www.taivaanvahti.fi/observations/searchPlain/loc/tampere/sort/observation_start_time/order/desc
Kaikki havainnot Tampereella.
http://www.taivaanvahti.fi/observations/searchPlain/name/Emma%20Herranen/sort/observation_start_time/order/desc
Kaikki Emma Herrasen havainnot.
http://www.taivaanvahti.fi/observations/searchPlain/name/Tampereen%20Ursa/sort/observation_start_time/order/desc
Kaikki Tampereen Ursa-tiimin havainnot.
http://www.taivaanvahti.fi/observations/searchPlain/cat/revontuli/limit/10/sort/observation_start_time/order/desc
10 viimeisintä revontulihavaintoa.
http://www.taivaanvahti.fi/observations/searchPlain/loc/tampere_nokia_kangasala/start_day/1/start_month/1/start_year/2011/start_hours/00/start_minutes/1/end_year/2011/end_month/12/end_day/31/end_hours/23/end_minutes/59
Vuoden 2011 havainnot Tampereelta, Nokialta ja Kangasalta.

Kun olet muodostanut hakuosoitteen, testaa se selaimessasi.

Liitostavat

Helppo: iframe -elementti

Voit käyttää iframe-elementtiä myös Taivaanvahdin materiaalin liittämiseen kotisivullesi. Iframe tarjoaa helpon ja nopean tavan liittää tietoa, mutta sen avulla liitetyn sisällön ulkoasua ei voi helposti muokata. Et siis voi muuttaa iframe-elementin sisällön värejä tai kokoja, mutta itse iframen ominaisuuksia voit normaaliin tapaan muuttaa html-koodissa.

<iframe width=80%  height=200 src="LAITA TÄHÄN HAKUSI URL"></iframe>

Lopputuloksen pitäisi näyttää suurinpiirtein tälle:

Vaikeampi: PHP + CSS

Vaihe 1: Avaa PHP-ympäristössä tiedosto johon haluat lisätä havaintolistan. Leikkaa-liimaa ao. koodi siihen kohtaan sivua missä haluat näyttää havaintotietoja. Korvaa koodista merkkijono OMA_TAIVAANVAHTI_URL osoitteella jonka loit vaiheessa URL-osoitteen muodostus.

<div class="observations">
<?php

$curl_handle=curl_init();
// Vaihda ao. riville juuri luomasi hakuosoite:
curl_setopt($curl_handle,CURLOPT_URL,'OMA_TAIVAANVAHTI_URL');
curl_setopt($curl_handle,CURLOPT_CONNECTTIMEOUT,2);
curl_setopt($curl_handle,CURLOPT_RETURNTRANSFER,1);
$buffer = curl_exec($curl_handle);
curl_close($curl_handle);

if (empty($buffer)){
    print "Pahoittelut, Taivaanvahti on hetkellisesti poissa linjoilta.";
}else{
    print $buffer;
}
?>   
</div>

Muista katsoa että PHP-tiedostollasi on ajo-oikeudet. Lisäksi palvelimella pitää olla curl-kirjastot asennettuna ja enabloituna

Vaihtoehtoinen php-toteutustapa: Tämä tapa vaatii että allow_url_fopen = On php.ini-tiedostossa.

<?php
$url = "OMA_TAIVAANVAHTI_URL";
echo file_get_contents($url);
?>

Vaihe 2: Nyt taulukkoa voidaan muotoilla tyyleillä esim. seuraavasti (tyylimuotoilut sivun <head></head> osioon!):

<style>
   .observations {font-family:Geneva, Arial, Helvetica, sans-serif;font-size: 12px;}
   .observations td {vertical-align:top;text-align:left;}
   .observations th {vertical-align:top;text-align:left;}
   .observations img {float:left;}
   .observations .havaintohaku-date {font-weight:bold;}
</style>

Tiedostosi pitäisi näyttää suurinpiirtein tältä esimerkkisivulta.

Lisää tyylitiedostoista(engl). Kiitokset avusta Netmaan Esa Ajolle!