Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juangesino/toggl-bill
A Toggle extension that keeps track of billing and payments.
https://github.com/juangesino/toggl-bill
billing meteor meteorjs productivity time-tracker toggl
Last synced: 1 day ago
JSON representation
A Toggle extension that keeps track of billing and payments.
- Host: GitHub
- URL: https://github.com/juangesino/toggl-bill
- Owner: juangesino
- License: mit
- Created: 2018-08-11T20:24:40.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-08-18T07:31:59.000Z (over 6 years ago)
- Last Synced: 2025-01-22T19:06:56.708Z (1 day ago)
- Topics: billing, meteor, meteorjs, productivity, time-tracker, toggl
- Language: JavaScript
- Homepage:
- Size: 3.58 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
TogglBill
Supercharge ™
![TogglBill Mockup](resources/mockup.jpg)
Generated with: Unsplash
## About
TogglBill is a platform extension for [Toggl](https://toggl.com/) that keeps track of billing and payments.
![Zappier Logo](https://cdn.zapier.com/static/beaad4e8b618d9ee86232c81dfd965a7d03f6c6f/images/frontend/onboarding/zapier-small-orange-logo.png)
----To configure TogglBill to receive your tasks from Toggl, you will need to set a [Zapier](https://zapier.com/) rule.
1. Go to [Zapier](https://zapier.com/) and create a new Zap.
2. Use 'New Time Entry' from Toggl for the trigger.![Zapier Configuration Toggl](resources/screenshots/screen-zapier-toggl.png)
3. Connect your account, select a workspace, and pull a sample.
4. Use Zapier's 'Webhook Action' for the action.
5. Select the option to fire a POST request.![Zapier Configuration Webhooks](resources/screenshots/screen-zapier-hooks.png)
6. Use the following fields:
**URL**:
Use `/api/entries`
If you delpoyed TogglBill in https://cool-app.herokuapp.com, the URL to use would be: https://cool-app.herokuapp.com/api/entries
**Payload Type**:
Use the `Json` payload.
**Data**:
The value on the left is the value you should use as key (without the colon `:`). The values on the right are the names of the Toggl variables to use.
```
totalHours: Duration Hours
externalProjectId: Project ID
endDate: Stop
startDate: Start
projectName: Project Name
totalMinutes: Duration Minutes
externalEntryId: ID
externalClientId: Project Client ID
duration: Duration
clientName: Project Client Name
```![Zapier Configuration Data](resources/screenshots/screen-zapier-data.png)
7. Submit your Zap, test it, give it a name, and activate it.
## Setup
1. **Install Meteor**
On Linux & Mac:
```sh
> curl https://install.meteor.com/ | sh
```This will setup [Meteor](http://github.com/meteor/meteor) (including [Node](https://github.com/nodejs/node) and [Mongo](https://github.com/mongodb/mongo) if necessary).
> _Note:_ Windows users must [download installer](https://www.meteor.com/install).
2. **Clone Repository**
```sh
> git clone https://github.com/juangesino/toggl-bill.git
> cd toggl-bill
```3. **Install Dependencies**
If you have npm installed:
```sh
> npm install
```If you only have meteor:
```sh
> meteor npm install
```4. **Run**
While in repository directory run:
```sh
> meteor run
```Load browser and go to [http://localhost:3000/](http://localhost:3000/)
## Deploy
### Heroku
Follow these steps to deploy the Meteor app on Heroku.
## Contributing
1. Fork it ( https://github.com/juangesino/toggl-bill/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request## License
See [MIT-LICENSE](https://github.com/juangesino/toggl-bill/blob/master/LICENSE.md).