LinkedEvents on Helsingin kaupungin julkaisema avoimen lähdekoodin tapahtumarajapinta. Rajapinta on kaikille avoin, joten kuka vain voi luoda tunnuksen ja lisätä (mutta ei julkaista) sekä selata tapahtumia. Jotta tapahtuman voi julkaista, tulee kuulua johonkin organisaatioon. Oikeudet omaan organisaatioon saa rajapinnan ylläpidolta. LinkedEventsissä on vain Helsingin tapahtumia, joten saadakseen oman tapahtumarajapinnan tulee tehdä paikallinen toteutus LinkedEventsistä (esim. https://www.satakuntaevents.fi, https://www.hameevents.fi)
- LinkedEventsin lähdekoodi: https://github.com/City-of-Helsinki/linkedevents
- Yleiset ohjeet: https://linkedevents.hel.fi/fi/help/instructions/general
Kun oma paikallinen toteutus rajapinnasta on tehty, voi Finna-näkymään tuoda tapahtumia LinkedEvents -rajapinnasta.
Tarvitset:
- oman rajapinnan URLin sekä
- oman organisaation tunnisteen (publisher_id) omassa rajapinnassa.
Nämä asetetaan tiedostoon local/config/vufind/OrganisationInfo.ini (esimerkki Satakirjastojen konfiguraatiosta)
[LinkedEvents] api_url = "https://satakuntaevents.fi/api/v2/" publisher_id = "finna:satakirjastot"
Tämän jälkeen näkymässä voi käyttää välilehtiupoketta (esimerkki taas Satakirjastoilta, parametrin keyword arvot ovat rajapintakohtaisia):
<?= $this->linkedEventsTabs(['tabs' => [ [ 'title' => 'Näyttelyt', 'params' => ['keyword' => 'pori:topic:exhibitions'] ], [ 'title' => 'Kirjallisuus', 'params' => ['keyword' => 'pori:topic:literature'] ], [ 'title' => 'kaikki' ], ], 'searchTools' => 'show', 'limit' => 6, 'navStyle' => 'pills', 'showMobileAccordion' => false, ]); ?>
Upokkeen parametrit:
Nimi | Selitys |
---|---|
tabs | Taulukko upokkeen välilehdistä. Jokaiselle välilehdelle on mahdollista asettaa parametrit title ja params |
title | Yksittäisen välilehden otsikko |
params | Parametrit, joilla tapahtumia suodatetaan rajapinnasta kyseiselle välilehdelle. Parametrit annetaan avain/arvo pareina |
searchTools | Näytetäänkö hakutyökalut upokkeessa. Hakutyökaluihin kuuluu vapaatekstihaku, joka kohdistuu tapahtuman nimeen ja paikannimeen sekä mahdollisuus rajata tapahtumia päivämäärän mukaan. Arvot: hide/show |
limit | Kuinka monta tapahtumaa ladataan upokkeeseen kerrallaan |
navStyle | Navigointityyli. Oletuksena välilehtityyli. Vaihtoehtona voi käyttää pills-tyyliä (arvona: pills). Huom.! Toiminnallisuus on käytössä 7.11.2023 julkaistavasta versiosta lähtien. |
showMobileAccordion | Asetuksella voi määrittää näytetäänkö accordion-tyylinen navigointi mobiilissa. Arvot true/false. Huom.! Toiminnallisuus on käytössä 7.11.2023 julkaistavasta versiosta lähtien. |
Välilehtiupoke:
Välilehtityyli
Pills-tyyli
Pills-tyylin elemettejä on mahdollista muokata seuraavilla less-muuttujilla. Muutokset pitää tehdä less-tiedostoon.
//== Feed nav pills styles @feed-nav-pills-border-radius: @border-radius-base; @feed-nav-pills-padding: 0 15px; @feed-nav-pills-color: @action-link-color; @feed-nav-pills-bg: @body-bg; @feed-nav-pills-border: 1px solid @action-link-color; @feed-nav-pills-active-color: @component-active-color; @feed-nav-pills-active-bg: @component-active-bg; @feed-nav-pills-active-border: @feed-nav-pills-border; @feed-nav-pills-active-hover-bg: @component-active-bg; @feed-nav-pills-active-hover-color: @component-active-color; @feed-nav-pills-active-hover-border: @feed-nav-pills-border;
Tapahtumasivu
Tapahtumaa klikkaamalla pääsee tapahtuman sivulle, jossa näkyy tapahtuman tarkemmat tiedot.