DanBib og netpunkt.dk information

         

Sidst opdateret 09.03.2010

Eksempelklient til bibliotek.dk webservice

Vi har udviklet en eksempelklient i PHP som alle der har lyst kan genbruge og tilrette.
Klienten består af en grænseflade til afvikling i en browser med søgeformular og visning af søgeresultatet i html.
Klienten gør det meget nemt at implementere søgning i og visning af søgeresultater fra bibliotek.dk på din egen hjemmeside.

Hvordan får jeg bibliotek.dk ind på min hjemmeside?

Du kan enten bruge den klient som vi har lagt her: http://webservice.bibliotek.dk/klient.php
eller du kan bruge din egen version af klienten (se nedenfor hvor du kan downloade den).

Lav en lokal kopi på din webserver

Eksempelklienten er lavet i programmeringssproget PHP. For at kunne køre den lokalt skal du have:

• PHP 5 installeret på din webserver (PHP er gratis)
• disse to scripts på din webserver (link til download nederst på denne side):
• klient.php
• CURL (en del af PHP) installeret på din webserver

Layout styres ved hjælp af CSS.

html iframe

Du kan sætte bibliotek.dk ind på din hjemmeside fx ved at bruge html iframe. Det kan fx se således ud (prøv at lave en søgning):



Der hvor du ønsker at sætte en bibliotek.dk søgeformular ind på din hjemmeside, skal du indsætte følgende i html'en:

<iframe src="http://webservice.bibliotek.dk/klient.php" width="100%">
</iframe>

I src-attributten indsættes url'en til den bibliotek.dk klient du vil have på din hjemmeside. Du kan styre størrelsen af iframen ved hjælp af attributterne width og height.

For en vejledning i brug af iframe se fx: W3schools Online Web Tutorial

Hvordan retter jeg eksempelklienten til?

Det er en fordel at du kende lidt til HTML og CSS hvis du ønsker at lave et andet layout til din klient.

Du kan både rette søgeformularen og visningen til. Se vejledningen der er med når du downloader klienten, for en detaljeret gennemgang af hvordan du laver rettelser i din lokale klient.

Søgeformular

Valg af søgefelter
Du kan selv vælge hvilke felter brugerne af din klient skal kunne søge i. Det er muligt at søge i følgende felter:

• forfatter
• titel
• emne
• fritekst
• id (fx issn, isbn)
• år
• sprog
• materialetype
• person
• ejer (bibliotek)
• noter
• postid

Tekster
Du kan ændre den tekst der er på søgeformularen. Du kan både lave andre tekster foran søgefelterne i formularen og på knappen til søgning, og du kan ændre typografien. På den måde vil det fx være hurtigt at lave en version af klienten på et andet sprog.

Visning af søgeresultat

Tekster
Du kan også ændre tekst og typografi på visningssiden. Du kan vælge om du vil have tekst (labels) foran de enkelte felter i posterne, og hvordan de skal se ud (skrifttype, farve, størrelse osv.). På samme måde kan du tilrette hvordan de bibliografiske data præsenteres.

Antal poster
Du kan selv bestemme hvor mange poster der skal være på hver side i visningen af søgeresultatet. Pt. kan der dog max vises 10 pr. side.

Hvilke bibliografiske data
Du bestemmer selv hvilke bibliografiske data der skal vises for hver post. Se vejledningen for hvilke muligheder der er.

Link
Hver post i søgeresultatet fra eksempelklienten indeholder et link til bibliotek.dk. Du kan selv bestemme om linket skal være i din klient, og hvad teksten på linket skal være. Du kan selvfølgelig også vælge at lave noget helt andet.

Baggrund

Du kan nemt ændre farve eller baggrundsbillede i klienten. Se i vejledningen til klienten hvordan du gør dette.

Logo

Vi har indsat et bibliotek.dk-logo i klienten. Du kan skifte dette ud med dit eget logo, eller du kan fjerne det. Med en smule html-kendskab kan du også skifte logoet ud med en tekst-overskrift hvis du ønsker det. Se i vejledningen til eksempelklienten hvordan du ændrer logoet.

Download klienten

Du kan downloade klienten inkl. vejledning her: Eksempelklient til download (gem den som php-fil)