https://github.com/tobybatch/chromekimaibridge
Allows time to logged from ChromePlugin tickets into a Kimai instance
https://github.com/tobybatch/chromekimaibridge
kimai-bundle kimai-plugin kimai2
Last synced: 3 months ago
JSON representation
Allows time to logged from ChromePlugin tickets into a Kimai instance
- Host: GitHub
- URL: https://github.com/tobybatch/chromekimaibridge
- Owner: tobybatch
- License: mit
- Created: 2020-04-06T14:19:41.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-05T07:39:48.000Z (over 4 years ago)
- Last Synced: 2024-05-01T13:06:59.016Z (about 1 year ago)
- Topics: kimai-bundle, kimai-plugin, kimai2
- Language: PHP
- Homepage:
- Size: 1.94 MB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ChromePlugin to Kimai Bridge
This plugin allows time to logged from ChromePlugin tickets into a Kimai instance.
## Installation
### The plugin
Clone the repo into your plugins folder of a Kimai installation (it must be in a folder named ```ChromePluginBundle```:
cd /path/to/kimai
cd var/plugins
clone https://github.com/tobybatch/ChromeKimaiBridge.git ChromePluginBundle
Reload the plugins:
cd /path/to/kimai
./bin/console kimai:reload
### The chrome extension
Right now it's not in the chrome store, it will be, but for now there is a packed crx file in the var/plugins/ChromePluginBundle/Resources/ folder. Because the extension needs to access your Kimai instance it has to have the ```hosts: https://*/*``` permissions which google (quite correctly) finds very permissive and this holds up getting it into the store.
Get it [here](https://github.com/tobybatch/ChromeKimaiBridge/blob/master/Resources/chrome.crx).
## Set up
This will add a new icon to your chrome extensions. The first time you click it you will launch the options page. Here you must add a URL pointing to the web root of you Kimai server. Save the options and then you can use the extension.
## Linking to Trello/Github
Time can be logged directly against a project from a Github issue/project or Trello board.
1. Navigate to the Github issue/project or Trello board, and open any card.
1. Activate the extension, the white arrow in a green circle.
1. The pop up will say it cannot find a project associated with this board.
1. Copy the ID, e.g. ```tobybatch_ChromeKimaiBridge```
1. Log into Kimai as an admin and navigate to the project you want to associate with this project.
1. Edit the project, you will find a field call **External Board ID**
1. Enter the board id and save the project.
1. Return to the github issue/trello card and activate the extension.
1. Log time and view logged history.
The external board id accepts multiple board references in a comma seperated list.