Page History
...
Logo näkyy hakupalkin yläosassa.
Kieliasetukset
Kieliversioiden ja oletuskielen valinta
Näkymässä käytettävät kieliversiot määritellään Näkymän tiedot -välilehden kohdassa Käyttöliittymän kieli:
Oletuskieli määrittää minkä kielisenä näkymän käyttöliittymän tekstit näytetään. Käyttäjä voi halutessaan vaihtaa kieltä yläreunan navigointipalkin linkeistä. Voit muokata tekstien käännöksiä tiedostonhallinnan kautta.
Kielikäännökset
Näkymän käyttöliittymän tekstisisältö on tallennettu erillisiin kielikäännöstiedostoihin, joita muokataan "Kielikäännökset" -välilehdelllä:
Ensimmäisessa palstassa on tekstin koodi ja seuraavissa käännökset näkymän eri kielillä. Muokatut tai uudet tekstit näytetään vihreällä. Käännöksiä muokataan valitsemalla koodin vieressä oleva muokkauspainike ():
Kielikäännökset, joiden koodi päättyy '_html' voivat sisältää HTML-koodia. Koodissa tulee käyttää yksinkertaisia lainausmerkkejä (heittomerkkejä) tavallisten lainausmerkkien sijaan. Esimerkiksi linkin HTML-koodi merkitään:
Code Block |
---|
<a href='http://www.finna.fi'>Linkki</a> |
Toiset käännökset sisältävät muuttujia, jotka korvataan sopivalla sisällöllä ennen tekstin näyttämistä. Esimerkiksi seuraavassa käännöksessä "%%date%%" korvataan lähimmällä eräpäivällä:
Code Block | ||
---|---|---|
| ||
closest_due_date = "Lähin eräpäivä %%date%%" |
Muuttujat on sijoitettu "%%" merkkien sisään ja nämä tulee jättää paikoilleen käännöstä muokattaessa.
Muokatun käännöksen voi myös palauttaa alkuperäiseen tilaansa klikkaamalla "palauta alkuperäinen käännös".
Käännöksen voi jättää tyhjäksi syöttämällä kenttään "###".
Listalle voi myös lisätä uuden käännöksen valitsemalla Lisää uusi käännös. Yksi tapa helpottaa lisättyjen käännösten nopeaa löytämistä ja hahmottamista listalta on käyttää näiden koodissa yhteistä etuliitettä esim. "custom_" tai jotain toista omiin käytäntöihin soveltuvaa yhdistävää nimitystä.
Muokatut käännökset tallennetaan näkymän muiden asetusten tapaan klikkaamalla Tallenna. Tallennuksen jälkeen uudet käännökset ovat käytettävissä myös sivupohjissa ({translate text="<koodi>"}
).
Info |
---|
Selaimen Etsi-toiminto helpottaa muokattavan koodin löytämistä käännöslistauksesta. |
Etusivun tekstit
Etusivun tekstit löytyvät kielikäännösten listauksesta koodeilla site_header_slogan ja site_header_slogan_small (logon alapuolella). Jos haluat jättää tekstin pois, syötä käännökseksi "###".
Etusivun tekstejä voit myös muokata valitsemalla välilehden "Ulkoasu" kohdasta "Etusivu → OtsikkoalueHakupalkki → Otsikkoalue"
Etusivun tekstin sijoittaminen laatikon sisään (ohje)
Kielikäännösten päivittäminen usean näkymän välillä
Mikäli on tarpeen käyttää samoja muokattuja kielikäännöksiä useassa näkymässä saman organisaation sisällä (esimerkiksi yhteiskirjastojen useat näkymät), tämä onnistuu asettamalla näkymälle ns. ylänäkymä, jonka käännökset kopioidaan alinäkymiin seuraavasti:
- Ylänäkymän paikalliset käännökset kopioidaan alinäkymiin näkymän tallennuksen yhteydessä tai kun näkymän ylänäkymää vaihdetaan.
- Ylänäkymästä kopioitava käännös ei ylikirjoita alinäkymän paikallista käännöstä.
- Ylänäkymästä kopioituja käännöksiä ei voi poistaa alinäkymästä, mutta niitä voi muokata paikallisesti.
- Jos käännös poistetaan ylänäkymästä, käännös jää alinäkymään ja käyttäytyy kuten paikallinen käännös. Käännöksen voi tämän jälkeen poistaa alinäkymästä normaaliin tapaan.
- Alinäkymään voi luoda uusia paikallisia käännöksiä, eivätkä nämä vaikuta ylänäkymään.
Oletuksena näkymällä ei ole ylänäkymää. Ylänäkymä asetetaan Näkymän tiedot -välilehdellä:
Näkymähierarkia on rajattu: näkymällä voi olla yksi ylänäkymä, tai yksi tai useampia alinäkymiä.
Selaa-palkin lisääminen etusivulle
...
Näkymän käytössä olevat hakutulosnäkymät valitaan "Ulkoasu" -välilehden kohdassa "Hakutulokset". Mikäli käyttäjä ei ole vaihtanut tulosten esitystapaa, käytetään oletusta.
Tiedot ja kuvat:
Kuvagalleria:
Tiivistetty lista:
...
Siirry "Ulkoasu" -välilehdelle ja valitse haluamasi puoli "Hakutulokset → Fasettilistaus"-kohdassa.
...
Kuvamodaalin asetukset
Kuvien zoom toiminnon salliminen tai estäminen
Kuvamodaaleihin on mahdollista asettaa zoom toiminto, jolloin lido, ead, forward ja qdc kuvat aukeavat modaalissa zoomattavaan versioon.
Tämän asetuksen saa päälle asettamalla local/config/vufind/config.ini tiedostoon seuraavanlainen arvo:
[Content]
; Enables zoom for images in the image popup, only applies to records using the large image
; layout. Disabled by default.
enableImagePopupZoom = true / false riippuen halutaanko sallia vai estää
RSS-muotoisen sisällön tuominen näkymään
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:
...
...
- Korkeus määrittää komponentin korkeuden pikeleissä.
- Ruudulla kerrallaan näkyvien kuvien lukumäärät määritellään erikseen eri päätelaitteille. Voit testata asetuksia muuttamalla selainikkunan leveyttä.
- Linkkiteksti määrittää käännösavaimen, jonka teksti näytetään kun käyttäjä vie hiiren kursorin kuvan päälle tai klikkaa kuvaa kerran (kosketusnäytöllä). Linkkitekstin sijainti määritetään kohdassa Tietueen otsikko.
- Automaattinen sivunvaihto määrittää viiveen, minkä jälkeen karuselli vaihtaa sivua. Viive syötetään millisekunneissa (esimerkiksi syöttämällä viiveeksi 5000, sivu vaihtuu viiden sekunnin kuluttua).
...
- Näytä lisää linkki -valinta määrittää näytetäänkö listan jälkeen linkki syötteen alkuperäiselle sivulle.
...
- RSS-linkkien määrä upokkeessa määrittää, kuinka monta linkkiä näytetään ennen "lisää" -nappia. "Lisää" -napista painamalla ruudukossa näkyy linkkien max. määrä
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).
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):
Code Block | ||
---|---|---|
| ||
<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):
Code Block | ||
---|---|---|
| ||
<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:
Code Block |
---|
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.
Note |
---|
Koska Finna käyttää salattua https-yhteyttä, tulee myös karusellissa näytettävät kuvat noutaa käyttäen https-yhteyttä. Muussa tapauksessa www-selain saattaa varoittaa käyttäjää suojaamattomasta yhteydestä. |
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:
Code Block |
---|
<?=$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)
Ylävalikko
Ylävalikon rakenne määritellään Muut asetukset -välilehden kohdassa Navigointivalikko.
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. Ylävalikkoon voi lisätä uuden valikkoelementin klikkaamalla listan lopussa olevaa "Lisää valikkoelementti" nappia. 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.
Note |
---|
Ylävalikon asetukset eivät koske palaute-toimintoa, kielivalintoja eivätkä kirjautumislinkkiä. Palautelomakelinkki on mahdollista poistaa osiossa config.ini:n [Feedback] asetuksella tab_enabled = false. Kielivalinnat näytetään näkymään valittujen kieliversioiden mukaan. |
Kontekstuaaliset ohjeet
Näkymässä on mahdollista näyttää ohjeikoneita, joita klikkaamalla avataan aiheeseen liittyä ohje puhekuplaan. Ohjeikoneiden paikat on ennalta määritelty näkymän sivupohjissa, mutta ohjeiden sisältö on vapaasti määriteltävissä.
...
Code Block |
---|
<?= $this->userlistEmbed(['id' => 395876, 'view' => 'list'])?> |
Upoke tukee seuraavia asetuksia:
Asetus | Selite | Mahdolliset arvot |
---|---|---|
id | Listan tunniste. | Tunniste löytyy urlista: <näkymä>.finna.fi/List/<tunniste> |
view | Esitystapa, kuten hakutuloksissa. |
|
title | Näytetäänkö listan otsikko? |
|
description | Näytetäänkö listan kuvausteksti? |
|
date | Näytetäänkö listan päivämäärä? |
|
sort | Listan suosikkien järjestys |
|
limit | Näytettävien suosikkien lukumäärä | 1-100 |
page | Sivunumero (jos listan suosikkien lukumäärä on suurempi kuin 'limit') | 1- |
headingLevel | Otsikkotaso | h1, h2, h3 ... |
allowCopy | Voiko listan tietueet kopioida upokkeesta omaan listaansa? |
|
showAllLink | Näytetäänkö "Näytä kaikki" -nappi jos listalla on enemmän suosikkeja kuin 'limit'-asetuksen määrittämä maksimi? |
|
Note |
---|
Upotettu lista toimii vain kun suosikkilista ja näkymä sijaitsevat samalla palvelimella. Tämän vuoksi tuotantonäkymän kautta tehdyn suosikkilistan upotusta ei voi kokeilla finna-testillä, vaan näkymä täytyy julkaista. |
Videon upottaminen tietuesivulle
Videon voi upottaa tietuesivulle asettamalla tiedostoon local/config/vufind/config.ini seuraava asetus:
[Record]
embedVideo = true