Skip to content

Latest commit

 

History

History
147 lines (128 loc) · 5.66 KB

README.md

File metadata and controls

147 lines (128 loc) · 5.66 KB
Raw

Toggl Button for Custom Websites Chrome extension

Disclaimer: This is not the official "Toggl Button" extension, though it is based off of the original with permission from the Toggl team*.

All the convenience of the official "Toggl Button" extension, with the added benefit of custom websites.

Does your company use a private Trac installation for work requests? Or maybe you frequently report bugs for a niche website using their Redmine instance? Based on the popular "Toggl Button" Chrome extension, this modified version will allow you to integrate Toggl into any website you want, as long as it is running one of these supported services:

Compatible services

Installing from the Web Store

https://chrome.google.com/webstore/detail/toggl-button-for-custom-w/cblhgnnnpnonkonnfcfkfhhkoldjpdno

Installing from Source

  1. Clone the repository: git clone git://github.com/sfarbota/toggl-button-for-custom-websites
  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 in the CHANGES file.

Using the Button

  1. Log in to your Toggl account and keep yourself logged in (no need to keep the tab open).
  2. Add your custom website domains in the extension's Settings page.
  3. Go to 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, or a custom domain and start your Toggl timer there.
  4. To stop the current running timer:
  • press the button again
  • start another time entry inside your account.
  • go to Toggl to stop or edit your time entry.

Custom websites

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. This is where this unofficial version really shines. Just go to the extension's Settings page, check the option for "Custom websites", and add your custom domain to the list by clicking "+ Add new custom website" at the bottom of the list. You can also remove existing domains from the list if you do not use Toggl on those websites. Why waste precious time loading JavaScript you won't use?

Contributing

Want to contribute? Great!

If you'd like to make a change related to the custom websites feature, just fork this project, make your changes and open a Pull Request.

If you'd like to make a change related to another feature, you should fork the original "Toggl Button" repository, open a Pull Request there, and let me catch the changes downstream.

*Permission from the Toggl team to fork their extension can be viewed at: toggl#127 (comment).