Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Table of Contents

Logo, taustakuva, taustaväri ja favicon-ikoni

Logot ja värit

Siirry

...

"Ulkoasu" -

...

välilehdelle. Logon voit vaihtaa valitsemalla: Oletuslogo → Vaihda... 

Favicon-ikonin voit vaihtaa valitsemalla: Favicon ikoni → Lisää uusi kuva... Favicon-ikoni näytetään selaimesta riippuen esimerkiksi osoitepalkissa tai kirjanmerkkien yhteydessä. 

Kuvien tallennuksessa kannattaa huomioida seuraavat seikat:

  • Logot ja taustakuva kannattaa muuntaa sopivan kokoisiksi ennen lähettämistä. Hallintalittymä ei muuta niiden kokoja. 
    •  Logossa kannattaa käyttää png-tiedostomuotoa (suositus: enimmäisleveys 200px ja  korkeus: 40px). Logossa on mahdollista käyttää myös tarkempaa pikselitiheyttä, jolloin logon koko voi olla esimerkiksi 400px*80px. Logo skaalautuu yläpalkin korkeuden mukaan automaattisesti.  Logo kannattaa testata useammalla päätelaitteella ennen näkymän julkaisua (tietokoneen näyttö, mobiili jne.).
    • Hallintaliittymä tallentaa logot png-muotoisina. 
  • Tallenna taustakuva joko jpg tai png -muotoon. Mikäli kuva on valokuvamainen, jpg-muoto pakkaantuu yleensä pienemmäksi. Hallintaliittymä ei muuta taustakuvan formaattia.

...

  • Huom! Taustakuva ei kuvan aiheen ja mittasuhteiden vaihdellessa aina rajaudu toivotulla tavalla pienemmillä näytöillä kuten mobiililaitteilla. Kuvan skaalausta tai asemointia voi tällöin muuttaa lisäämällä sille omia ulkoasumäärittelyitä.
  • Faviconiksi kannattaa valita ikoni, joka toimii

...

  • 16 x

...

  • 16 pikselin kokoisena. Hallintaliittymä pienentää lähetetyn faviconin tarvittaessa.

...

Kieliasetukset

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

Image Removed

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 (Image Removed):

Image Removed

Käännös voi sisältää myös HTML-koodia. Koodissa tulee käyttää yksinkertaisia lainausmerkkejä (heittomerkkejä) tavallisten lainausmerkkien sijaan. Esimerkiksi linkin HTML-koodi merkitään: <a href='http://www.finna.fi'>Linkki</a>.

Muokatun käännöksen voi myös palauttaa alkuperäiseen tilaansa syöttämällä kenttään "###". 

Listalle voi myös lisätä uuden käännöksen valitsemalla Lisää uusi käännös.

Muokatut käännökset tallennetaan näkymän muiden asetusten tapaan valitsemalla Tallenna muutokset. 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.

Image Added



logokuvan voi muokata Finnan graafisen ohjeistuksen mukaisten mallien avulla

Hakupalkin muokkaus

Siirry välilehden "Ulkoasu" alavälilehdelle "Etusivu". Voit vaihtaa hakupalkin taustakuvaa valitsemalla Hakupalkki → Lisää uusi kuva...


Image Added


Hakupalkkiin saat lisättyä logon seuraavasti:

  • Valitse osio "Etusivu"
  • Valitse "Hakupalkki"
  • Valitse kohdasta "Otsikkoalue" haluamasi kielen kohdalta "Lisää logo..."

Logo näkyy hakupalkin yläosassa.

Image Added

Etusivun tekstit

Etusivun tekstit löytyvät kielikäännösten listauksesta koodeilla site_header_slogan ja  site_header_slogan_small  (logon alapuolella).

Image Removed

Oletuskielen valinta

...

Jos haluat jättää tekstin pois, syötä käännökseksi "###".

Etusivun tekstejä voit myös muokata valitsemalla välilehden "Ulkoasu" kohdasta "Etusivu → Hakupalkki → Otsikkoalue"

Image Added

Etusivun tekstin sijoittaminen laatikon sisään (ohje)

Selaa-palkin lisääminen etusivulle

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

Image Removed

Näkymähierarkia on rajattu: näkymällä voi olla yksi ylänäkymä, tai yksi tai useampia alinäkymiä.

Hakutulossivu

Hakutulosten esittäminen

Hakutulokset voidaan esittää listan (Tiedot ja kuvat) lisäksi kuvagalleriana tai tiivistettynä listana. Kuvagalleriassa painotetaan tietueiden esikatselukuvia ja se soveltuu hyvin käytettäväksi mikäli näkymän aineistoissa on paljon esimerkiksi valokuvia tai kirjojen kansikuvia. Tiivistetyssä listassa ruudulle mahtuu kerrallaan näkyviin tavallista listaa enemmän hakutuloksia. 

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.


Lista

Tiedot ja kuvat:

Image Removed

Image Added

Kuvagalleria:


Image Removed

 Image Added

Tiivistetty lista:

Image Removed

Image Added

 

Fasettilistauksen sijainti

Hakutuloksen rajaamiseen käytettävät fasetit (Sijainti, aineistotyyppi, jne) näytetään oletuksena tulosten oikealla vasemmalla puolelle. Fasetit voidaan myös näyttää hakutuloslistan vasemmalla oikealla puolella: 

...

Siirry "Ulkoasu" -

...

välilehdelle ja valitse haluamasi puoli "

...

Hakutulokset → Fasettilistaus"-kohdassa

...

.

Image Modified

Hakutulosten ja tietuenäytön kentät

Tietueen yhteydessä näytettäviä kenttiä voi kätkeä seuraavasti:

...

Poista "Ulkoasu" -välilehden kohdasta "

...

Hakutulokset → Hakutulosten kentät" (hakutulos) tai "

...

Tietuenäyttö → Kentät" (tietue) ne kentät, jotka haluat pois näkyvistä.

...

Image Removed

Kuvakarusellin tai uutissyötteen lisääminen

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

Kuvakaruselli

Image Removed

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.

Uutislistaus

Image Removed

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

Konfigurointi

Image Added


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/

...

Tiedostossa on osio jokaista RSS-syötekomponenttia (karuselli tai uutislistaus) varten. Etusivulla näytetään oletuksena kuvakaruselli (osio carousel), pystymuotoinen kuvakaruselli (osio carousel-vertical) ja uutissyöte (osio news), mikäli nämä on aktivoitu asetustiedostossa.

Esimerkki etusivun kuvakarusellin asetuksista:

Code Block
[carousel]
type = "carousel"
active = 1
url[*] = "http://www.hel.fi/hel2/kaumuseo/finna/hkm_nostot.xml"
title = 'rss'
height = 350
itemsPerPage[desktop] = 4
itemsPerPage[desktop-small] = 3 
itemsPerPage[tablet] = 2 
itemsPerPage[mobile] = 1

Asetuksista tärkeimmät ovat active (onko karusellis päällä vai ei) ja url (RSS-syötteen osoite).

Info

Osioita voi myös lisätä ja ne voi nimetä haluamallaan tavalla. Oletuksena kuitenkin vain etusivun carousel-, carousel-vertical ja news-osiot tulevat käyttöön ilman lisätyötä. Uusi osio otetaan käyttöön lisäämällä sivupohjaan <?= $this->feed("<osio>"); ?> (ks. esimerkki tiedostosta /themes/finna/templates/search/home/home-2.phtml).

Karusellin 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 näkymän custom-teeman images-hakemistosta:

Code Block
languagenone
<rss version="2.0">
<channel>
	<title>Karusellin otsikko</title>
	<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='/themes/custom/images/Ellibs_karuselli.png' length="" type="image/jpeg"/>
    </item>
</channel>
</rss>

RSS-syötteen voi tallentaa esimerkiksi tiedostoon /themes/custom/templates/files/karuselli.rss ja merkitä /local/config/vufind/rss.ini tiedostoon:

Code Block
languagenone
url[*] = "themes/custom/templates/files/karuelli.xml"

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-syötteen elementin HTML-sisällön esittäminen omalla sisältösivullaan tai modaalissa

Jos RSS-syötteessä on mukana elementin koko HTML-sisältö (content:encoded elementti), tämä voidaan avata kuvakarusellista tai uutislistauksesta omalle sisältösivulleen tai modaali-ikkunaan:

Image Removed

...

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ää


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

Image AddedEsimerkki:

Ohjeet laitetaan päälle päivittämällä ohjeen sisältö muiden käännösten tapaan:

Ohjeen käännösSijainti käyttöliittymässä
tooltip_facet_html
Fasetit hakutuloksissa 
tooltip_local_search_html
Paikallinen haku, hakukentän yhteydessä
tooltip_pci_search_html
PCI-haku, hakukentän yhteydessä
tooltip_eds_search_html
EDS-haku, hakukentän yhteydessä
tooltip_summon_search_html
Summon-haku, hakukentän yhteydessä
tooltip_local_advanced_html
Paikallinen tarkennettu haku, otsikkopalkki
tooltip_pci_advanced_html
Tarkennettu PCI-haku, otsikkopalkki
tooltip_myaccount_html
Oma tili, otsikkopalkki
tooltip_tabs_local_html
Paikallisen indeksin välilehti
tooltip_tabs_pci_html
PCI välilehti
tooltip_tabs_combined_html
Jaetun hakutuloksen välilehti

Mikäli ohjeen käännös on tyhjä, ohjeikonia ei näytetä.

Ohjetekstit

Näkymiin on mahdollista lisätä ohjeita, jotka näkyvät tekstinä käyttöliittymässä. Ohjeiden sijainti käyttöliittymässä on ennalta määritelty.

Ohjeen käännösSijainti käyttöliittymässä
profile_instructions
Oma tili, Omat tiedot -välilehti
contact_details_instructions
Omat tiedot -välilehti, Kirjaston ylläpitämät henkilötiedot -osio
finna_new_password_instructions_html
Salasanan vaihto -ikkuna
checked_out_instructions_html
Oma tili, Lainat -välilehti
holds_instructions_html
Oma tili, Varaukset -välilehti
storage_requests_instructions_html
Oma tili, Varastotilaukset -välilehti
ill_requests_instructions_html
Oma tili, Kaukolainat -välilehti
fines_instructions_html
Oma tili, Maksut -välilehti
library_cards_instructions_html 
Omatili, Kirjastokortit -välilehti
change_password_instructions
Kirjastokortin salasanan vaihto
login_desc_add_library_card_html
Uuden kirjastokortin lisäys
recovery_help_html
Salasana unohtunut -ikkuna
feedback_instructions_html
Palautesivun alussa

Julkisen suosikkilistan näyttäminen sisältösivulla

Julkinen suosikkilista voidaan näyttää sisältösivulla upokkeessa seuraavasti:

Code Block
<?= $this->userlistEmbed(['id' => 395876, 'view' => 'list'])?>

Upoke tukee seuraavia asetuksia:

AsetusSeliteMahdolliset arvot
idListan tunniste.Tunniste löytyy urlista: <näkymä>.finna.fi/List/<tunniste>
view

Esitystapa, kuten hakutuloksissa.



  • list: lista
  • grid: kuvagalleria
  • condensed: tiivistetty lista
titleNäytetäänkö listan otsikko?
  • true
  • false
description

Näytetäänkö listan kuvausteksti?

  • true
  • false
dateNäytetäänkö listan päivämäärä?
  • true
  • false
sortListan suosikkien järjestys
  • id+desc
  • id
  • title
  • author
  • year+desc
  • year
  • format
limitNäytettävien suosikkien lukumäärä1-100
pageSivunumero (jos listan suosikkien lukumäärä on suurempi kuin 'limit')1-
headingLevelOtsikkotasoh1, h2, h3 ...
allowCopyVoiko listan tietueet kopioida upokkeesta omaan listaansa?
  • true
  • false
showAllLink

Näytetäänkö "Näytä kaikki" -nappi jos listalla on enemmän suosikkeja kuin 'limit'-asetuksen määrittämä maksimi?

  • true
  • false


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

Image Added

...

Ominaisuus kytketään päälle lisäämällä RSS-syötekomponentin osioon linkTo -parametri arvolla "content-page" (sisältösivu) tai "modal" (modaali).

Esimerkki: näytetään artikkeli sisältösivulla:

Code Block
[carousel]
type = "carousel"
active = 1
url[*] = "https://musasto.wordpress.com/feed/"
title = 'rss'
height = 350

linkTo = "content-page"
 
itemsPerPage[desktop] = 4
itemsPerPage[desktop-small] = 3 
itemsPerPage[tablet] = 2 
itemsPerPage[mobile] = 1

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[] = ''