-
Notifications
You must be signed in to change notification settings - Fork 6
Plugin description and instructions
This is a redmine plugin which adds some extensions to time tracking on issues, and is a modified version of the "redmine-timesheet-plugin" by Eric Davis. Particularly, this plugin works on two parts:
- permits to insert start time, end time and billed hours when logging time for an issue;
- shows the time entries via many criteria and exports them in CSV.
The first part is completely new and here's a screenshot:
TODO insert image link
The second part is the modified version of "redmine-timesheet-plugin", and here's a screenshot of the page:
TODO insert image link
The functional differences between this plugin and "redmine-timesheet-plugin" by Eric Davis are the following (referring to the screenshot):
- the 'Group by' select is renamed to 'Sort by' and controls how the results are sorted instead of how them are grouped: the sorting is per-<selected field> and then per-date for each request;
- there is a new period selector which allows to chose a period by year and, optionally, by month;
- there is a new group of fields 'Fields to include': these fields control the columns that are outputted (e.g. by selecting only 'User', 'Week of Year' and 'Hours' those will be the only three columns in output). Not only: by selecting the fields you 'group' the results by the fields selected except that for hours and billed hours, which are shown as sum of the grouped results. For example, if you select the three fields of before you will see that each row has a different 'User'-'Week of year' couple, and 'Hours' is the sum of the hours for each row with the same 'User'-'Week of year' couple before grouping (strictly speaking it makes a logical SQL GROUP BY on selected fields).
For installing the plugin you can follow redmine instructions for installing a plugin, or you can follow these simple steps:
- stop the redmine server;
- download a working copy from git://github.com/nicStuff/redmine_timesheet_extensions.git with
git clone git://github.com/nicStuff/redmine_timesheet_extensions.gitfrom a terminal; - rename the folder containing the plugin in 'redmine_timesheet_extensions';
- copy that folder in the path /vendor/plugins of your redmine installation;
- run the plugin migration (in the terminal, from the root directory of redmine installation, type
rake db:migrate_plugins). The migration only adds a column to the table 'time_entries' named 'billed_hours', which will store the billed hours: although the migration could break your database, that's a rare event and it shouldn't happen to you. Moreover second me it's better to make a dump just for staying relaxed, especially if the DB is a production DB; - then start the server and try it!
If you have some issues feel free to contact me on GitHub.
Although there are no incompatilities found, it is clear that you can't use this plugin with "redmine-timesheet-plugin" because these two add the same link on the left top and something could crash: so use one or another.
The switch between this plugin and Eric Davis plugin and viceversa is unpainful.
I hope that you find the plugin useful and I'm open to support for making it better. Finally, if you find some english errors, well, no one is perfect (but tell them to me) :)