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:

  • 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:

NimiSelitys
tabsTaulukko upokkeen välilehdistä. Jokaiselle välilehdelle on mahdollista asettaa parametrit title ja params
title

Yksittäisen välilehden otsikko

paramsParametrit, joilla tapahtumia suodatetaan rajapinnasta kyseiselle välilehdelle. Parametrit annetaan avain/arvo pareina
searchToolsNä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
limitKuinka monta tapahtumaa ladataan upokkeeseen kerrallaan
navStyleNavigointityyli. 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.

  • No labels