[EN] 08. Frequently Asked Questions

How to change the library logo?

See 04. Adjusting the Look of the Reader Application

How to change the text displayed on the pages?

Any text label used in the component template can be “covered” by entering the new value in “dlibra-webapp/WEB-INF/components/resources/WEBAPP_xx.xml” files. It will be immediately applied.

For example, in the component responsible for the “News” section (“NewsComponent”), the “NewsComponent.News” label is used, with the “News” value. [*] In order to change that value for Polish, the “NewsComponent.News” key should be added to the “dlibra-webapp/WEBINF/components//resources/WEBAPP_pl.xml” file, and a new value for that label – for example, “News” – should be entered there.

How to add a link in the “Information” section of the home page?

There are three types of links which can be used in the “Information” section:

1. to an existing help page,
2. to resources in the reader application, for example, to a specific publication, and
3. to an external website, for example, to the website of an institution which creates the library.

Follow these instructions:

1. Log into the administration panel of the reader application.
2. Go to the “Information > Content” section.
3. Select the “Add a new position” option.
   1. In the case of help pages, select the page and click the “Add” button.
4. Fill in the form.
5. LA link to resources in the reader application should look as follows: $homeURL/dlibra/contact. The “$homeURL” tag will be replaced with the address of the reader application.
6. Confirm the form.

Where can the information about the address and the institutions which create the library be added?

Address data are changed in “webapp/WEB-INF/components/resources/WEBAPP_xx.xml” files, at the “ContactComponent.Address” key. Information about the institutions which create the lbrary are changed in “webapp/WEB-INF/layout/resources/layout_xx.xml ” files, at the “Home.Copyright.” key. 

How can a new help page be added?

Help pages are stored in the database of the reader application. In order to add a new help page, the user should log into the administration panel of the reader application and follow the instructions given below.

The instructions are:

1. Open the administration panel of the reader application.
2. Go to the help page section.
3. Select the “Add” option.
4. Enter appropriate values (identifier/title/content/language) in the form.
5. Confirm; a page in the selected language will be created. In order to create a version in another language, create another help page, with the same identifier but a different language.

How can a graphics file displayed on the pages of the reader application be replaced?

For information about the methods of changing graphics files, see chapter 04. Adjusting the Look of the Reader Application. Changing the Existing Images (Logo).

How can the title of a page displayed by the reader application be changed?

TThe titles of pages of the reader application are defined in the “webapp/WEB-INF/pages-titles.xml” file. A sample entry for the home page is presented below:

<page name="main">
	<title></title>
 	<subTitle></subTitle>
</page>

In the case of the home page, both the tag title and subtitle are empty. Any constant value or value from the “velocity” variable can be entered there, for example:

<title><![CDATA[Moja Biblioteka Cyfrowa]]></title>
lub
<title><![${res.getProperty('base.library.full')}]]></title>

At the level of reader application templates, the values of the expressions in the “title” and “subtitle” tags are available through the “pageTitle” and “pageSubtitle” tags.i  A fragment of the “webapp/WEB-INF/layout/templates/parts/meta-header.vm.” file is presented below as an illustration of the process of creating a page title in the reader application.

#if ($pageTitle)
	#set($metaTitle = "${escapeUtil.parseHtmlToText($pageTitle)} - ${res.getProperty('base.library.full')}")
#else
	#set($metaTitle = "${res.getProperty('base.library.full')}")
#end

A page title is created:

1. by combining the title from the declaration in the “pages_titles.xml” file with an entry from language resources – if the title has been declared in the “pages_titles.xml” file for the given page; or
2. from an entry from language resources if the title has not been declared in the “pages_titles.xml” file for the given page.

Changes in the “pages-titles.xml” file are visible immediately – the reader application does not have to be restarted.

How can the content of the meta tags in the headings of the web pages of the reader application be changed?

Znaczniki meta w nagłówkach zmieniamy w pliku webapp/WEB-INF/layout/templates/parts/meta-header.vm. Możemy również dodać nowe, własne znaczniki. Zmienne takie jak $pageTitle(tytuł), $pageSubTitle(opis), $pageTitledImage(miniatura) są ustawiane w pliku webapp/WEB-INF/pages-titles.xml. W zależności od różnych identyfikatorów stron(np. publication, latest itd) mają one różne wartości. Np. w przypadku strony głównej tytułem będzie nazwa biblioteki, a w przypadku strony obiektu cyfrowego będzie to najprawdopodobniej tytuł tego obiektu.

Jak uzależnić logo biblioteki od języka interfejsu który wybrał użytkownik?

Informacja o sposobie zmiany loga w zależności od wybranego języka można znaleźć w rozdziale: 04. Dostosowywanie wyglądu aplikacji czytelnika - Podmiana istniejących obrazków (logo).

Gdzie w aplikacji czytelnika dlibra 5.0 znajduję się główny plik z makrami VTL?

Pliki z makrami znajdują się w archiwum /WEB-INF/lib/dlibra-web-components-x.x.x.jar. Są to pliki component_library.vm oraz layout_library.vm. Makra możemy nadpisywać definiując je ponownie adekwatnie w plikach /WEB-INF/components/templates/custom_library.vm oraz /WEB-INF/layouts/templates/layout_library.vm

Co zrobić gdy aplikacja czytelnika działa bardzo wolno ?

W domyślnie zainstalowanej dLibrze pamięć podręczna (cache) aplikacji czytelnika jest wyłączony. Jeżeli aplikacja czytelnika zaczyna działać wolno warto włączyć pamięć podręczną. Aby tego dokonać należy w pliku /WEB-INF/conf/cache.properties zmienić wartość flagi use.cache na true. Następnie należy zrestartować tomcata. W czasie uruchamiania aplikacji czytelnika z serwera pobrane zostaną niezbędne dane. W związku z tym uruchomienie aplikacji czytelnika może trwać dłużej niż przed włączeniem pamięci cache. Gdy wszystkie informacje zostaną pobrane i aplikacja poprawnie wystartuje, przyspieszenie działania powinno być wyraźnie odczuwalne.

Problemy z certyfikatem przy dostępie do strony kontakt

Po kliknięciu w "Kontakt" przeglądarka wyświetla błąd informujący o tym, że "Certyfikat nie jest zaufany, ponieważ jest on samopodpisany." lub "Ten certyfikat utracił ważność: (tutaj data). (Kod błędu: sec_error_expired_issuer_certificate)".

Instrukcja pozwalająca na wygenerowanie nowego certyfikatu dla tomcata jest bardzo prosta. Sprowadza się do wydania komendy :

$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA

i wpisaniu wszystkich danych instytucji. Polecenie powinno zostać wywołane przez użytkownika który uruchamia tomcata. Aby zmiany zostały uwzględnione konieczny jest restart tomcata.

Wygenerowanie nowego certyfikatu rozwiąże problem związany z przekroczeniem terminu przydatności, nowoczesne przeglądarki i tak będą ostrzegać przed takim certyfikatem ponieważ nie został on wystawiony przez uprawnioną instytucję certyfikującą. Aby temu zaradzić należy zwrócić się z prośbą o wygenerowanie certyfikatu do takiej właśnie instytucji.

Do czego konkretnie używane są cookies w dLibrze? Co w związku z tym jako administrator muszę zrobić aby pozostać w zgodzie z art. 173 ustawy "Prawo telekomunikacyjne"?

 Od 22 marca 2013 r. obowiązuje w Polsce znowelizowane Prawo telekomunikacyjne (http://www.dziennikustaw.gov.pl/DU/2012/1445). Artykuł 173 tej ustawy brzmi:

Art. 173.

1. Przechowywanie informacji lub uzyskiwanie dostępu do informacji już przechowywanej w telekomunikacyjnym urządzeniu końcowym abonenta lub użytkownika końcowego jest dozwolone, pod warunkiem że:

1. abonent lub użytkownik końcowy zostanie uprzednio bezpośrednio poinformowany w sposób jednoznaczny, łatwy i zrozumiały, o:
   1. celu przechowywania i uzyskiwania dostępu do tej informacji,
   2. możliwości określenia przez niego warunków przechowywania lub uzyskiwania dostępu do tej informacji za pomocą ustawień oprogramowania zainstalowanego w wykorzystywanym przez niego telekomunikacyjnym urządzeniu końcowym lub konfiguracji usługi;
2. abonent lub użytkownik końcowy, po otrzymaniu informacji, o których mowa w pkt 1, wyrazi na to zgodę;
3. przechowywana informacja lub uzyskiwanie do niej dostępu nie powoduje zmian konfiguracyjnych w telekomunikacyjnym urządzeniu końcowym abonenta lub użytkownika końcowego i oprogramowaniu zainstalowanym w tym urządzeniu.

2. Abonent lub użytkownik końcowy może wyrazić zgodę, o której mowa w ust. 1 pkt 2, za pomocą ustawień oprogramowania zainstalowanego w wykorzystywanym przez niego telekomunikacyjnym urządzeniu końcowym lub konfiguracji usługi.
3. Warunków, o których mowa w ust. 1, nie stosuje się, jeżeli przechowywanie lub uzyskanie dostępu do informacji, o której mowa w ust. 1, jest konieczne do:

1. wykonania transmisji komunikatu za pośrednictwem publicznej sieci telekomunikacyjnej;
2. dostarczania usługi telekomunikacyjnej lub usługi świadczonej drogą elektroniczną, żądanej przez abonenta lub użytkownika końcowego.

4. Podmioty świadczące usługi telekomunikacyjne lub usługi drogą elektroniczną mogą instalować oprogramowanie w telekomunikacyjnym urządzeniu końcowym abonenta lub użytkownika końcowego przeznaczonym do korzystania z tych usług lub korzystać z tego oprogramowania, pod warunkiem że abonent lub użytkownik końcowy:

1. przed instalacją oprogramowania zostanie poinformowany bezpośrednio, w sposób jednoznaczny, łatwy i zrozumiały, o celu, w jakim zostanie zainstalowane oprogramowanie, oraz sposobach korzystania przez podmiot świadczący usługi z tego oprogramowania;
2. zostanie poinformowany bezpośrednio, w sposób jednoznaczny, łatwy i zrozumiały, o sposobie usunięcia oprogramowania z telekomunikacyjnego urządzenia końcowego użytkownika lub abonenta;
3. przed instalacją oprogramowania wyrazi zgodę na jego instalację i używanie.

Stosowane w Aplikacji Czytelnika systemu dLibra pliki cookie związane są z dwoma podstawowymi aspektami funkjonowania tego systemu:

• utrzymaniem bieżącej sesji użytkownika, w której pamiętane są np. ostatnio wydane zapytanie wyszukiwawcze i jego wyniki, tożsamość użytkownika (po zalogowaniu) itp.
• zachowaniem preferencji określonych przez użytkownika, np. domyślnego sposobu wyświetlania publikacji DjVu czy wyłączenia stron informacyjnych o formatach publikacji (w starszych wersjach dLibry)

Obydwa te aspekty podpadają pod ustęp 3 art. 173 Prawa telekomunikacyjnego, gdyż są niezbędne do zapewnienia funkcjonalności aplikacji, z której chce skorzystać użytkownik. Oznacza to, że w podstawowej konfiguracji systemu dLibra nie jest konieczne wyświetlanie użytkownikowi specjalnych komunikatów dotyczących cookie i ich akceptacji.

UWAGA: W momencie kiedy Aplikacja Czytelnika zostanie na potrzeby danej biblioteki cyfrowej rozszerzona o dodatkowe komponenty takie jak banery automatycznych systemów reklamowych czy monitorowanie ruchu przy pomocy Google Analytics, konieczne będzie wprowadzenie dodatkowego komunikatu lub komponentu informacyjnego na strony objęte taką dodatkową funkcjonalnością. W takiej sytuacji zalecamy zapoznanie się z polityką prywatności poszczególnych dostawców dodatkowych usług (np. dla Google Analytics: http://www.google.com/intl/pl/analytics/privacyoverview.html).

Jak uruchomić kilka aplikacji czytelnika z jednym serwerem dLibra?

1. Konfiguracja połączenia w serwerze dLibra: w bazie danych serwera, w tabeli sys_services, należy dodać wiersz dla nowej aplikacji czytelnika. Wiersz ten będzie bardzo podobny do istniejącego wpisu, w którym ser_type=ps. Musi tylko być zmienione ser_id na kolejną wolną wartość, oraz ser_password i ser_port na dowolne inne wartości (ser_port nie odpowiada faktycznemu portowi, z którego łączy się aplikacja - posłuży tylko do odróżnienia jednej aplikacji od drugiej). W kolumnie ser_description można wpisać dowolny pomocniczy opis, nie ma on wpływu na działanie systemu.
2. Utworzenie nowej instancji aplikacji czytelnika: można wykorzystać instalator, aby zainstalować drugą apliację czytelnika w nowym miejscu, lub skopiować istniejącą apliację. W tym drugim przypadku trzeba pamiętać o skopiowaniu katalogu webapp-works i podmianie wszystkich plików konfiguracyjnych, w których ten katalog jest wymieniony (najlepiej wyszukać we wszystkich plikach w katalogu WEB-INF).
3. Konfiguracja połączenia do serwera dLibra: w pliku WEB-INF/conf/services.properties należy ustawić port we wpisie my.url oraz hasło w my.password na takie, jakie zostały dodane w tabeli sys_services.
4. Konfiguracja kolekcji głównej w nowej aplikacji, zgodnie z tym wpisem. Należy pamiętać, że kolekcja ta będzie dalej widoczna w głównej aplikacji czytelnika. Jeśli treści prezentowane przez dwie aplikacje czytelnika mają być rozłączne, wtedy obie aplikacje muszą mieć ustawione kolekcje główne, tak aby jedna z tych kolekcji nie była podkolekcją drugiej.
5. Konfiguracja Tomcata: jeśli Tomcat jest skonfigurowany zgodnie z zaleceniami, czyli poprzez plik ROOT.xml w katalogu tomcat/conf/Catalina/localhost, to najłatwiej będzie skopiować ten plik pod nową nazwą, np. podstrona.xml (w tym samym katalogu). Dzięki temu, jeśli np. pierwotna strona była dostępna pod adresem http://bilioteka.pl/dlibra, to nowa strona będzie pod adresem http://biblioteka.pl/podstrona/dlibra. Należy oczywiście zmodyfikować skopiowany plik xml, aby zawierał ścieżkę do katalogu, w którym znajduje się nowa instancja aplikacji czytelnika. Trzeba się też upewnić, że adres, pod którym będzie dostępna nowa aplikacja, jest poprawnie wpisany w pliku WEB-INF/templates.properties.