Selectbox Autocompleter

Descrizione

Il plugin Selectbox Autocompleter migliora il funzionamento delle liste a discesa standard in Redmine, aggiungendo una funzione di ricerca rapida all'interno del contenuto. È la soluzione ideale per sistemi con lunghe liste di issue, utenti, progetti o altre entità.

Funzionalità principali:

Ricerca intelligente: Filtraggio istantaneo delle opzioni durante la digitazione del testo.
Supporto per tutte le entità: Funziona con le liste di utenti (Assegnatario/Autore), progetti, versioni, categorie e campi personalizzati (Custom Fields) di tipo «Lista».
UX migliorato: Elimina la necessità di scorrere infinitamente liste lunghe.

Compatibilità

Redmine: 5.0 - 6.0

Browser Web: Chrome, Firefox, Safari, Edge

Database: MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

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

Installazione e Aggiornamento

Rimuovere la vecchia versione del plugin da Redmine, se esistente.
```
cd redmine/plugins
rm -r selectbox_autocompleter
```
Copiare la nuova cartella del plugin selectbox_autocompleter in redmine/plugins/
Arrestare e avviare Redmine. (In alcune installazioni di Redmine (ad esempio, in Docker) è importante arrestare e avviare effettivamente il server, non solo riavviarlo.)

Disinstallazione

Rimuovere la cartella del plugin selectbox_autocompleter da redmine/plugins/

rm -r selectbox_autocompleter

Arrestare e avviare Redmine.

Configurazione

Verificare e modificare le impostazioni del plugin in Administration -> Modules -> Selectbox Autocompleter.

Administration

Sezione «Modules»

In Administration → Modules → Selectbox Autocompleter è possibile configurare:

Aggiungere un campo di ricerca se ci sono più di 7 elementi e l'ID del contenitore padre corrisponde.
Selettori dei contenitori in cui gli elementi select verranno sostituiti.
Selettori che verranno ignorati.

Aggiunta della ricerca agli elementi select

Il plugin funziona come segue:

Trova gli elementi select in base agli ID o alle classi specificati.
Sostituisce gli elementi select trovati con campi select che supportano la ricerca.
Funziona solo per i selettori esplicitamente indicati nelle impostazioni del plugin.

Esempio:

Se è necessario aggiungere la funzionalità di ricerca agli elementi select situati all'interno di un modulo di issue, è possibile utilizzare l'ID del contenitore del modulo:

#issue-form

In questo caso:

Il plugin applica la ricerca a tutti gli elementi select all'interno del modulo dell'issue.
Tutte le liste a discesa nelle pagine di creazione e modifica degli issue verranno visualizzate con la funzionalità di ricerca.

Il selettore specificato deve essere aggiunto alle impostazioni del plugin e le modifiche devono essere salvate.

Ignorare gli elementi select

Alcuni elementi select in Redmine contengono già una funzionalità di ricerca integrata. Per evitare duplicazioni (due campi di ricerca in un unico campo), tali elementi devono essere ignorati.

Esempio:

#available_c

In questo caso:

Il plugin rileva l'elemento select #available_c.
Lo ignora.

Se l'elemento select non viene aggiunto all'elenco di quelli da ignorare, potrebbero apparire due elementi di ricerca contemporaneamente.

Utilizzo

Fare clic su una lista a discesa configurata (ad esempio, nella pagina degli issue, il select «Raggruppa risultati per»).
Una barra di ricerca apparirà nella parte superiore della lista.
Iniziare a digitare un nome o un titolo: la lista verrà filtrata automaticamente, mostrando solo le opzioni corrispondenti.