├── .gitignore ├── favicon.png ├── notify15a.mp3 ├── screen1.png ├── screen2.png ├── screen3.png ├── notify30-60a.mp3 ├── freelance-timetracker.sketch ├── LICENSE ├── SECURITY.md ├── README.md ├── index.php └── timetracker.js /.gitignore: -------------------------------------------------------------------------------- 1 | 2 | timetracker.json 3 | -------------------------------------------------------------------------------- /favicon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/favicon.png -------------------------------------------------------------------------------- /notify15a.mp3: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/notify15a.mp3 -------------------------------------------------------------------------------- /screen1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/screen1.png -------------------------------------------------------------------------------- /screen2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/screen2.png -------------------------------------------------------------------------------- /screen3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/screen3.png -------------------------------------------------------------------------------- /notify30-60a.mp3: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/notify30-60a.mp3 -------------------------------------------------------------------------------- /freelance-timetracker.sketch: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/luckyshot/freelance-timetracker/HEAD/freelance-timetracker.sketch -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | The MIT License (MIT) 2 | 3 | Copyright (c) 2015 Xavi Esteve (xaviesteve.com) 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /SECURITY.md: -------------------------------------------------------------------------------- 1 | # Security Policies and Procedures 2 | 3 | This document outlines security procedures and general policies for the 4 | project. 5 | 6 | * [Reporting a Vulnerability](#reporting-a-vulnerability) 7 | * [Disclosure Policy](#disclosure-policy) 8 | 9 | ## Reporting a Vulnerability 10 | 11 | The team and community take all security vulnerabilities seriously. Thank 12 | you for improving the security of our open source software. We appreciate 13 | your efforts and responsible disclosure and will make every effort to 14 | acknowledge your contributions. 15 | 16 | Report security vulnerabilities by emailing the team at: 17 | 18 | security at xaviesteve.com 19 | 20 | The lead maintainer will acknowledge your email within 24-72 hours. 21 | After the initial reply to your report, the team will endeavor to keep 22 | you informed of the progress towards a fix and full announcement, 23 | and may ask for additional information or guidance. 24 | 25 | Report security vulnerabilities in third-party modules to the person or 26 | team maintaining the module. 27 | 28 | ## Disclosure Policy 29 | 30 | When the security team receives a security bug report, they will assign it 31 | to a primary handler. This person will coordinate the fix and release 32 | process, involving the following steps: 33 | 34 | * Confirm the problem and determine the affected versions. 35 | * Audit code to find any potential similar problems. 36 | * Prepare fixes for all releases still under maintenance. These fixes 37 | will be released as fast as possible to the repository. 38 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## Freelance Timetracker 2 | 3 | 4 | ![Screen](https://raw.githubusercontent.com/renat2985/freelance-timetracker/master/screen3.png) 5 | 6 | 7 | Freelance Timetracker is a free and super-simple web-based timetracking system. All the information is stored in a JSON file so no database is needed. 8 | 9 | 10 | ### 10 second Setup 11 | 12 | 1. Copy the files to your web server 13 | 2. You are done! 14 | 15 | #### Quick notes 16 | 17 | Make sure PHP can create/edit files in that path. You should use Freelance Timetracker locally since there is no password protection, everyone could access it and play around with it. Also, make sure not to open several tabs of it since you may overwrite the database. No configuration is necessary although you can customize some things such as saving interval, default rate, currency, database extension and a few other things. 18 | 19 | 20 | ### How to use 21 | 22 | Click the checkbox to start timing a task, edit any fields by clicking on them. 23 | 24 | 25 | ### Contents 26 | 27 | The code is just one PHP, CSS, JS and JSON file. 28 | 29 | 30 | ### How it works 31 | 32 | - Tailwindcss gives it styling 33 | - jQuery/AJAX sends the information to the back-end (every 10 seconds by default) 34 | - PHP stores everything in a JSON file 35 | 36 | This setup makes it extremely easy to install Freelance Timetracker with just a copy-paste and start using straight away. It also makes backing up your stuff super-easy. 37 | 38 | 39 | ### License 40 | 41 | Freelance Timetracker is authored by [Xavi Esteve](https://xaviesteve.com/) and [Renats K.](http://www.myworld.lv/), and it is licensed under a MIT License. 42 | 43 | Feel free to fork it and send any pull requests. 44 | -------------------------------------------------------------------------------- /index.php: -------------------------------------------------------------------------------- 1 | 20, // default rate per hour 25 | 'currency' => '€', 26 | 'filename' => 'timetracker', // name of the database 27 | 'tasksno' => 5, // TODO: Number of tasks to show 28 | 'saveinterval' => 10 // save every N seconds 29 | ); 30 | 31 | /** 32 | * Save database 33 | */ 34 | if (isset($_GET['action'])) { 35 | if ($_GET['action'] == 'save' && (strlen($_POST['json']) > 2)) { 36 | $filename = $settings['filename'].".json"; 37 | $filehandle = fopen($filename, 'w') or die("Error: Can't create or save files, please modify folder permissions"); 38 | $fwrite = fwrite($filehandle, stripslashes($_POST['json'])); 39 | fclose($filehandle); 40 | echo $fwrite; 41 | die(); 42 | } 43 | } 44 | 45 | /** 46 | * Read database 47 | */ 48 | $data = ''; 49 | if (file_exists($settings['filename'].".json")) { 50 | $data = file_get_contents($settings['filename'].".json"); 51 | } 52 | 53 | // If no database then generate a blank one 54 | if (strlen($data) < 3) { 55 | $data = '{'; 56 | for ($i = 0; $i < $settings['tasksno']; $i++) { 57 | $data .= '"'.$i.'":{"date":"","client":"","task":"","rate":'.$settings['rate'].',"total":0,"desc":"","timed":0}'; 58 | if ($i < $settings['tasksno']-1) { 59 | $data .= ','; 60 | } 61 | } 62 | $data .= '}'; 63 | } 64 | 65 | /** 66 | * HTML 67 | */ 68 | ?> 69 | 70 | 71 | 72 | 73 | Freelance Timetracker 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
93 | 94 |
95 |

96 |

97 |
98 |
99 |

Time tracker for freelancer

100 |

Click the checkbox to start timing a task, edit any fields by clicking on them.

101 |
102 |
103 | 104 |
105 |
106 |
107 |
108 | 0 min. 109 |
110 |
111 | 30 min. 112 |
113 |
114 | 60 min. 115 |
116 |
117 |
118 |
119 |
120 |
121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 |
DateProjectTaskRateTotalNoteTime
138 |
139 |
140 |
141 |
142 |
143 |
144 | 145 |
146 |
147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 |
157 |
158 | 181 | 182 | 183 | 208 | 209 | 210 | 211 | 212 | -------------------------------------------------------------------------------- /timetracker.js: -------------------------------------------------------------------------------- 1 | $(document).ready(function() { 2 | 3 | t.run = function() { 4 | $("#table input[type=checkbox]").each(function(index) { 5 | var tr = $(this).closest('tr'); 6 | 7 | if ($(this).is(":checked")) { 8 | var total = tr.find('.total'), 9 | rate = tr.find('.rate'), 10 | timed = tr.find('.timed'); 11 | 12 | total.data('value', total.data('value') + (rate.val()/3600)); 13 | total.val(t.config.currency+total.data('value').toFixed(2)); 14 | timed.data('value', parseInt(timed.data('value')) + 1); 15 | timed.val(t.niceTime(timed.data('value'))); 16 | 17 | var time_array = t.niceTime(timed.data('value')).split(':'); 18 | 19 | $("#big-time").html(time_array[0]+':'+time_array[1]); 20 | $("#big-total").html(t.config.currency+total.data('value').toFixed(2)); 21 | $("#client-title").html(tr.find('.client').val()); 22 | $("#client-task").html(tr.find('.task').val()+' '+tr.find('.desc').val()+''); 23 | 24 | 25 | 26 | 27 | tr.addClass("shadow-2xl"); 28 | tr.removeClass("opacity-25"); 29 | 30 | 31 | nanobar.go(100*time_array[1]/60); 32 | 33 | if ((time_array[1] == '00' || time_array[1] == '30') && time_array[2] == '00') { 34 | $("#notify").attr("src", "notify30-60a.mp3"); 35 | document.getElementById("notify").play(); 36 | } 37 | if ((time_array[1] == '15' || time_array[1] == '45') && time_array[2] == '00') { 38 | $("#notify").attr("src", "notify15a.mp3"); 39 | document.getElementById("notify").play(); 40 | } 41 | 42 | tr.addClass('success'); 43 | } else { 44 | tr.removeClass('success'); 45 | tr.removeClass("shadow-2xl"); 46 | } 47 | }); 48 | 49 | // Update title and save countdown 50 | if ($('.timer:checked').length > 0) { 51 | document.title = '('+$('.timer:checked').length+') Timetracker'; 52 | t.config.savenext = t.config.savenext - 1000; 53 | } else { 54 | document.title = 'Timetracker'; 55 | } 56 | // Saving time? 57 | if (t.config.savenext <= 0) { 58 | t.config.savenext = t.config.savedefault; 59 | t.save(); 60 | } 61 | 62 | }; 63 | 64 | t.save = function() { 65 | 66 | var data = {}; 67 | 68 | $("#table tr.taskrow").each(function(index) { 69 | var tr = $(this); 70 | var row = { 71 | timer: tr.find('.timer').checked, 72 | date: tr.find('.date').val(), 73 | client: tr.find('.client').val(), 74 | task: tr.find('.task').val(), 75 | rate: tr.find('.rate').val(), 76 | total: tr.find('.total').data('value'), 77 | desc: tr.find('.desc').val(), 78 | timed: tr.find('.timed').data('value') 79 | }; 80 | data[tr.data('id')] = row; 81 | }); 82 | 83 | 84 | var jsondata = JSON.stringify(data); 85 | 86 | $.ajax({ 87 | type: "POST", 88 | url: "?action=save", 89 | data: { 90 | json: jsondata 91 | } 92 | }) 93 | .done(function(msg) { 94 | console.log(msg); 95 | }); 96 | 97 | }; 98 | 99 | t.load = function() { 100 | jsondata = t.config.initialdata; 101 | data = JSON.parse(jsondata); 102 | 103 | $('#table tbody').html(''); 104 | var buffer = ''; 105 | //console.log(data); 106 | for (var key in data) { 107 | var obj = data[key]; 108 | buffer += 109 | '' + 110 | '' + 111 | '' + 112 | '' + 113 | '' + 114 | '' + 115 | '' + 116 | '' + 117 | '' + 118 | '' + 119 | '' + 120 | ''; 121 | }; 122 | //console.log(buffer); 123 | $('#table tbody').html(buffer); 124 | 125 | }; 126 | 127 | t.niceTime = function(s) { 128 | if (!s) { 129 | s = 0; 130 | } 131 | hours = parseInt(s / 3600) % 24; 132 | minutes = parseInt(s / 60) % 60; 133 | seconds = s % 60; 134 | return (hours < 10 ? "0" + hours: hours) + ":" + (minutes < 10 ? "0" + minutes: minutes) + ":" + (seconds < 10 ? "0" + seconds.toFixed(0): seconds.toFixed(0)); 135 | }; 136 | 137 | t.generateColor = function(string) { 138 | string += 'makeitlongerjustincase'; 139 | var hash = '', 140 | curchar; 141 | for (var i = 0; i < string.length; i++) { 142 | curchar = (string.toLowerCase().charCodeAt(i)-97) /25*255; 143 | curchar = parseInt(curchar.toFixed(0), 10).toString(16); 144 | hash += curchar; 145 | } 146 | return '#'+hash.substr(0, 6); 147 | }; 148 | 149 | 150 | /** 151 | * Events 152 | */ 153 | 154 | $('#save').on('click', function() { 155 | t.config.savenext = 0; 156 | }); 157 | 158 | $('button.delete').live('click', function() { 159 | if (confirm('Are you sure you want to delete this task?')) { 160 | var tr = $(this).closest('tr'); 161 | tr.find('.task').val(''); 162 | tr.find('.client').val(''); 163 | tr.find('.total').data('value', 0); 164 | tr.find('.total').val(t.config.currency+'0.00'); 165 | tr.find('.rate').val(t.config.rate); 166 | tr.find('.desc').val(''); 167 | tr.find('.timed').data('value', 0); 168 | tr.find('.timed').val('00:00:00'); 169 | } 170 | t.config.savenext = 0; 171 | tr.addClass("opacity-25"); 172 | }); 173 | 174 | // Update time manually 175 | $(document.body).on('keyup', 'input.timed', function() { 176 | var secs = $(this).val().split(':'); 177 | $(this).data('value', parseInt(secs[0])*3600+parseInt(secs[1])*60+parseInt(secs[2])); 178 | t.config.savenext = 0; 179 | }); 180 | 181 | // Update total manually 182 | $(document.body).on('keyup', 'input.total', function() { 183 | $(this).data('value', parseFloat($(this).val().replace(/[^0-9\.]/g, ''))); 184 | t.config.savenext = 0; 185 | }); 186 | 187 | // Change color of Client 188 | $(document.body).on('input paste', 'input.client', function() { 189 | $(this).css('color', t.generateColor($(this).val())); 190 | t.config.savenext = 0; 191 | }); 192 | 193 | // Trigger saving when editing other fields too 194 | $(document.body).on('keyup', 'input.date,input.task,input.rate,input.desc', function() { 195 | t.config.savenext = 0; 196 | }); 197 | 198 | setInterval(function() { 199 | t.run(); 200 | }, 1000); 201 | 202 | t.load(); 203 | 204 | }); 205 | 206 | 207 | 208 | 209 | const allElements = document.querySelectorAll('*:not([theme-button]):not([class*="gray"])'); 210 | const themeButtons = document.querySelectorAll('[theme-button]'); 211 | const escapeRegExp = string => string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"); 212 | const replaceAll = (str, term, replacement) => str.replace(new RegExp(escapeRegExp(term), 'g'), replacement); 213 | 214 | let currTheme = 'indigo'; 215 | 216 | const changeTheme = theme => { 217 | allElements.forEach(element => { 218 | if (element.getAttribute('class') !== null) { 219 | const newClasses = replaceAll(element.getAttribute('class'), currTheme, theme); 220 | element.setAttribute('class', newClasses); 221 | } 222 | }); 223 | currTheme = theme; 224 | }; 225 | 226 | themeButtons.forEach(button => { 227 | button.addEventListener('click', e => { 228 | changeTheme(e.target.getAttribute('theme-button')); 229 | localStorage.setItem('theme', e.target.getAttribute('theme-button')); 230 | }); 231 | }); 232 | 233 | 234 | 235 | 236 | if (localStorage.getItem('theme')) { 237 | changeTheme(localStorage.getItem('theme')); 238 | } 239 | --------------------------------------------------------------------------------