Suhtlus — avalik kalender
Suhtluse abil saad luua ka avaliku kalendri, mis sisaldab ainult eraldi avalikuks tehtud sündmuseid ning mida saad soovi korral näiteks kooli veebilehele lisada.
Kui oled võimalusest huvitatud, võta Stuudiumi meeskonnaga ühendust Abi kaudu, ja lülitame avaliku kalendri sisse.
Sündmuste avaldamine kalendris toimib nii:
- Suhtluses on uus grupp nimega "Avalik"
Sinna saab sündmusi lisada samamoodi, nagu teistesse gruppidesse — vali sündmust lisades adressaadiks "Avalik", ja üritus ilmubki kalendrisse; samuti on võimalik olemasolevale sündmusele lisada osalejaks "Avalik"
Gruppi "Avalik" saavad üritusi lisada vaid administraatori poolt määratud inimesed
- Sündmus ilmub kalendrisse, mis on avalikult (ka sisse logimata kasutajatele) nähtaval aadressil https://kooli-kalender.stuudium.com/koolinimi/
Kalendrile võid veebilehelt viidata lihtsalt lingiga, aga soovi korral saad kalendri ka otse lehele embed-ida.
Kalendri lisamine kodulehele
Lisa see koodijupp kodulehel kohta, kus soovid kalendrit näidata:
<script defer src="https://kooli-kalender.stuudium.com/koolinimi/calendar.js"></script>
Info arendajatele
Avaliku kalendri sündmusi saab pärida ka JSON formaadis.
Aadressi aluseks on: https://kooli-kalender.stuudium.com/koolinimi/api/events
Vajalikud parameetrid:
date-start=aaaa-kk-pp
(sündmused alates mis kuupäevast)date-end=aaaa-kk-pp
(sündmused kuni mis kuupäevani)v=1
(versioon 1, hetkel ainus toetatud väärtus)format=json
(vastuse formaat, hetkel onjson
ainus toetatud väärtus)
date-start
ja date-end
ajavahemik võib olla kuni 60 päeva.
Lõplikuks aadressiks on näiteks https://kooli-kalender.stuudium.com/koolinimi/api/events?v=1&format=json&date-start=2018-09-01&date-end=2018-09-31
Päringu vastus:
Vastusel on päis Access-Control-Allow-Origin: *
, mis tähendab, et andmeid saab pärida otse veebilehel oleva Javascript koodiga, tehes AJAX päringu.
JSON array määratud ajavahemikus olevate sündmustega
[
{
"title": "Test avalik s\u00fcndmus",
"body": "- Siin on sisu\n- Teksti kujul\n\n\ud83d\udc4f",
"event_date": "2018-09-08",
"event_date_end": "2018-09-09",
"event_time": "14:00:00",
"event_time_end": null
},
{
"title": "Teine Test",
"body": "Siin on veel sisu",
"event_date": "2018-09-10",
"event_date_end": null,
"event_time": null,
"event_time_end": null
}
]
Selgitus:
title
- sündmuse ehk sõnumi pealkiribody
- sündmuse ehk sõnumi sisuevent_date
- sündmuse kuupäev; mitmepäevase sündmuse puhul alguskuupäevevent_time
- sündmuse alguskellaaeg (võib ollanull
)event_date_end
- sündmuse lõpukuupäev, kui tegu on mitmepäevase sündmusega (võib ollanull
, kui sündmuse algus- ja lõpukuupäev on samad)event_time_end
- sündmuse lõpukellaaeg (võib ollanull
)- Kui sündmusel on algus- ja lõpukuupäev ning algus- ning lõpukellaaeg, tähendab see, et sündmus algab "alguskuupäev + alguskellaaeg" hetkel, ning lõpeb "lõpukuupäev + lõpukellaaeg" hetkel.
- Kui sündmusel algus- või lõpukellaaega pole (väärtus
null
), on tegu kogu päeva kestva (või muul põhjusel määramata kellaajaga) sündmusega. Kellaaeg võib aga olla ka näiteks "00:00:00", mis tähistab keskööd. Kuupäevad ja kellaajad on Eesti kohaliku aja järgi.
title
jabody
väljastatakse samal kujul, nagu info kasutaja poolt sisestati. See tähendab, et sisu ei tohi muutmata kujul html lehele väljastada, vaid peab seda eelnevalt turvaliseks töötlema — näiteks asendades<
ja>
märgid vastavalt>
ja<
-ga