Vejledning til installation i DDB-CMS

For at anbefalingerne kører på DDB-CMS, skal der gøres tre ting.

  1. Tilføje anbefalingskomponenten til DDB-CMS (herefter vil anbefalingerne vises)
  2. Uploade bestand (forudsætning for at anbefalingerne kan begrænses til bibliotekets bestand)
  3. Konfigurere anbefalingerne (vælge afgrænsning til bibliotekets bestand, og eventuelt andre indstillinger)

Tilføj anbefalingskomponenten til DDB-CMS

Anbefalingerne kan tilføjes med det DDB-CMS-modul der ligger på https://github.com/arni/ting_recommender – se vejledningen dér. Tak til Randers Bibliotek for at udvikle dette!

Alternativt kan det også tilføjes ved at inkludere:
<script async src="https://cdn.bibspire.dk/ddbcms.js"></script>
i head via “Add To Head”-drupal modulet.

Når anbefalingskomponenten er tilføjet, vil anbefalingerne kunne vises på sitet, – men der mangler stadigt konfiguration af beholdning etc.

Upload beholdningsdata

For at kunne afgrænse anbefalingerne til bibliotekst bestand, skal bibliotekets bestanddata uploades. Bestanden kan hentes fra https://reports.cicero-fbs.com/reports/report/Reports/Folkebiblioteker/bestand.  Her skal man bruge sit biblioteks login, og vælge aller materialer og alle filialer. Resultatet skulle gerne have et indhold der minder om dette:

773000,03238857,,1
773000,03238881,,1
773000,03239365,,3
773000,03239381,,59
773000,03240266,,2
773000,03240398,,5
773000,03240622,,31
773000,03240630,,1
773000,03241971,,1
773000,03242544,,1
773000,03242609,,3
...

Filen med beholdning uploades derefter til https://bibdata.dk/v1/bib/holdings med en PUT-request. Dette kan eksempelvis gøres med curl således:

curl -X PUT "https://bibdata.dk/v1/bib/holdings?agency=746000&token=XXXXX" --upload-file bestand.csv

Bemærk at der skal agency-nummer og token(fås herfra, send en mail) for at uploade. Hvis dette er for teknisk, giv lyd og så finder vi en måde at overføre den på.

Odense Bibliotek har lavet nogle scripts der automatiserer dette.

Konfigurér anbefalingerne

Når bestanden er uploadet, kan man logge ind på https://admin.bibspire.dk og vælge at afgrænse anbefalingerne på et site, til et givent biblioteks bestand. Det er også muligt at tilpasse anbefalingerne etc. Adgang til at ændre konfigurationen, kræver igen et token, hvilket I kan få herfra for jeres site.