https://github.com/tobybatch/kimai-browser-plugin
https://github.com/tobybatch/kimai-browser-plugin
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tobybatch/kimai-browser-plugin
- Owner: tobybatch
- License: mit
- Created: 2021-05-03T20:05:16.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-09-02T10:28:14.000Z (over 2 years ago)
- Last Synced: 2025-01-15T02:39:09.378Z (4 months ago)
- Language: PHP
- Size: 837 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Kimai Browser Plugin
Log time directly to a Kimai instance directly from a browser extension.
## Installing
1. Copy the folder `BrowserPluginBundle` into the `var/plugin` folder in your Kimai instance.
1. Install the Chrome extension from your Kimai instance, `/en/kimai-browser-plugin`, use the link on the left hand side.
1. Set the location of your Kimai in the extension.
## What does it do?
The extension adds a button to Chrome. On clicking, it will open your Kimai instance in a browser popup. The browser extensions sends the current tab URL to your Kimai instance, and the plugin will try and parse that and pre-fill some fields in the create form.
### Currently supported
* Github - The plugin will try and separate out the project and issue number and tag those on the timesheet. The plugin will try and pre-fill the Customer, Project and Activity from previous timesheet entries.
## Tighten permissions
If you want to tighten permissions then edit the file `chrome_ext/public/manifest.json` and fine the line:
"*://*/*"
Change this to match the root of your Kimai installation:
"https://kimai.example.org/*"
And the rebuild the extension, re-install it from the link in Kimai.
## Rebuilding the Extension
Change directory into `chrome-ext`, install the deps (you'll need npm installed), then build and package the extension.
```bash
cd chrome_ext
npm install # <-- only needed the first time
npm run build
npm run package
npm run deploy
```