项目

常规

个人资料

操作
历史记录

插件 » 插件列表 »

Redmine Collapse 插件

Collapse 是一个适用于 Redmine 的插件，它将默认的静态侧边栏转换为左侧的可折叠侧边栏，提供几个附加选项卡，其中包含项目和菜单链接。

作者

  • 邪恶的 Mischa

历史记录

Redmine Collapse 插件是 Sebastian Kurfürst 为Typo3-Forge 创建的可折叠侧边栏实现的 Redmine 插件移植。他已在他们使用的 Redmine 分支中以下修订版中实现了这个功能

这个实现依赖于核心破解和一些自定义 Typo3 Redmine 插件。它也没有对Default、Alternate和Classic主题产生好处。这让作者决定在一个单独且独立的 Redmine 插件中实现这个功能。

更新日志

要查看完整的变更日志，请参见 Redmine Collapse 插件目录中的CHANGELOG文件。

最新稳定发行版

该插件当前提供最新稳定发行版为 0.2.2。

特性

该插件提供以下特性
  • 更换 Redmine 核心侧边栏
    • 提供的侧边栏采用 JavaScript-helpers 进行折叠
    • 默认侧边栏内容在默认“操作”选项卡中
  • 第一个可选选项卡名为“项目”，为当前用户有角色的项目提供（嵌套）项目链接
    • 在 Redmine 0.8.0 中，项目链接指向项目概述
    • 在 Redmine 0.8.1 及更高版本中，项目链接指向选定项目中当前监控的菜单项（如果可用）
  • 核心项目的可选选择器下拉菜单可以隐藏
  • 第二个可选选项卡名为“菜单”，提供对所有全局（跨项目）视图和报表（遵循当前用户角色和权限）的链接
    • 可选地，默认项目菜单（默认水平置于标题下方）可以“移至”菜单选项卡
  • 使用的字符串可以翻译为所有语言（目前仅翻译为捷克语、荷兰语、英语、德语和斯洛伐克语，为其他语言提供英语存根）
  • 100% 兼容所有核心主题（Default、Alternate 和 Classic）以及当前支持和注册的社区主题（Basecamp 和 Squeejee）

需要说明一点：目前该插件会覆盖 Redmine 基本布局以实现所述特性。

屏幕截图

注意：以下屏幕截图取自该插件的 0.1.0 版本。它们尚未反映最新版本 (0.2.2) 的完整功能集。

全局视图；已折叠侧边栏 全局视图；已展开侧边栏，项目选项卡
Global view; Collapsed sidebar Global view; Un-collapsed sidebar, Projects-tab
项目视图；已展开侧边栏，项目选项卡 项目视图；已展开侧边栏，操作选项卡
Project view; Un-collapsed sidebar, Projects-tab Project view; Un-collapsed sidebar, Actions-tab
设置视图；显示项目选择器 设置视图；隐藏项目选择器
Settings view; Project-selector shown Settings view; Project-selector hidden

兼容性

以下兼容性信息仅适用于 Redmine Collapse 插件的 0.2.x 版本。

0.2.x Redmine 兼容性

该插件的 0.2.x 版本至少需要 Redmine 0.8.0，并且与 Redmine trunk 和 0.8-stable 分支兼容，如下表所示

Redmine 分支 修订版/发行版 测试 兼容 注释 支持
Trunk CURRENT 是 是 是
0.8-stable CURRENT 是 是 是
0.8-stable 0.8.4 是 是 是
0.8-stable 0.8.3 是 是 是
0.8-stable 0.8.2 是 是 是
0.8-stable 0.8.1 是 是 是
0.8-stable 0.8.0 是 是 是
0.7-stable 0.7.x 否 否 否

0.2.x 浏览器兼容性

该插件的 0.2.x 版本与主要浏览器引擎兼容（约 99%）。虽然在不同浏览器之间可能存在一些细微差别。在以下表中列出了一些已知问题

渲染引擎 浏览器 版本 测试 兼容 注释 支持
WebKit Google Chrome 2.0.172.30 是 是 是
Gecko Mozilla Firefox 3.0.10 是 是 是
Trident Microsoft Internet Explorer 7.x 是 否 IE7 缺少对 inherit 值（由 CSS 2.1 定义）的完整支持 可以，但是需要 解决办法
Trident Microsoft Internet Explorer 8.0.6001.18702 是 是 是
WebKit Apple Safari (Win32) 3.2.3 是 是 是
Presto Opera 9.64 是 是 是

获取

此插件可从以下打包发布版本下载

安装

  1. 从可用来源下载插件（参见 获取）
  2. 按照以下说明安装插件：https://redmine.ruby-lang.org.cn/wiki/redmine/Plugins（此插件不需要插件数据库迁移）
  3. 以管理员身份登录 Redmine
  4. 开始配置插件设置

配置

此插件可在管理 -> 插件 -> Redmine Collapse 插件 -> 配置中进行配置。它提供以下设置
  • 显示项目选项卡（默认：选中）
  • 隐藏核心项目选择器（默认：未选中）
  • 显示菜单选项卡（默认：未选中）
    • 在菜单选项卡中显示项目菜单（默认：未选中，仅在选中“显示菜单选项卡”时可配置）
  • 侧边栏位置（默认：左侧，尽管尚未实现此功能）

升级

  1. 从可用来源下载最新的归档文件（参见 获取）
  2. 备份当前部署的折叠插件（mv /vendor/plugins/redmine_collapse /vendor/plugins/redmine_collapse-backup）
  3. 将下载的文件解压缩到 Redmine 中的插件目录 "../vendor/plugins" 中
  4. 重新启动 Redmine

卸载

  1. 从插件目录 "../vendor/plugins" 中删除目录 "redmine_collapse"
  2. 重新启动 Redmine

确保没有插件资产保存在 "../public/plugin_assets/redmine_collapse" 中。

Internet Explorer 7 解决办法

由于 Microsoft Internet Explorer 7 不完全支持 inherit 值（由 CSS 2.1 定义），因此在使用 默认 或 经典 主题（或将不正确的 background-color 设置为 #main 的任何其他主题）时，需要手动修改 CSS 声明。您需要在 "../assets/stylesheets/collapse.css" 中更改以下代码段，硬编码 inherit 值所需的枚举值；

从

/***** Overloading Redmine Core layout-selectors *****/
#main {
    background-color: inherit; /* not in IE7 */
    padding: 2px 0px 0px 14px;
}

更改为

/***** Overloading Redmine Core layout-selectors *****/
#main {
    background-color: #FFFFFF; /* hard-code white (#FFFFFF) for IE7 with either the Default- or the Classic-theme */
    padding: 2px 0px 0px 14px;
}

任务

请注意，这些任务可能发生变化
  • 使可折叠侧边栏的位置可配置（左和右）
  • 重构插件以删除重写基础布局的要求

鸣谢

感谢以下人员的帮助

代码鸣谢

  • Eric Davis，Little Stream Software 公司（http://www.littlestreamsoftware.com）
    • 提供了 Redmine core 补丁的骨架（参见"../lib/collapse_application_helper_patch.rb"）
    • 在提升插件源代码的 Ruby 风格方面提供了很多帮助
  • Sebastian Kurfürst，Typo3 开发团队（http://www.typo3.org）
    • Redmine core 破解功能的设计者，用于为 Typo3-Forge 实现此功能，用作此插件的基础
  • Lalit Patel（http://www.lalit.org）
    • 提供了将数据存储为 JSON 字符串的 Javascript 代码片段（最初由 Sebastian 使用）

翻译鸣谢

许可

此插件是开源的，根据GNU 通用公共许可证 v2（GPL）进行授权。有关详细信息，请参阅 COPYRIGHT.txt 和 GPL.txt 文件。

支持

如果您需要帮助、想报告一个 bug 或请求一个新功能，可以使用以下方式联系
作者通过电子邮件（mischa_the_evil [AT] hotmail [DOT] com），或通过他的（即将上线的）网站：http://www.evil-dev.net。

作为替代方式，您还可以加入freenode IRC网络上的#redmine频道，查看作者是否在线（带有昵称Mischa_The_Evil）。

附加截图

由 Mischa The Evil 更新 大约 14 年前 · 14 次修订