Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- doplnky:obalkyknih_starsi_verze [2017/08/03 12:25] – ece
+++ doplnky:obalkyknih_starsi_verze [2017/08/11 11:18] (aktuální) – ece
@@ Řádek 1: / Řádek 1: @@
+====== 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 [[http://git.evergreen-ils.org/?p=working/Evergreen.git;a=blob;f=Open-ILS/src/perlmods/lib/OpenILS/WWW/AddedContent/ObalkyKnih.pm;h=b9b34dd02791a3302672b773b5a5cb03561f4df6;hb=961191742329692f6f01f2fa4a794b2fedbf727a | 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 [[sprava_systemu:opac-prizpusobeni_sablon]]
+=== config.tt2 ===
+Do souboru ///openils/var/templates/opac/parts/**config.tt2**// doplňte následující kód:
+<code>
+##############################################################################
+# Obalkyknih.cz support
+##############################################################################
+# Obalkyknihy.cz is free Czech service providing added content and book covers
+# Set to 'true' to enable
+##############################################################################
+obalkyknih_cz.enabled = 'true';
+</code>
+=== 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:
+<code>
+ <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>
+</code>
+Místo smazané části doplňte:
+<code>
+   <div id="rdetail_image_div">
+	   [%- INCLUDE "opac/parts/record/jackets.tt2" %]
+    </div>
+</code>
+=== jackets.tt2 ===
+Vytvořte soubor
+///openils/var/templates/opac/parts/record/**jackets.tt2**// s tímto obsahem:
+<code>
+[%- 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  %]
+</code>
+=== 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
+<code>
+{name => 'awards',  label => l('Awards, Reviews, & Suggested Reads')},
+</code>
+(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:
+<code>
+<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>
+</code>
+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:
+<code>
+ <!-- <module>OpenILS::WWW::AddedContent::OpenLibrary</module> -->
+ <module>OpenILS::WWW::AddedContent::ObalkyKnih</module>
+</code>
+==== 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í:
+<code>
+ <summary>false</summary>
+</code>
+==== Zdrojové dokumenty: ====
+[[http://git.evergreen-ils.org/?p=working/Evergreen.git;a=shortlog;h=refs/heads/user/jkotrla/lp1624366-added_content_obalkyknih | Aktuální stav projektu na serveru Git]]
+===== English (Anglicky) =====
+[[doplnky:obalky_knih_english| 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 ^