Katalog - Zewnętrzny formularz wyszukiwania
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.
<!-- Import obslužného JS kódu --> <script type="text/javascript" src="https://tritius.knihovna.cz/js/tritius.js"></script> <!-- Základní kostra formuláře --> <form id="tritius-login-form" data-tritius-url="https://tritius.knihovna.cz"> <input type="text" name="q" placeholder="Vyhledávání..." /> </form> |
Opisy (tłumaczenia)
Wtyczka umożliwia definiowanie opisów dla poszczególnych pól:
<!-- 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.messages.search = 'Vyhledat'; tritius.messages.to_search = 'Vyhledat...'; tritius.init(); })(window); </script> |