Ostatnio modyfikowane 2025/11/07 14:14 przez Jan Slezák

Ukryj ostatnich autorów
Martin Mahr 3.1 1 Katalog Tritia umożliwia przyjmowanie zapytań wyszukiwania również z zewnętrznego formularza wyszukiwania umieszczonego np. na stronie biblioteki. W celu wdrożenia formularza wyszukiwania katalog oferuje dwie opcje, z których każda ma swoje zalety i wady opisane poniżej. Proszę dokładnie rozważyć, która opcja jest dla Państwa bardziej odpowiednia.
Jan Šimeček 1.1 2
Martin Mahr 3.1 3 = Formularz HTML =
Jan Šimeček 1.1 4
Martin Mahr 3.1 5 Najprostszym sposobem wdrożenia zewnętrznego formularza wyszukiwania w katalogu Tritia jest stworzenie prostego formularza HTML. Katalog przyjmuje bowiem frazę wyszukiwania pod adresem URL:
Jan Šimeček 1.1 6
7 [[https:~~/~~/merkur.tritius.cz/search?q=neff>>url:https://merkur.tritius.cz/search?q=neff]]
8
9
Martin Mahr 3.1 10 Formularz, który zapewni takie wywołanie katalogu, wygląda następująco:
Jan Šimeček 1.1 11
Jan Šimeček 2.1 12 |
Jan Šimeček 1.1 13
14 {{{<form method="get" action="https://merkur.tritius.cz/search">
15 <input type="text" name="q" />
16  
17 <button type="submit">Vyhledej</button>
18 </form>}}}
19
Martin Mahr 3.1 20 Jak widać, utworzenie formularza i włączenie go do strony biblioteki jest bardzo proste. Formularz umożliwia bardzo łatwe wywołanie prostego wyszukiwania w katalogu. Wadą jest to, że w ten sposób można wywołać tylko proste wyszukiwanie bez dodatkowych ustawień (ograniczenia pola wyszukiwania, sortowanie itp.). Te dodatkowe opcje są bowiem powiązane z ustawieniami Tritia i identyfikatorami systemowymi poszczególnych elementów wyszukiwania. Na przykład przeszukiwane obszary lub identyfikatory wyszukiwanych pól.
Jan Šimeček 1.1 21
Martin Mahr 3.1 22 |Jeśli znasz się na HTML i technologiach internetowych, na pewno przyszło Ci do głowy, że identyfikatory np. przeszukiwanych obszarów można skopiować z Tritia i wstawić do formularza. Tak, jest to możliwe, ale nie zalecamy tego. W przypadku jakiejkolwiek zmiany ustawień w Tritiu istnieje prawdopodobieństwo, że taki formularz przestanie działać. Ponadto istnieje ryzyko, że z jakichś powodów zmienimy nazwy identyfikatorów lub zdecydujemy się pracować z nazwami zamiast identyfikatorami, a formularz przestanie działać po wdrożeniu nowej wersji Tritia.
Jan Šimeček 1.1 23
Martin Mahr 3.1 24 = Formularz JS =
Jan Šimeček 1.1 25
Martin Mahr 3.1 26 Podobnie jak [[Katalog - Zewnętrzny formularz rejestracyjny>>doc:uzivatelsky-manual.Pro-spravce.Katalog-Externi-prihlasovaci-formular.WebHome]] istnieje również wersja JS formularza wyszukiwania.
Jan Šimeček 1.1 27
Jan Šimeček 2.1 28 |
Jan Šimeček 1.1 29
30 {{{<!-- Základní kostra formuláře -->
31 <form id="tritius-search-form" data-tritius-url="https://tritius.knihovna.cz">
32 </form>
33
34 <!-- Import obslužného JS kódu -->
35 <script type="text/javascript" src="https://tritius.knihovna.cz/js/tritius.js"></script>
36
37 <!-- Inicializace Tritius pluginu -->
38 <script type="text/javascript">
39 (function(window) {
40 tritius.init();
41 })(window);
Martin Mahr 3.1 42 </script>
43 }}}
Jan Šimeček 1.1 44
Martin Mahr 3.1 45 * ID formularza musi być „**tritius-search-form**”.
46 * Atrybut **data-tritius-url** zawiera adres URL, pod którym działa katalog Tritia.
47 * Wszystkie pola formularza są dodawane automatycznie (o ile nie zostały nadpisane, patrz poniżej).
48 * W Tritium należy ustawić domenę, na której dozwolony jest zewnętrzny formularz logowania (pozycja ustawień: EXTERNAL_LOGIN_FORM_ALLOWED_ORIGIN). Dotyczy to również zewnętrznego formularza wyszukiwania.
Jan Šimeček 1.1 49
Martin Mahr 3.1 50 Formularz zawiera kilka pól:
Jan Šimeček 1.1 51
52 |=(((
Martin Mahr 3.1 53 Nazwa pola (name)
54 )))|=Opis|=(% colspan="1" %)Przepisywane|=(% colspan="1" %)Wartość
55 |wd|Definicja internetowa.|(% colspan="1" %)Ano|(% colspan="1" %)(((
56 ID definicji internetowej, do której czytelnik będzie się logował.
Jan Šimeček 1.1 57
Martin Mahr 3.1 58 Domyślnie puste.
Jan Šimeček 1.1 59 )))
Martin Mahr 3.1 60 |(% colspan="1" %)q|(% colspan="1" %)Wyszukiwane hasło.|(% colspan="1" %)Ano|(% colspan="1" %)Wprowadza użytkownik.
61 |(% colspan="1" %)area|(% colspan="1" %)Przeszukiwany obszar.|(% colspan="1" %)Ne|(% colspan="1" %)Wybór przeszukiwanych obszarów jest tworzony automatycznie na podstawie ustawień Tritia.
62 |(% colspan="1" %)field|(% colspan="1" %)Przeszukiwane pole.|(% colspan="1" %)Ne|(% colspan="1" %)Wybór pola przeszukiwania (autor, tytuł). Jest ono tworzone automatycznie na podstawie ustawień Tritia.
63 |(% colspan="1" %)submit|(% colspan="1" %)Przycisk wysyłania.|(% colspan="1" %)Ano|(% colspan="1" %)
Jan Šimeček 1.1 64
Martin Mahr 3.1 65 = Przepisywanie pól formularza =
Jan Šimeček 1.1 66
Martin Mahr 3.1 67 Skrypt obsługowy przed dodaniem pola formularza zawsze sprawdza, czy pole o danej nazwie już nie istnieje. Jeśli tak, nie dodaje go i pozostawia zapisane w HTML.
Jan Šimeček 1.1 68
69 |(((
70 <!~-~- Import obslužného JS kódu ~-~->
71
72 <script type="text/javascript" src="[[https:~~/~~/tritius.knihovna.cz/js/tritius.js">>url:https://tritius.knihovna.cz/js/tritius.js]]></script>
73
74
75 <!~-~- Základní kostra formuláře ~-~->
76
77 <form id="tritius-login-form" data-tritius-url="[[https:~~/~~/tritius.knihovna.cz">>url:https://tritius.knihovna.cz/]]>
78
79 <input type="text" name="q"  placeholder="Vyhledávání..." />
80
81 </form>
82 )))
83
Martin Mahr 3.1 84 = Opisy (tłumaczenia) =
Jan Šimeček 1.1 85
Martin Mahr 3.1 86 Wtyczka umożliwia definiowanie opisów dla poszczególnych pól:
Jan Šimeček 1.1 87
88
89 |(((
90 <!~-~- Základní kostra formuláře ~-~->
91
92 <form id="tritius-search-form" data-tritius-url="[[https:~~/~~/tritius.knihovna.cz">>url:https://tritius.knihovna.cz/]]>
93
94 </form>
95
96
97 <!~-~- Import obslužného JS kódu ~-~->
98
99 <script type="text/javascript" src="[[https:~~/~~/tritius.knihovna.cz/js/tritius.js">>url:https://tritius.knihovna.cz/js/tritius.js]]></script>
100
101
102 <!~-~- Inicializace Tritius pluginu ~-~->
103
104 <script type="text/javascript>
105
106 (function(window) {
107
108 tritius.messages.search = 'Vyhledat';
109
110 tritius.messages.to_search = 'Vyhledat...';
111
112 tritius.init();
113
114 })(window);
115
116 </script>
117 )))