Muut asetukset

Ylävalikko

Ylävalikon rakenne määritellään Muut asetukset -välilehden kohdassa Navigointivalikko.

Valikkoelementin lisääminen ylävalikkoon:

1. Mene välilehdelle Muut asetukset
2. Mene osioon Navigointivalikko ja paina Muokkaa
3. Paina Lisää valikkoelementti
   

Linkin lisääminen luotuun valikkoelementtiin:

1. Mene välilehdelle Muut asetukset
2. Mene osioon Navigointivalikko ja paina Muokkaa
3. Paina haluamasi elementin kohdalta Lisää linkki

Listalla esitetään valikkoelementit ja näihin kuuluvat linkit, jotka näytetään kun valikko avataan. Elementtien järjestystä voi muokata raahaamalla elementin haluttuun kohtaan listalla. Finnan navigointivalikon oletuselementit voi asettaa piiloon tai esille elementin kohdalla olevasta valintaruudusta. Itse lisätyt elementit voi poistaa klikkaamalla elementin kohdalla olevaa punaista ruksia.

Valikkoelementtien ja linkkien asetuksia muokataan kynä-ikonia klikkaamalla. Valikkoelementin asetuksissa määritetään käännöskoodi ja valikon otsikko näkymän käyttämille kieliversioille:

Linkin asetuksissa määritetään käännöskoodi, nimi ja valinnainen kuvaus, linkin toiminto, avataanko toiminto uudelle välilehdelle ja missä kieliversioissa linkki näytetään.

Toiminto on jokin seuraavista:

• Sisältösivu: avaa valitun sisältösivun. Kansio-ikonia klikkaamalla näyteään lista, joka sisältää Finnan sisältösivut ja näkymän omat sisältösivut hakemistosta themes/custom/templates/content.
• URL: avaa www-osoitteen
• Toiminto: organisaationäkymän toiminto, esimerkiksi:
  • Näkymän etusivu: search-home
  • Tarkennettu haku: advanced-search
  • Selailunäkymä: browse-home
    jne

Linkille voi määritellä kielikohtaisen toiminnon valitsemalla pois "Käytä samaa toimintoa muilla kielillä" ja määrittämällä toiminnot kaikille kielille.

RSS-muotoisen sisällön tuominen näkymään

1. Valitse välilehti Muut asetukset
2. Valitse kohta RSS-syötteet ja paina Muokkaa
3. Paina Lisää rss-syöte

Näkymään voi tuoda RSS-muotoista sisältöä. Sisältö voidaan esittää kuvakarusellissa, uutislistauksessa, ruudukossa tai sisältösivulla. 

Kuvakaruselli

Kuvakaruselli on vaaka- tai pystymuotoinen lista, jossa näytetään joukko kuvia. Kuvan kohdalla voi näyttää otsikon ja sisältötekstiä. Kuvat otetaan syötteestä; jos syötteen elementissä on useampi kuin yksi kuva, käytetään aina elementin ensimmäistä kuvaa.

Ruudukko

Uutislistaus

Uutislistaus on linkkilista on syötteen elementtien otsikoista. Elementin kohdalla voidaan näyttää myös kuva ja sisältötekstiä.

Konfigurointi

RSS-syötekomponentit löytyvät Muut asetukset -välilehdeltä. 

Listassa oletuksena olevat komponentit näytetään suomenkielisellä etusivulla:

Komponentin näkyvyyttä säädellään valintaruudulla (ennen nimeä). Komponentin asetuksia pääsee muokkaamaan klikkaamalla kynä-ikonia:

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).

Esimerkki sisältösivulla avatusta syötteestä ja popup-ikkunassa avatausta syötteestä:

RSS-syötekomponentin käyttäminen ilman taustajärjestelmää

Mikäli valmista RSS-syötettä ei ole saatavissa, voi syötteen tallentaa näkymään paikalliseksi tiedostoksi. Esimerkissä syötteen käyttämä kuva noudetaan automaattisesti näkymän custom-teeman images-hakemistosta (themes/custom/images):

<rss version="2.0">
<channel>
	<title>Karusellin otsikko</title>
	<link>https://finna.fi</link>
	<language>fi-fi</language>
	<item>
		<title>E-kirjoja Ellibs-palvelussa</title>
		<link>https://www.ellibslibrary.com/vaski</link>
		<description>Ellibs-kokoelmasta suurin osa on...</description>
        <enclosure url="Ellibs_karuselli.png" length="" type="image/jpeg"/>
    </item>
</channel>
</rss>

RSS-syötteen voi tallentaa esimerkiksi tiedostoon themes/custom/templates/rss/karuselli.rss ja käyttää paikallista tiedostoa komponentin URL-kentässä. Älä käytä osoitteena finna-test.fi -osoitetta, vaan paikallisen tiedoston nimeä (esim. themes/custom/templates/rss/uusimmat.rss).

Jos syötteen sisältö näytetään organisaationäkymän sisältösivulla tai modaali-ikkunassa (ks. linkTo-parametri alla), tulee syötteen jokaiselle elementille määritellä "content:encoded" elementti, mihin sijoitetaan otsikkoa lukuun ottamatta elementin sisältö kokonaisuudessaan. content:encoded voi sisältää HTML-muotoiluja (otsikkoja, lihavointeja, linkkejä, kuvia jne):

<rss version="2.0">
<channel>
	<title>Karusellin otsikko</title>
	<link>https://finna.fi</link>
	<language>fi-fi</language>
	<item>
		<title>E-kirjoja Ellibs-palvelussa</title>
		<link>https://www.ellibslibrary.com/vaski</link>
		<description>Ellibs-kokoelmasta suurin osa on...</description>
        <enclosure url="Ellibs_karuselli.png" length="" type="image/jpeg"/>
		<content:encoded><![CDATA[<h3>Otsikko</h3><p>Kansalliskirjastossa on satoja 1400-1600-luvuilla painettuja kirjoja, joiden sidoksessa on käytetty keskiaikaisten käsikirjoitusten osia. Joukossa on huomattavan vanhoja fragmentteja, kuten saimme huomata lokakuussa 2015.</p>
		<img src="themes/custom/images/feed/feed.jpg" alt="Selkä_vain fragu" width="300" height="268" /> <p>Kansalliskirjastossa on satoja 1400-1600-luvuilla painettuja kirjoja, joiden sidoksessa on käytetty keskiaikaisten käsikirjoitusten osia. Joukossa on huomattavan vanhoja fragmentteja, kuten saimme huomata lokakuussa 2015.</p>]]></content:encoded>
    </item>
</channel>
</rss>

RSS-syötteen elementin HTML-sisällön suodatus

Organisaationäkymän sisältösivulla tai modaali-ikkunassa näytettävän artikkelin sisällöstä voidaan suodattaa pois ei-halutut osat käyttämällä säännöllisiä lausekkeita. Säännölliset lausekkeet lisätään taulukkoon htmlContentSearch ja korvaavat merkkijonot samassa järjestyksessä taulukkoon htmlContentReplace.

Esimerkki: poistetaan artikkelissa esiintyvä linkki, joka voidaan tunnistaa rel-attribuutin mukaan: 

htmlContentSearch[] = '<a rel="nofollow".*?<\/a>'
htmlContentReplace[] = ''

Karusellin kuvien koot ja täytepalkit

Seuraavat asiat on hyödyllistä ymmärtää, kun haluaa siisitiä karusellin ulkoasun: esimerkiksi eroon kuvaa ympäröivistä, värillisistä täytepalkeista.

Karusellissa kuvaa ympäröi laatikko, josta näkyy vasenta ja oikeaa reunaa, jos kuva on korkea ja kapea. Jos kuva on mittasuhteiltaan kapeampi kuin laatikko, karusellikomponentti (Slick) lisää laatikon oikealle ja vasemmalle puolelle täytepalkit. Jos kuva on mittasuhteiltaan leveämpi kuin laatikko, kuvaa leikataan oikealta ja vasemmalta.

Kuvaa ympäröivän laatikon leveys määrittyy karusellikomponentin koko karusellille sopivaksi katsomansa leveyden mukaan. Karusellin leveys ei siis määrity kuvien leveyden mukaan, vaan kuvien leveydet karusellilla käytössä olevan tilan leveyden mukaan.

RSS-välilehti -upoke

Joukon konfiguroituja RSS-syötteitä voi esittää samassa upokkeessa, jossa syötteet jaetaan välilehdille. Upokkeen voi sijoittaa haluamaansa sivupohjaan.

Esimerkki:

<?=$this->feedTabs(['title' => 'Otsikko', 'ids' => ['Tapahtumat' => 'news', 'Uutiset' => 'carousel', 'Muuta' => 'carousel-small']])?>

• 'title' -asetus määrittää RSS-välilehti -upokkeen otsikon (käännösavaimen).
• 'ids' -taulukossa määritellään näytettävät RSS-syötteet muodossa <käännösavain> => <rss-syötteen-nimi>.

xCal-tapahtumatiedot

Seuraavat xCal-formaatin kentät näytetään mikäli tieto on saatavilla RSS-syötteessä:

Tapahtumalista:

• Tapahtuman nimi (title)
• Tapahtuman kuva (featured)
• Tapahtumapaikan nimi (location)
• Tapahtuman alkupäivämäärä / tapahtuman alkamisaika (mikäli kellonaikaa ei ole määritelty, näytetään vain päivämäärä) (dtstart)
• Tapahtuman loppumispäivämäärä / tapahtuman loppumisaika (näytetään jos eri kuin alkamisaika) (dtend)

Tapahtumasivu / sisältösivu:

• Tapahtuman nimi (title)
• Tapahtuman kuva (featured)
• Tapahtuman alkupäivämäärä / tapahtuman alkamisaika (mikäli kellonaikaa ei ole määritelty, näytetään vain päivämäärä) (dtstart)
• Tapahtuman loppumispäivämäärä / tapahtuman loppumisaika (näytetään jos eri kuin alkamisaika) (dtend)
• Tapahtuman sisältö / kuvausteksti (content)
• Tapahtuman järjestäjän nimi (organizer)
• Tapahtumapaikan nimi (location)
• Tapahtumapaikan osoite (location-address)
• Tapahtumapaikan paikkakunta (location-city)
• Tapahtuman järjestäjän www-sivut (organizer-url)
• Tapahtuman www-sivut (url)
• Tapahtuman hinta (cost)
• Tapahtuman kategoria (categories)

Hakuvälilehdet

Näkymän eri hakuindeksestä (paikallinen indeksi, Primo) tulevat hakutulokset erotellaan omille välilehdilleen. Näkymään voi lisäksi halutessaan luoda uusia välilehtiä. Välilehdet käyttävät hakuindeksin yleisiä asetuksia (aineistot, fasetit) ja mahdollistavat lisärajakset, joita käyttäjä ei voi kytkeä pois.

Välilehtien avulla voi esimerkiksi:

• Erotella kirjaston omat ja Varastokirjaston (tai jonkun muun, esimerkiksi Arton) aineistot omalle välilehdilleen (esimerkki).
• Erotella e-kirjat (tai jonkun muun aineistotyypin, esimerkiksi kuvat) omalle välilehdelleen.
• Asettaa Primon välilehdelle oletusrajauksen (esimerkiksi Vertaisarvoidut kokotekstit).

Uusia välilehtiä luodaan "Muut asetukset" -välilehdellä:

Aktiiviset välilehdet esitetään organisaationäkymän käyttöliittymässä listan järjestyksessä:

Järjestystä voi muuttaa raahamalla välilehden haluttuun kohtaan listalla.

Muokkaamalla välilehden asetuksia () voi asettaa välilehden kielikäännökset ja mahdolliset rajaukset. 

Rajaus asetetaan valitsemalla valikosta haluttu määritys (esimerkiksi instituutio, aineistotyyppi, kieli) ja syöttämällä tälle sopiva arvo. Kentissä on käytössä esitäyttö, joka etsii hakuindeksistä vaihtoehtoja syötetylle arvolle. Yleisimmät vaihtoehdot saat näkyville jättämällä kentän tyhjäksi ja klikkaamalla sitä hiirellä. Huomioi, että pienet ja isot kirjaimet tuottavat eri hakutuloksia. Yleisimpien kenttien lisäksi on mahdollista käyttää vapaasti määriteltävää indeksoitua kenttää valitsemalla "Muu kenttä..." ja syöttämällä kentän nimi. Lähes kaikki henkilökuntanäytöllä näkyvät kentät ovat indeksoituja ja myös käytettävissä rajauksissa. Esimerkiksi luokituksen mukaan rajaaminen onnistuu syöttämällä kentän nimeksi "classification_str_mv".

Rajaukset voi määritellä AND, OR tai NOT-tyyppisiksi.

Esimerkki: lisätään oma välilehti Varastokirjastoa varten:

Varmistetaan, että Varastokirjaston aineisto on käytössä (Paikalliset aineistot -välilehti, kohta Tietokannat). Klikataan "Lisää uusi Solr-välilehti" ja syötetään välilehden asetukset. Rajataan organisaatioksi Varastokirjasto (0/NRL).

Uusi välilehti käyttöliittymässä:

Mikäli Varastokirjaston aineistot halutaan lisäksi rajata pois Kirjaston kokoelmat -välilehdeltä, lisätään tälle NOT-rajaus:

Huom: jos deduplikointi on päällä, Varastokirjaston NOT-rajaus voi tiputtaa myös kirjaston kokoelmaan kuuluvia tietueita pois hakutuloksesta. Tässä tapauksessa Solr-välilehdellä kannattaa käyttää positiivisia OR-rajauksia ja listata erikseen organisaatiot, joiden aineistoja näytetään:

Esimerkki: rajataan Primo-välilehdelle näkyviin vertaisarvioidut kokotekstit lisäämällä rajaukset tlevel = online_resources ja tlevel = peer_reviewed:

Tunnistautuminen

Finna tukee erilaisia tunnistautumistapoja. On kaksi yleisempää tunnistautumistapaa, Finna-tunnus ja Shibboleth, jotka ovat kohdassa "Tunnistautuminen".

Kirjastokorttitunnistautuminen asetetaan kohdassa "Tunnistautuminen kirjastokortilla". Kohdassa on palstoille jaettu lista eri kirjastoista, joista aktivoidaan halutut. Tämän jälkeen valitaan Oletus-valikosta näkymässä käytetty oletuskirjastokortti aktivoitujen korttien joukosta. Lisäksi kirjastokortilla kirjautuneille voidaan sallia pääsy lisensioituihin aineistoihin (oletuksena pääsy on evätty). 

Jonkin tunnistautumistavan ollessa valittuna, ilmestyy näkymän oikeaan yläreunaan linkki...

...josta avautuvalla sivulla listataan valitut tunnistautumistavat

Organisaatiosivu ja aukioloajat-upoke

Organisaationäkymään voi tuoda kirjastojen ja arkistojen organisaatiokohtaisia ja palvelupisteiden tietoja Kirjastohakemiston Kirkanta-palvelusta. Tarkemmat ohjeet löytyvät täältä. Toiminton asetukset muokataan Organisaatiotiedot-osiossa.  

Kirjastokartta

Tietueen saatavuustiedoissa sijainnin ohessa voidaan näyttää linkki Kirjastokarttaan. Karttojen asetukset määritellään erikseen jokaiselle tietokannalle tiedostossa /local/config/finna/LocationService.ini. Ominaisuus kytketään päälle näkymään lisäämällä tiedostoon /local/config/vufind/LocationService.ini:

[General]
enabled = true

Lisäksi asetustiedoston General-osiossa voi määrittää seuraavat asetukset:

modal

qr_code_record

qr_code_results

Eräpäivämuistutus-valinnan kätkeminen

Tämä asetusmuutos tehdään meillä pyynnöstä.

Valinnan kätkeminen ei kuitenkaan peru jo tilattuja eräpäivämuistutuksia. Valinnan kätkemisen jälkeen käyttäjä voi edelleen peruuttaa tilauksen sähköpostiviestissä olevan linkin avulla.

Oman tilin välilehtien ja oletusvälilehden valinta

Joskus voi olla tarkoituksenmukaista vaikuttaa siihen, mitkä välilehdet käyttäjän Oma tili -sivulla on näkyvillä tai mikä on käyttäjän oletusvälilehti eli se sivu, johon käyttäjä päätyy kirjauduttuaan palveluun Näitä kaikkia voidaan muuttaa Oma tili -osiossa.