diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/README.md b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/README.md new file mode 100644 index 0000000000..265e6a8dc6 --- /dev/null +++ b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/README.md @@ -0,0 +1,65 @@ +--- +sidebar_navigation: + title: TimeCamp integration + priority: 797 +description: Time tracking with TimeCamp +keywords: time tracking, timecamp integration +--- + +# Time tracking with TimeCamp + +TimeCamp allows you to track your time spent on OpenProject work packages with a start/stop button. The times will then be recorded in your [TimeCamp account](https://app.timecamp.com/auth/login). + +## Installation + +You can install a browser add-in to track time via TimeCamp in OpenProject. This way, you can record time spent directly in a work package in OpenProject via a start/stop button. You need to register an account in TimeCamp in order to use this feature. + +This integration can be added for Google Chrome as [TimeCamp extension](https://chrome.google.com/webstore/detail/time-tracker-by-timecamp/ohbkdjmhoegleofcohdjagmcnkimfdaa). + +## Configuration + +1. Download the [TimeCamp Google Chrome plugin](https://chrome.google.com/webstore/detail/time-tracker-by-timecamp/ohbkdjmhoegleofcohdjagmcnkimfdaa). + + ![TimeCamp extension in Google Chrome shop](download-timecamp-extension.png) + +2. Add the extension. + + ![pop up to allow to add extension](add_extension.png) + +3. Pin TimeCamp to your browser. + + ![TimeCamp instructions how to pin the extension to the browser](pin-to-browser-full.png) + +## Using TimeCamp in OpenProject + +1. Create a [TimeCamp account](https://app.timecamp.com/auth/login) if you do not have one yet. + +2. In TimeCamp, add a new project and tasks to it if you have not got anything set up yet. + + ![TimeCamp account with a new project which shows 2 tasks](project-with-2-tasks.png) + + The time tracked in Openproject will later on appear in TimeCamp on the task that you select. + +3. [Log in to OpenProject](https://www.openproject.org/signin/), open a project and go to a work package. + + If you are already logged in, please make sure to log out and back in again so that the TimeCamp projects and tasks will appear in OpenProject. + + ![OpenProject work package detail view with green start button to start timer](work-package-start-timer.png) + + Only in the work package form you will see the green **TimeCamp Start timer** button. + +4. Click on **Start timer** and select a task from your TimeCamp projects that you would want to use for tracking your time. + + ![OpenProject work package detail view with drop down from start timer to select TimeCamp project and task](Start-time-in-OP.png) + +5. The timer button turns red, indicating that time is being recorded. + + ![OpenProject work package detail view with red timer button recording the time](stop-time-in-OP.png) + +6. Stop the timer by clicking on the red button indicating the time that has passed. + +## Time report + +Go to you TimeCamp account, to the Timesheet and your tracked time appears there. + +![TimeCamp Timesheet](Time-appears-in-TC.png) diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Start-time-in-OP.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Start-time-in-OP.png new file mode 100644 index 0000000000..abf90a546c Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Start-time-in-OP.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Time-appears-in-TC.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Time-appears-in-TC.png new file mode 100644 index 0000000000..bf39bca70d Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/Time-appears-in-TC.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/TimeCamp_Chrome_plugin.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/TimeCamp_Chrome_plugin.png new file mode 100644 index 0000000000..e508c32e84 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/TimeCamp_Chrome_plugin.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/add_extension.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/add_extension.png new file mode 100644 index 0000000000..f86852c8d5 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/add_extension.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-project-in-TimeCamp.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-project-in-TimeCamp.png new file mode 100644 index 0000000000..88cfc6bd1d Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-project-in-TimeCamp.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-task-in-TimeCamp.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-task-in-TimeCamp.png new file mode 100644 index 0000000000..c9180e07eb Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/create-task-in-TimeCamp.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/download-timecamp-extension.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/download-timecamp-extension.png new file mode 100644 index 0000000000..46c13dc315 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/download-timecamp-extension.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin-to-browser-full.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin-to-browser-full.png new file mode 100644 index 0000000000..83e252429f Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin-to-browser-full.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin_to_browser.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin_to_browser.png new file mode 100644 index 0000000000..4b0833ad1e Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/pin_to_browser.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks-in-timecamp.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks-in-timecamp.png new file mode 100644 index 0000000000..f7ba28bbd4 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks-in-timecamp.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks.png new file mode 100644 index 0000000000..d9f8d470c5 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/project-with-2-tasks.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task-2.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task-2.png new file mode 100644 index 0000000000..8d04c7688b Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task-2.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task.png new file mode 100644 index 0000000000..4217269cae Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/select-a-task.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/stop-time-in-OP.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/stop-time-in-OP.png new file mode 100644 index 0000000000..eaf2b3e339 Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/stop-time-in-OP.png differ diff --git a/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/work-package-start-timer.png b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/work-package-start-timer.png new file mode 100644 index 0000000000..35f1976afa Binary files /dev/null and b/docs/user-guide/time-and-costs/time-tracking/timecamp-integration/work-package-start-timer.png differ