Najczęściej zadawane pytania
- Jak zmienić logo biblioteki?
- Jak zmienić tekst wyświetlany na stronach?
- Jak dodać link w sekcji "Informacje" na stronie głównej?
- Gdzie można zmienić informację o adresie i informacjach dotyczących instytucji tworzących bibliotekę?
- Jak dodać nową stronę pomocy?
- Jak podmienić plik graficzny wyświetlany na stronach aplikacji czytelnika?
- Jak zmienić tytuł strony wyświetlanej przez aplikacje Czytelnika?
- Jak zmienić zawartość znaczników meta w nagłówkach stron WWW aplikacji czytelnika?
- Jak uzależnić logo biblioteki od języka interfejsu który wybrał użytkownik?
- Gdzie w aplikacji czytelnika dlibra 5.0 znajduję się główny plik z makrami VTL?
- Co zrobić gdy aplikacja czytelnika działa bardzo wolno ?
- Problemy z certyfikatem przy dostępie do strony kontakt
- 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"?
- Jak uruchomić kilka aplikacji czytelnika z jednym serwerem dLibra?
Jak zmienić logo biblioteki?
Patrz 04. Dostosowywanie wyglądu aplikacji czytelnika
Jak zmienić tekst wyświetlany na stronach?
Dowolną etykietę tekstową używaną w szablonie komponentu można "przykryć", podając nową wartość w plikach: dlibra-webapp/WEB-INF/components/resources/WEBAPP_xx.xml. Zostanie ona natychmiast uwzględniona.
Przykładowo w komponencie odpowiedzialnym za sekcję "Aktualności" (NewsComponent) jest wykorzystywana etykieta "NewsComponent.News" jej wartość to : "Aktualności". Chcąc zmienić tę wartość dla języka polskiego dodajemy klucz NewsComponent.News do pliku dlibra-webapp/WEB-INF/components//resources/WEBAPP_pl.xml i podajemy tam nową wartość dla tej etykiety np. "Wiadomości".
Jak dodać link w sekcji "Informacje" na stronie głównej?
W "Informacjach" mogą się znaleźć 3 rodzaje linków:
- do istniejącej strony pomocy,
- do zasobów wewnątrz aplikacji czytelnika np. konkretnej publikacji,
- do strony zewnętrznej np. strony instytucji tworzącej bibliotekę.
Należy postępować w następujący sposób:
- zalogować się do panelu administracyjnego aplikacji czytelnika,
- przejść do sekcji "informację - zawartość",
- Wybierz "Dodaj nową pozycję",
- W przypadku stron pomocy, wybieramy odpowiednią stronę i klikamy przycisk "Dodaj",
- Wypełniamy formularz,
- Link do zasobów wewnątrz aplikacji czytelnika powinien wyglądać tak: $homeURL/dlibra/contact. W miejsce znacznika $homeURL zostanie wstawiony adres aplikacji czytelnika.
- Następnie zatwierdzamy formularz.
Gdzie można zmienić informację o adresie i informacjach dotyczących instytucji tworzących bibliotekę?
Dane adresowe zmieniamy w plikach webapp/WEB-INF/components/resources/WEBAPP_xx.xml pod kluczem ContactComponent.Address. Informacje o instytucjach tworzących bibliotekę zmieniamy w plikach webapp/WEB-INF/layout/resources/layout_xx.xml pod kluczem Home.Copyright.
Jak dodać nową stronę pomocy?
Strony pomocy przechowywane są w bazie danych aplikacji czytelnika. Aby dodać nową stronę należy zalogować się do panelu administracyjnego aplikacji czytelnika. Dalej postępować zgodnie z opisaną poniżej procedurą.
Procedura dodawania takiej strony jest następująca: (operuje polskimi nazwami)
- Otwieramy panel administracyjny www.
- Przechodzimy do sekcji stron pomocy.
- W stronach pomocy wybieramy "Dodaj".
- Wypełniamy formularz odpowiednimi wartościami (identyfikator/tytuł/treść/JĘZYK)
- Zatwierdzamy i zostanie utworzona strona w wybranym języku. Aby dodać wersję w innym języku, należy utworzyć drugą stronę pomocy. Strona ta powinna mieć taki sam IDENTYFIKATOR, ale inny język.
Jak podmienić plik graficzny wyświetlany na stronach aplikacji czytelnika?
Informacje o sposobach zamiany plików graficznych można znaleźć w rozdziale 04. Dostosowywanie wyglądu aplikacji czytelnika - Podmiana istniejących obrazków (logo).
Jak zmienić tytuł strony wyświetlanej przez aplikacje Czytelnika?
Tytuły stron Aplikacji Czytelnika są zdefiniowane w pliku webapp/WEB-INF/pages-titles.xml. Poniżej zaprezentowano przykładowy wpis dla strony głównej.
<page name="main"> <title></title> <subTitle></subTitle> </page>
W przypadku strony głównej zarówno tag title jak i subtitle są puste. Możemy wpisać tam dowolną wartość stałą lub przekazaną ze zmiennej velocity np.:
<title><![CDATA[Moja Biblioteka Cyfrowa]]></title> lub <title><![${res.getProperty('base.library.full')}]]></title>
Na poziomie szablonów aplikacji czytelnika wartości wyrażeń zawawrtych w znacznikach title i subtitle dostępne są poprzez zmienne pageTitle i pageSubtitle. Aby zrozumieć jak tworzony jest tytuł strony w aplikacji Czytelnika, poniżej przytoczono fragment pliku webapp/WEB-INF/layout/templates/parts/meta-header.vm.
#if ($pageTitle) #set($metaTitle = "${escapeUtil.parseHtmlToText($pageTitle)} - ${res.getProperty('base.library.full')}") #else #set($metaTitle = "${res.getProperty('base.library.full')}") #end
Tytuł strony tworzony jest:
- poprzez połączenie tytułu z deklaracji w pages_titles.xml oraz wpisu z zasobów językowych, jeśli tytuł został zadeklarowany w pliku pages_titles.xml dla danej strony,
z wpisu z zasobów językowych, jeśli tytuł nie został zadeklarowany w pliku pages_titles.xml dla danej strony.
Ostrzeżenie
Zmieniając zawartość pliku pages-titles.xml proszę pamiętać, że:
- zawartość znaczników title i subtitle nie może zawierać znaków nowej linii - ich obecność spowoduje powstanie błędów w wynikowym kodzie HTML strony WWW,
- nie należy usuwać znacznika początkowego <![CDATA i końcowego ]]>,
- należy pamiętać o tym, że plik jest kodowany w UTF-8.
Zmiany w pliku pages-titles.xml są widoczne od razu bez konieczności restartu aplikacji Czytelnika.
Jak zmienić zawartość znaczników meta w nagłówkach stron WWW aplikacji czytelnika?
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ślnej konfiguracji dLiby pamięć podręczna (cache) aplikacji czytelnika jest wyłączona. 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:
- abonent lub użytkownik końcowy zostanie uprzednio bezpośrednio poinformowany w sposób jednoznaczny, łatwy i zrozumiały, o:
- celu przechowywania i uzyskiwania dostępu do tej informacji,
- 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;
- abonent lub użytkownik końcowy, po otrzymaniu informacji, o których mowa w pkt 1, wyrazi na to zgodę;
- 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:
- wykonania transmisji komunikatu za pośrednictwem publicznej sieci telekomunikacyjnej;
- 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:
- 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;
- 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;
- 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?
- 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 musi być portem, na którym aplikacja będzie mogła nasłuchiwać). W kolumnie ser_description można wpisać dowolny pomocniczy opis, nie ma on wpływu na działanie systemu.
- Utworzenie nowej instancji aplikacji czytelnika: można wykorzystać instalator, aby zainstalować drugą aplikację czytelnika w nowym miejscu, lub skopiować istniejącą aplikację. 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ć ścieżkę katalogu webapp-works we wszystkich plikach w katalogu WEB-INF).
- 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.
- 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.
- 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.