Obálky knih - implementace do starších verzí Evergreenu

Poznámka: od verze 2. 12 jsou Obalkyknih.cz implementovány přímo do oficiální distribuce Evergreenu.

Registrace na serveru Obalkyknih.cz

Pro využívání služby si knihovna musí vytvořit účet na serveru Obalkynih.cz (http://obalkyknih.cz/signup).

V adminstraci je poté nutné nastavit IP adresu a URL adresu evergreenového serveru (pokud má každá zapojená evergreenová knihovna vlastní adresu pro OPAC, je nutné zadat URL adresu každé knihovny).

Implementace přidaného obsahu do Evergreenu

Podpora pro zobrazování přidaného obsahu ze serveru Obalkyknih.cz bude zahrnuta připravovaných nových verzí Evergreenu (v roce 2017). Prozatím je využívání možné úpravou zdrojového kódu Evergreenu:

Perl modul ObalkyKnih.pm

Do adresáře /usr/local/share/perl/5.20.2/OpenILS/WWW/AddedContent vytvořte soubor ObalkyKnih.pm

Úprava šablon online katalogu

Při změnách souborů OPACu doporučujeme zvážit vytvoření zvláštního adresáře pro upravené šablony, viz OPAC - Nastavení šablon podle požadavků knihovny

config.tt2

Do souboru /openils/var/templates/opac/parts/config.tt2 doplňte následující kód:

##############################################################################
# Obalkyknih.cz support
##############################################################################
# Obalkyknihy.cz is free Czech service providing added content and book covers
# Set to 'true' to enable
##############################################################################
obalkyknih_cz.enabled = 'true';

summary.tt2

V souboru /openils/var/templates/opac/parts/record/summary.tt2 upravte kód (ve verzi 2.10.5 se tato část kódu nachází na řádku 28-33):

Smažte:

<div id="rdetail_image_div">
<a href='[% ctx.media_prefix %]/opac/extras/ac/jacket/large/r/[% ctx.bre_id | uri %]'><img
alt="[% l('Image of item') %]" id='rdetail_image'
src='[% ctx.media_prefix %]/opac/extras/ac/jacket/[% record.summary.jacket_size %]/r/[% ctx.bre_id | uri %]' /></a>
<br />
</div>

Místo smazané části doplňte:

<div id="rdetail_image_div">
[%- INCLUDE "opac/parts/record/jackets.tt2" %]
</div>

jackets.tt2

Vytvořte soubor /openils/var/templates/opac/parts/record/jackets.tt2 s tímto obsahem:

[%- IF obalkyknih_cz.enabled == 'true' %]
[%-
isbnissn = '';
IF attrs.isbns.0;
isbnissn = attrs.isbns.0;
IF (matches = isbnissn.match('^(.+?)(\s.+)$'));
isbnissn = matches.0;
END;
END;
IF attrs.issns.0;
isbnissn=attrs.issns.0;
END;
%]
<a href='http://obalkyknih.cz/view?isbn=[% isbnissn %]' title="[% l('Title info at Obalkyknih.cz') %]">
<img
alt="[% l('Image of item') %]" id='rdetail_image'
src='[% ctx.media_prefix %]/opac/extras/ac/jacket/[% record.summary.jacket_size %]/r/[% ctx.bre_id | uri %]' />
</a>
<br />
[% ELSE %]
<a href='[% ctx.media_prefix %]/opac/extras/ac/jacket/large/r/[% ctx.bre_id | uri %]'><img
alt="[% l('Image of item') %]" id='rdetail_image'
src='[% ctx.media_prefix %]/opac/extras/ac/jacket/[% record.summary.jacket_size %]/r/[% ctx.bre_id | uri %]' />
</a>
[%- END %]

extras.tt2

V detailním záznamu dokumentu doporučujeme zrušit lištu „ Ocenění, recenze a další doporučené čtení“, která je určená pro jiné služby pro zobrazení přidaného obsahu. V případě., že je aktivováno poskytování obsahu ze serveru obalkyknih.cz, po výběru volby „ Ocenění, recenze a další doporučené čtení“ se zobrazí pouze text „Hodnocení čtenářů“ bez dalších informací.

Lištu je možné zrušit v souboru /openils/var/templates/opac/parts/record/extras.tt2:

Smažte řádek

{name => 'awards', label => l('Awards, Reviews, & Suggested Reads')},

(Ve verzi 2.11 jde o řádek 59)

Přidání podpory pro ObalkyKnih.cz do konfigurace Evergreenu

Pro zprovoznění služby Obalkyknih.cz je nutné v konfiguračním souboru /openils/conf/opensrf.xml dopnit v sekci added_content následující kód:

<ObalkyKnih>
<!-- Covers are there always -->
<!-- Annotations provided by obalkyknih.cz is mapped to evergreen summary -->
<summary>false</summary>
<!-- Provider obalkyknih.cz provides TOC as text and as PDF plus thumbnail -->
<tocPdf>true</tocPdf>
<tocText>false</tocText>
<!-- User reviews from obalkyknih.cz -->
<reviews>true</reviews>
</ObalkyKnih>

Zároveň je nutné deaktivovat zobrazení přidaného obsahu ze serveru OpenLibrary, které je v Evergreenu standardně nastaveno jako výchozí, a zapnout podporu pro Obalkyknih.cz:

<!-- <module>OpenILS::WWW::AddedContent::OpenLibrary</module> -->
<module>OpenILS::WWW::AddedContent::ObalkyKnih</module>

Zapnutí/vypnutí zobrazení některé části poskytovaného obsahu

Při standardním nastavení je aktivováno zobrazení veškerého přidaného obsahu ze serveru Obalkyknih.cz.

Obrázky obálek se zobrazují vždy, když je modul aktivován.

Ostatní části obsahu ze serveru Obalkyknih.cz (anotace, hodnocení, obsahy) je možné:

vypnout nastavením hodnoty na „false“,

případně poté znovu zapnout nastavením hodnoty na „true“.

Typy obsahu:

summary = anotace

tocPDF = naskenovaný obrázek obsahu

tocText = textová verze obsahu

review = uživatelská hodnocení *

Příklad vypnutí zobrazení anotací:

<summary>false</summary>

Zdrojové dokumenty:

Aktuální stav projektu na serveru Git

English (Anglicky)

Documentation in English language / Dokumentace v angličtině

Podpora pro zobrazování obsahu ze serveru Obalkyknih.cz v Evergreenu je realizována v rámci projektu Zkvalitnění služeb Knihovny Jána Langoše s využitím svobodného knihovního softwaru Evergreen podpořeného grantovým programem Veřejné informační služby knihoven (VISK) 3