From 445c5d8feb65621011f787d26fb60e9678c4f56b Mon Sep 17 00:00:00 2001 From: jurgenhaas <juergen@paragon-es.de> Date: Thu, 12 Nov 2015 18:07:58 +0100 Subject: [PATCH] Version 1.4 --- README.md | 39 ++++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 1a72724..506757b 100644 --- a/README.md +++ b/README.md @@ -9,27 +9,27 @@ To use it, just install it and get started. On every page with an identified iss How does this button know about your Toggl account? You should be logged into your Toggl account at least once from a different tab in the same browser and that allows the Toggl button to grab your API token from your account and that will be stored in a local file to be re-used for all subsequent API requests made to Toggl. -##Features## +## Features -###Simple Authentication### +### Simple Authentication It just happens in the background, you don't have to worry about it. The first time, you have to be logged in to your Toggl account and that allows the Toggl button to grab your API token and store that locally for the future. -###Start/Stop time entries### +### Start/Stop time entries On applicable pages you'll find the Toggl button somewhere in the header of the page where you can simply start a time entry by clicking on it. The button style changes to indicate that it is active and by clicking on it again, you will be stopping the time entry. -###Project selection### +### Project selection Next to the Toggl button you'll see a select box containing all your projects from Toggl and before starting a time entry you can select one of those projects to which the new time entry will be assigned. -###Remember project### +### Remember project Toggl button is clever about your project selections and remembers your previous selection. Not globally but within the context that you're operating in. E.g. if you're working on different projects on GitHub, Toggl button will remember different Toggl projects for each of your GitHub projects where you've used the button before. The method to determine the context depends on the platform where the button is used. So the context on Github is determined differently from the context on YouTrack. But all of that is open source, so you can just go ahead and look into th *[platform].user.js* files and see how it's been implemented. -###Caching data### +### Caching data When Toggl button connects to your Toggl account the first time, it collects all the data about your projects and stores that locally so that this data doesn't have to be collected every time. This is saving a lot of bandwidth and makes the whole process much faster. @@ -37,25 +37,25 @@ However, that could get you in a situation where your settings in your Toggl acc First of all, Toggl button is updating the cached data once every 6 hours in the background anyway. If you want to force that process to happen at any time you need it, just open the project select list and select the last item in the list named *Reload settings*. This will reload the current page and the data will be updated. -###Keep status across page reloads### +### Keep status across page reloads When you start a time entry the button changes style to indicate that there is a task running for the current page issue. This even works across page loads in the browser. To achieve that, Toggl button is asking your Toggl account if a task is currently running and if so, it compares that with the current page and if that's equal, it will change the button style as if it were just started by clicking on it. -###Set billable flag for time entries (Toggl Pro accounts only)### +### Set billable flag for time entries (Toggl Pro accounts only) If you have a Toggl Pro account, you can set a flag for each project if it's billable or not. This setting will be used by the Toggl button to set it equally to each time entry depending on the project you have selected for it. -###Show message when authentication fails### +### Show message when authentication fails If the Toggl button can't access your Toggl account, it will inform you about it by showing you a red line at the top of your browsers viewport and provide you with a link where you can login to your Toggl account easily. -##How to install## +## How to install On Firefox, you have to have Greasemonkey installed first. If you haven't got it installed yet, just go to [Mozilla Greasemonkey][11] and follow the instructions there. Once Greasemonkey is installed, you can either add user scripts from GitHub or through the Greasy Fork platform: -###How to install from GitHub### +### How to install from GitLab Just open one of the PLATFORM.user.js files and then click on "Raw". Your Firefox browser should tell you that you're opening a Greasemonkey user script and provides an option "Install" which you should then click. @@ -71,7 +71,7 @@ The direct links are: | TeamWork | [Install][307] | [Install][407] | | YouTrack | [Install][303] | [Install][403] | -###How to install from Greasy Fork### +### How to install from Greasy Fork Either go to [Greasy Fork][3] or click on the following platforms to install their respective Toggl button script: * [Drupal][101] @@ -84,13 +84,13 @@ Either go to [Greasy Fork][3] or click on the following platforms to install the If you want to use the scripts on other browsers, please follow the instruction [here][12]. -##How to update## +## How to update The Toggl button for Greasemonkey scripts have auto-update functionality included. By default, the system is checking once a week if a new version is available and downloads the latest ones automatically to your system. To manually force the update check, go to **Tools / Add-ons / User scripts** and in the options button on top of the scripts list you'll find an option **Check for updates**. -##How to configure## +## How to configure Normally, there is no configuration required, these buttons just work out of the box. @@ -100,7 +100,7 @@ However, you can adjust their scope by individually defining the list of domains * In the **User Settings** tab you can input any number of included and excluded domains * Click *OK* when you're done -##Useful links## +## Useful links * [Greasy Fork][17] * [User Scripts][14] @@ -120,16 +120,17 @@ However, you can adjust their scope by individually defining the list of domains * [TeamWork][207] * [YouTrack][203] -##Credits## +## Credits + +### Toggl -###Toggl### * [Best of bread online timetracking][10] is the basis for all of this and without their excellent product, neither a Toggl button would be possible nor required. -##Contributing## +## Contributing Want to contribute? Great! Just fork the project, make your changes and open a [Pull Request][2] -##Disclaimer## +## Disclaimer As the author of this set of scripts I do disclose that I am **in no way** associated with the company behind Toggl other than being a happy customer of their paid pro version. -- GitLab