Kod źródłowy Wiki Katalog - Externí vyhledávací formulář
Ostatnio modyfikowane 2025/11/07 14:14 przez Jan Slezák
Ukryj ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| |
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. |
| |
1.1 | 2 | |
| |
3.1 | 3 | = Formularz HTML = |
| |
1.1 | 4 | |
| |
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: |
| |
1.1 | 6 | |
| 7 | [[https:~~/~~/merkur.tritius.cz/search?q=neff>>url:https://merkur.tritius.cz/search?q=neff]] | ||
| 8 | |||
| 9 | |||
| |
3.1 | 10 | Formularz, który zapewni takie wywołanie katalogu, wygląda następująco: |
| |
1.1 | 11 | |
| |
2.1 | 12 | | |
| |
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 | |||
| |
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. |
| |
1.1 | 21 | |
| |
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. |
| |
1.1 | 23 | |
| |
3.1 | 24 | = Formularz JS = |
| |
1.1 | 25 | |
| |
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. |
| |
1.1 | 27 | |
| |
2.1 | 28 | | |
| |
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); | ||
| |
3.1 | 42 | </script> |
| 43 | }}} | ||
| |
1.1 | 44 | |
| |
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. | ||
| |
1.1 | 49 | |
| |
3.1 | 50 | Formularz zawiera kilka pól: |
| |
1.1 | 51 | |
| 52 | |=((( | ||
| |
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ł. | ||
| |
1.1 | 57 | |
| |
3.1 | 58 | Domyślnie puste. |
| |
1.1 | 59 | ))) |
| |
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" %) | ||
| |
1.1 | 64 | |
| |
3.1 | 65 | = Przepisywanie pól formularza = |
| |
1.1 | 66 | |
| |
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. |
| |
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 | |||
| |
3.1 | 84 | = Opisy (tłumaczenia) = |
| |
1.1 | 85 | |
| |
3.1 | 86 | Wtyczka umożliwia definiowanie opisów dla poszczególnych pól: |
| |
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 | ))) |