Selectbox Autocompleter

描述

Selectbox Autocompleter 插件增强了 Redmine 标准下拉列表的功能，添加了内容快速搜索功能。它是处理包含大量 issues、用户、项目或其他实体列表的系统的理想解决方案。

主要功能：

智能搜索： 输入文本时即时过滤选项。
支持所有实体： 适用于用户列表（Assignee/Author）、Projects、Versions、Categories 以及类型为“List”的 Custom Fields。
改进的用户体验 (UX)： 无需无限滚动长列表。

兼容性

Redmine: 5.0 - 6.0

Web Browsers: Chrome, Firefox, Safari, Edge

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

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

安装与更新

如果存在，请从 Redmine 中删除旧版本的插件。
```
cd redmine/plugins
rm -r selectbox_autocompleter
```
将新的插件文件夹 selectbox_autocompleter 复制到 redmine/plugins/
停止并启动 Redmine。（在某些 Redmine 安装中（例如 Docker），重要的是实际停止并启动服务器，而不仅仅是重启。）

卸载

从 redmine/plugins/ 中删除插件文件夹 selectbox_autocompleter

rm -r selectbox_autocompleter

停止并启动 Redmine。

配置

在 Administration -> Modules -> Selectbox Autocompleter 中检查并修改插件设置。

Administration

模块部分 (Section "Modules")

在 Administration → Modules → Selectbox Autocompleter 中，您可以配置：

如果项目数超过 7 个且父容器 ID 匹配，则添加搜索字段。
需要替换 select 元素的容器选择器 (Selectors)。
需要忽略的选择器 (Selectors)。

为 select 元素添加搜索

插件的工作方式如下：

根据指定的 IDs 或 classes 查找 select 元素。
将找到的 select 元素替换为支持搜索的 select 字段。
仅对插件设置中明确指定的选择器有效。

示例：

如果需要为位于 issue 表单内的 select 元素添加搜索功能，可以使用表单容器的 ID：

#issue-form

在这种情况下：

插件会将搜索功能应用于 issue 表单内的所有 select 元素。
在创建和编辑 issue 页面上的所有下拉列表都将显示搜索功能。

必须将指定的选择器添加到插件设置中并保存更改。

忽略 select 元素

Redmine 中的某些 select 元素已经包含内置搜索功能。为了避免重复（一个字段中出现两个搜索框），必须忽略这些元素。

示例：

#available_c

在这种情况下：

插件会检测到 select 元素 #available_c。
它会忽略该元素。

如果不将 select 元素添加到忽略列表中，可能会同时显示两个搜索元素。

使用方法

点击已配置的下拉列表（例如：在 issues 页面上，“按...分组结果”的 select）。
列表顶部将出现一个搜索栏。
开始输入名称或标题 — 列表将自动过滤，仅显示匹配的选项。