README.md

Toggl Timer Developer Challenge of 2016

Here for the contest? Great! Just fork the Toggl Button project and off you go!

Don't know about the campaign? Here's our awesome info page with everything you need to know: https://toggl.com/toggl-developer-challenge

Not sure where to start? Check out this list of requested integrations: https://github.com/toggl/toggl-button/wiki/User-requested-buttons

Toggl Button Chrome extension

Add Toggl one-click time tracking to popular web tools.

Compatible services

• TeamWeek
• Pivotal tracker
• Github
• Asana
• Unfuddle
• Gitlab
• Trello
• Worksection
• Redbooth (old UI)
• Podio
• Basecamp
• JIRA (InCloud)
• Producteev
• Bitbucket
• Sifter
• Google Docs
• Redmine
• YouTrack (InCloud)
• CapsuleCRM
• Xero
• Zendesk
• Any.do
• Todoist
• Trac
• Wunderlist
• Toodledo
• Teamwork.com
• Google Mail
• Taiga
• HabitRPG
• Axosoft
• Countersoft Gemini
• Drupal
• Esa
• Help Scout
• Flow
• Sprintly
• Google Calendar
• TestRail
• Bugzilla
• Breeze
• BamBam
• GQueue
• Wrike
• Assembla
• Waffle
• Codeable
• Eventum
• Salesforce
• Draftin
• FogBugz

Installing from the Web Store

https://chrome.google.com/webstore/detail/toggl-button/oejgccbfbmkkpaidnkphaiaecficdnfn

Installing from Source

1. Clone the repository: git clone git://github.com/toggl/toggl-button
2. Navigate to chrome://extensions/ and enable "Developer Mode".
3. Choose "Load unpacked extension..."
4. Open the src directory in the toggl-button directory you just cloned and follow the prompts to install.

Change log

List of all the changes and added features can be found at http://toggl.github.io/toggl-button

Using the Button

1. Log in to your Toggl account and keep yourself logged in (no need to keep the tab open).
2. Go to your TeamWeek, Pivotal Tracker, Github, Asana, Unfuddle, Gitlab, Trello, Worksection, Redbooth, Podio, Basecamp, JIRA, Producteev, Bitbucket, Stifer, Google Docs, Redmine, YouTrack, CapsuleCRM, Xero, Zendesk, Any.do, Todoist, Trac, Wunderlist, Toodledo, Teamwork.com, Google Mail, Taiga, HabitRPG, Axosoft, Countersoft Gemini, Drupal, Esa, Help Scout, Flow, Sprintly, Google Calendar, TestRail, Bugzilla, Breeze, BamBam, GQueue, Wrike, Assembla, Waffle, Codeable, Eventum, Salesforce, Draftin, FogBugz account and start your Toggl timer there.

Or start entry from the extension icon menu

3. To edit the running time entry

• Edit entry details from the post start popup that is shown right after you click the "Start timer" button
• Edit entry details from the extesnion icon menu by clicking the running duration

4. To stop the current running timer:

• Press the button again
• Stop the entry from the extension icon menu
• Start another time entry inside your account.
• Go to Toggl to stop or edit your time entry.

Custom domains

If you use a setup, where one of the supported services is on a custom domain you can customize the extension to fit your needs. Here is a step by step guide on how to add custom domain to the extension.

Contributing

Want to contribute? Great! Just fork the project, make your changes and open a Pull Request

When adding new integrations please use git squash and merge all your commits into one commit. This keeps the git log more compact and clear.

Don't know how to start? Just check out the user requested services that have not yet been implemented, pick one and start hacking.