Selectbox Autocompleter

Opis

Plugin Selectbox Autocompleter usprawnia działanie standardowych list rozwijanych w Redmine, dodając funkcję szybkiego wyszukiwania wewnątrz treści. Jest to idealne rozwiązanie dla systemów z dużymi listami zadań (issues), użytkowników, projektów lub innych encji.

Kluczowe możliwości:

Inteligentne wyszukiwanie: Natychmiastowe filtrowanie opcji podczas wpisywania tekstu.
Wsparcie dla wszystkich encji: Działa z listami użytkowników (Przypisany/Autor), projektów, wersji, kategorii oraz pól niestandardowych (Custom Fields) typu «Lista».
Ulepszony UX: Eliminuje konieczność nieskończonego przewijania długich list.

Kompatybilność

Redmine: 5.0 - 6.0

Przeglądarki internetowe: Chrome, Firefox, Safari, Edge

Bazy danych: MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

Pluginy: redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, module_manager, periodic_reminder, user_group_editor, queries_perfect, advanced_workflow, cost_calculator.

Instalacja i Aktualizacja

Usuń starą wersję pluginu z Redmine, jeśli istnieje.
```
cd redmine/plugins
rm -r selectbox_autocompleter
```
Skopiuj nowy folder pluginu selectbox_autocompleter do redmine/plugins/
Zatrzymaj i uruchom Redmine. (W niektórych instalacjach Redmine (np. w Docker) ważne jest rzeczywiste zatrzymanie i uruchomienie serwera, a nie tylko jego restart.)

Deinstalacja

Usuń folder pluginu selectbox_autocompleter z redmine/plugins/

rm -r selectbox_autocompleter

Zatrzymaj i uruchom Redmine.

Konfiguracja

Sprawdź i zmień ustawienia pluginu w Administration -> Modules -> Selectbox Autocompleter.

Administration

Sekcja «Modules»

W Administration → Modules → Selectbox Autocompleter możesz skonfigurować:

Dodawanie pola wyszukiwania, jeśli elementów jest więcej niż 7 i ID nadrzędnego kontenera pasuje.
Selektory kontenerów, w których elementy select zostaną zastąpione.
Selektory, które mają zostać pominięte.

Dodawanie wyszukiwania do elementów select

Plugin działa w następujący sposób:

Znajduje elementy select na podstawie podanych ID lub klas.
Zastępuje znalezione elementy select polami select z obsługą wyszukiwania.
Działa tylko dla selektorów wyraźnie wskazanych w ustawieniach pluginu.

Przykład:

Jeśli chcesz dodać funkcję wyszukiwania do elementów select znajdujących się wewnątrz formularza zadania (issue), możesz użyć ID kontenera formularza:

#issue-form

W tym przypadku:

Plugin stosuje wyszukiwanie do wszystkich elementów select wewnątrz formularza zadania.
Wszystkie listy rozwijane na stronach tworzenia i edycji zadań będą wyświetlane z funkcją wyszukiwania.

Określony selektor należy dodać do ustawień pluginu i zapisać zmiany.

Ignorowanie elementów select

Niektóre elementy select w Redmine posiadają już wbudowaną funkcję wyszukiwania. Aby uniknąć duplikacji (dwa pola wyszukiwania w jednym polu), takie elementy należy ignorować.

Przykład:

#available_c

W tym przypadku:

Plugin wykrywa element select #available_c.
Ignoruje go.

Jeśli element select nie zostanie dodany do listy ignorowanych, możliwe jest wyświetlenie dwóch elementów wyszukiwania jednocześnie.

Użycie

Kliknij na skonfigurowaną listę rozwijaną (np. na stronie zadań, select «Grupuj wyniki według»).
Na górze listy pojawi się pasek wyszukiwania.
Zacznij wpisywać nazwę lub tytuł — lista automatycznie się przefiltruje, pozostawiając tylko pasujące opcje.