You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

Oppimateriaalit-välilehti on mahdollista ottaa käyttöön omassa näkymässä. Ennen välilehden käyttöönottamista organisaatioiden tulisi lisätä avoimet oppimateriaalit tietokantoihin (ohjeet tietokannan käyttöönottoon).

Välilehden mukana tulevat myös L1-välilehtikohtaiset rajaimet. Rajaimet voi nähdä käytössä finna.fi-sivustolla.

Välilehden aktivointi

Oppimateriaalit-välilehti kytketään päälle lisäämällä seuraava rivi config.ini -tiedoston SearchTabs-osioon:

[SearchTabs]
L1 = "tabs_l1"

Paikallisen aineiston hakutuloksessa on mahdollista käyttää suosittelijaa, joka ohjaa käyttäjän Oppimateriaalit-välilehdelle kun hakutulos on rajattu oppimateriaaleihin.

Suosittelija kytketään päälle lisäämällä seuraava rivi searches.ini -tiedoston General-osioon:

[General]
default_top_recommend[] = "LearningMaterial"

Näkymässä tulisi nyt näyttäytyä uusi Oppimateriaalit - välilehti alla olevan kuvan mukaisesti.

Oppimateriaalien esirajaus

Toisinaan organisaatioilla voi olla toiveena esittää välilehdellä vain tiettyjä oppimateriaaleja. Esitettäviä oppimateriaaleja voidaan rajata esimerkiksi organisaation mukaan. Ohessa muutamia esimerkkejä rajausten muodostamiseen.

Rajaukset lisätään tiedostoon local/config/vufind/L1.ini. Käytettävä rajauslauseke on yksinkertaisinta selvittää rajaamalla hakutulos Finnassa ja kopioimalla rajaus hakutuloksen urlista.

Esimerkki 1: rajataan näytettävät oppimateriaalit organisaation oppimateriaaleihin

Tee ensin tyhjä Oppimateriaal-haku ja rajaa hakutulos sen jälkeen Tekijä-fasetilla. Esimerkki:
https://finna.fi/L1/Results?filter%5B%5D=%7Eauthor_facet%3A%22Rajala%2C+Jukka%22&type=AllFields

Muuntamalla erikoismerkit urlin tekijä-rajaus on helpommin nähtävissä
https://finna.fi/L1/Results?filter[]=~author_facet:"Rajala, Jukka"&type=AllFields

Kopioi rajaus  L1.ini tiedoston RawHiddenFilters-osioon (kopioi myös Parent_Config -osio tiedoston alkuun):

[Parent_Config]
relative_path = "../finna/L1.ini"
override_full_sections = ""

[RawHiddenFilters]
0 = "(author_facet:\"Rajala, Jukka\")"

Huomaa että nimen ympärillä olevien lainausmerkkien eteen tulee "\" -merkki.

Erikoismerkit voi muuntaa esimerkiksi tällä työkalulla. Kopioi urli tekstikenttään ja klikkaa "Decode".

Tallenna tiedosto ja tee uusi tyhjä haku. Nyt tuloksen pitäisi olla rajattuna tekijän mukaan.

Esimerkki 2: rajataan näytettävät oppimateriaalit tiettyyn koulutusasteeseen

Rajaa haku Koulutusaste-fasetin avulla ja kopioi rajaus L1.tiedostoon:

[Parent_Config]
relative_path = "../finna/L1.ini"
override_full_sections = ""

[RawHiddenFilters]
0 = "educational_level_str_mv: 0/PrePrimaryEducation/"

Välilehden nimeäminen ja kielikäännökset

Jos välilehden nimeä tai sen kielikäännöksiä on tarpeellista muokata, organisaatiot voivat muokata käännösavainta "tabs_l1". Täältä löytyy tarvittaessa lisätietoa kielikäännöksistä.

Välilehden tyylit

Organisaatiot voivat halutessaan muokata LESS-tyyleillä välilehden ulkoasua. Finna.fi-sivustolla LESS-tyyleillä on muokattu esimerkiksi fasettien välistystä sekä välilehtien ulkoasua.

Esimerkki 1:

Asetetaan L1-välilehden faseteille välistyksiä ja ryhmitellään ne samoin kuin finna.fi-sivustolla. Lisätään seuraava tyylimääritys custom.less tiedostoon:

.template-dir-l1.template-name-results {
  .side-facets-container-ajax > h1:first-child {
    margin-bottom: 5px;
  }
  .list-group.facet.facet-group{
    &#side-panel-educational_aim_str_mv {
      margin-bottom: 20px;
    }
  }
}

Esimerkki 2:

Lisätään välilehtien kokoa paddingin avulla, ja muutetaan kirjasinkoko suuremmaksi. Organisaatioiden kannattaa ottaa huomioon, että tämä kyseinen tyylimääritys vaikuttaa näkymän kaikkiin finna-main-tabs välilehtiin. Huomioida kannattaa myös jo organisaatioiden mahdolliset olemassaolevat välilehdet ja niiden määrä. Esimerkin mukainen tyylimuutos kannattaa toteuttaa harkiten, jos välilehtiä löytyykin omasta näkymästä jo useampi. Tehdään seuraava tyylimääritys custom.less tiedostoon:

.finna-main-tabs ul.nav-tabs > li > a {
padding: 10px;
font-size: 18px;
}


Oppimateriaalit sisältösivuilla

Oppimateriaaleja voi tuoda sisältösivulle RSS-muotoisena sisältönä. Tällöin ne voidaan esittää kuvakarusellissa, uutislistauksessa tai esimerkiksi ruudukossa. Tutustu RSS-muotoisen sisällön tuominen näkymään. Esimerkkikuvassa näkyy oppimateriaaleja kuvakarusellissa.

Syötteen tekeminen suosikkilistasta

Suosikkilista on yksi työkalu millä voidaan kerätä aineistoja, joita halutaan esittää RSS-syötteessä. Finnan ohjeista löydät kattavasti tietoa Suosikkilistoista.

  • Kirjaudu ensin sisään Finnaan ja etsi haluamaasi aineistoa.
  • Lisää aineistoa suosikkilistalle klikkaamalla nastakuvaketta. Löydät nastakuvakkeen hakutulossivulta aineiston oikealta puolelta.
  • Valitse avautuvasta valikosta suosikkilista, jolle haluat valitun aineiston tallentaa. Kaikki aiemmin luomasi listat näkyvät Valitse lista -valikossa. Uuden suosikkilistan luot valitsemalla tai luo uusi lista.
  • Paina lopuksi Tallenna.

Jotta pääset muodostamaan syötteen, tarkastele suosikkilistaasi katselunäkymässä. Valitse listan näkyvyydeksi Julkinen. Klikkaamalla Listan julkinen linkki, avautuu suosikkilistasi katselunäkymään. Katselunäkymässä RSS-syöte löytyy katselunäkymän alaosasta. 

Katselunäkymän pitäisi avautua XML-tiedostoon selaimessasi jolloin voit kopioida talteen osoiterivistöllä olevan URL-osoitteen tai kopioidan sivun sisällön uuteen xml-tiedostoon.

URL-osoitteen hyödyntäminen

Osoiterivistöltä kopioitu URL-osoite voidaan syöttää hallintaliittymässä syötekomponentin URL-kenttään. Huomioithan, että URL-osoitteen täytyy viitata finna.fi -palvelimelle (tai organisaationäkymään xyz.finna.fi). Tämä tarkoittaa, että käytettävä suosikkilista on tehty tuotantonäkymässä.

Kaikille kielille yhteinen URL syötetään kenttään URL(*), kielikohtaiset tämän alle.

XML-tiedoston hyödyntäminen

Kopioituasi sivun sisällön uuteen XML-tiedostoon voit ottaa sen käyttöön. Paikallisen tiedoston osoite voidaan syöttää hallintaliittymässä syötekomponentin URL-kenttään. Paikallisen tiedoston voi myös valita listasta, kentän vieressä olevasta kansio-ikonista. Huomioithan ettet käytä osoitteena finna-test.fi -osoitetta tai finna-pre.fi -osoitetta, vaan paikallisen tiedoston nimeä (esim. themes/custom/templates/rss/uusimmat.rss).

Screenshot from 2019-08-22 09-37-49.png

Syötekomponentin asetuksista voit muokata syötteen esitystapaa. Asetusten säätämisen jälkeen RSS-komponentti tulee lisäksi lisätä johonkin sivuphjaan. Tarvittava PHP-koodi löytyy asetusten jälkeen kohdasta "Kopioi sivupohjaan" (ks. esimerkki tiedostosta themes/finna/templates/search/home/home-2.phtml).

  • No labels