Files
stopwatch/README.md
T
Claude fe0933c132 Readable Start/Stop colours, exact selectors, fork notes
- Colour-coded Start/Stop links use #2e7d32 / #c62828, which meet the
  4.5:1 text contrast ratio on white and on the mobile backgrounds
  (limegreen was ~2:1, red ~4:1)
- Selectors match the end of the link address (/timer/start,
  /timer/stop), exactly what stopwatch.js rewrites, instead of any
  address containing "start"/"stop"
- highlighted_links setting uses a string key like default_activity,
  has a default, and the form sends 0 when unticked
- Context-menu hook uses the calling view (hook_caller) instead of
  building a new view context
- README: "Changes in this fork" section (GPLv3 modification notice)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BiwYMjhoQvL7XsKKfRz4pM
2026-10-28 23:54:19 -04:00

55 lines
2.5 KiB
Markdown

# Stopwatch Plugin for Redmine [![Test with Redmine](https://github.com/jkraemer/stopwatch/actions/workflows/redmine.yml/badge.svg)](https://github.com/jkraemer/stopwatch/actions/workflows/redmine.yml)
Minimal plugin that aims to make tracking your time with Redmine much easier.
## Features
- Adds a **Log time** menu item to the account menu (top right)
- That link leads to an overlay listing today's time entries, with a form that
allows editing existing or creating a new entry.
- Time entries can be started / stopped from the overlay as well as via their
context menu. There can only be one currently running entry, which will be
periodically updated with the time lapsed since it was started. Previously
running entry is stopped automatically when another is started.
- The hours:minutes of the currently *running* entry is highlighted in time
entry listings as well as shown next to the **Log time** menu item as well as
in the window title.
- Creating an entry with 0 minutes saves it in *running* state.
![Screenshot](https://github.com/jkraemer/stopwatch/raw/screenshots/img/screenshot.png)
## Changes in this fork
This is a fork of [jkraemer/stopwatch](https://github.com/jkraemer/stopwatch), modified by
Rick Barrette (2026):
- **Redmine 7:** requires Redmine 7.0+. The issue context-menu Start/Stop entry now uses Redmine 7's
`view_issues_context_menu_start` hook instead of patching `ContextMenusController` (July 2026).
- **Colour-coded Start/Stop:** an optional setting ("Color-code Start/Stop") shows the issue Start
link in green and Stop in red, with tinted buttons on mobile (March 2026; colours adjusted for
readable contrast in October 2026).
## Installation
Add the plugin to your Redmine installation's `plugins` folder, run `bundle
install` and restart Redmine. No database migrations necessary.
## License
Copyright (C) 2020 [Jens Krämer](https://jkraemer.net)
The Stopwatch plugin for Redmine is free software: you can redistribute
it and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
The Stopwatch plugin for Redmine is distributed in the hope that it
will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along with
the plugin. If not, see [www.gnu.org/licenses](https://www.gnu.org/licenses/).