Redmine

Adds a "pin" feature to Redmine's issue list: important issues can be pinned to the top of the list regardless of the user-chosen sort order. Similar to pinned posts on social platforms, this helps teams keep urgent or high-priority issues visible without manually reshuffling the list or changing due dates.

Features¶

• Pin / unpin from the issue list right-click context menu -- no modal dialog, no page reload (Ajax)
• 9 expiration presets: 30 min / 1 / 4 / 8 hour / 1 / 3 day / 1 week / 1 month / no expiration
• Pinned rows are highlighted with a customizable background color (separate colors for odd and even rows, configurable from the plugin settings page)
• A pin icon is displayed before the subject on both the issue list and the issue detail page
• Smart sort order among pinned issues: no-expiration pins first, then pins with longer remaining time
• Per-project activation via a project module ("Pin Issues")
• Role-based permission ("Pin issues")
• i18n: English, Japanese

Links¶

• README (English): README.md
• README (Japanese): README_ja.md

Detailed explanation (Japanese): https://note.com/taba_muichi/n/nfeaf50234003

Requirements¶

• Redmine 6.0 or later (also tested on 6.1). Redmine 5.x and earlier are not supported -- the plugin raises an error on load if the Redmine version is below 6.0.0.
• Ruby 3.2 / 3.3
• Rails 7.2
• PostgreSQL 16 (other databases may work but are not officially tested)

Install¶

1. Clone into the Redmine plugins directory:

cd /path/to/redmine/plugins
git clone https://github.com/seraph3000/redmine_pinned_issues.git

Run the database migration from the Redmine root:

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

Restart Redmine (Passenger example):

touch /path/to/redmine/tmp/restart.txt

Post-install setup¶

• Administration > Roles and permissions: grant the "Pin issues" permission to the roles that should be able to pin issues.
• Project settings > Modules: enable "Pin Issues" on each project where the feature should be available.
• (Optional) Administration > Plugins > Redmine Pinned Issues plugin > Configure: adjust the pinned-row background colors (odd / even).

Recommended cron (daily cleanup of expired pin records)¶

Expired pins are automatically excluded from the list and sort order, but the underlying DB records remain until cleaned up. A daily cleanup is recommended:

0 3 * * * cd /path/to/redmine && /usr/bin/flock -xn /tmp/redmine_pinned_issues_cleanup.lock -c 'RAILS_ENV=production bundle exec rake redmine:pinned_issues:cleanup'

Uninstall¶

bundle exec rake redmine:plugins:migrate NAME=redmine_pinned_issues VERSION=0 RAILS_ENV=production
rm -rf plugins/redmine_pinned_issues
touch /path/to/redmine/tmp/restart.txt