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)
Kun oma paikallinen toteutus rajapinnasta on tehty, voi Finna-näkymään tuoda tapahtumia LinkedEvents -rajapinnasta.
Tarvitset:
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, ]); ?> |
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. |
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; |
Tapahtumaa klikkaamalla pääsee tapahtuman sivulle, jossa näkyy tapahtuman tarkemmat tiedot.