Katalog - Zewnętrzny formularz wyszukiwania

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

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.

Formularz HTML

Najprostszym sposobem wdrożenia zewnętrznego formularza wyszukiwania w katalogu Tritia jest stworzenie prostego formularza HTML. Katalog przyjmuje bowiem frazę wyszukiwania pod adresem URL:

https://merkur.tritius.cz/search?q=neff

Formularz, który zapewni takie wywołanie katalogu, wygląda następująco:

<form method="get" action="https://merkur.tritius.cz/search">
    <input type="text" name="q" />
 
    <button type="submit">Vyhledej</button>
</form>

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.

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.

Formularz JS

Podobnie jak Katalog - Zewnętrzny formularz rejestracyjny istnieje również wersja JS formularza wyszukiwania.

<!-- Základní kostra formuláře -->
<form id="tritius-search-form" data-tritius-url="https://tritius.knihovna.cz">
</form>
   
<!-- Import obslužného JS kódu -->
<script type="text/javascript" src="https://tritius.knihovna.cz/js/tritius.js"></script>
   
<!-- Inicializace Tritius pluginu -->
<script type="text/javascript">
    (function(window) {
        tritius.init();
    })(window);
</script>

ID formularza musi być „tritius-search-form”.
Atrybut data-tritius-url zawiera adres URL, pod którym działa katalog Tritia.
Wszystkie pola formularza są dodawane automatycznie (o ile nie zostały nadpisane, patrz poniżej).
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.

Formularz zawiera kilka pól:

Nazwa pola (name)	Opis	Przepisywane	Wartość
wd	Definicja internetowa.	Ano	ID definicji internetowej, do której czytelnik będzie się logował. Domyślnie puste.
q	Wyszukiwane hasło.	Ano	Wprowadza użytkownik.
area	Przeszukiwany obszar.	Ne	Wybór przeszukiwanych obszarów jest tworzony automatycznie na podstawie ustawień Tritia.
field	Przeszukiwane pole.	Ne	Wybór pola przeszukiwania (autor, tytuł). Jest ono tworzone automatycznie na podstawie ustawień Tritia.
submit	Przycisk wysyłania.	Ano

Przepisywanie pól formularza

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.

</form>

Opisy (tłumaczenia)

Wtyczka umożliwia definiowanie opisów dla poszczególnych pól:

</form>

(function(window) {

tritius.messages.search = 'Vyhledat';

tritius.messages.to_search = 'Vyhledat...';

tritius.init();

})(window);

</script>