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

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

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:

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

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

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';

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>

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  %]

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)

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>

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>

Aktuální stav projektu na serveru Git

Documentation in English language / Dokumentace v angličtině