2 // +----------------------------------------------------------------------+
3 // | Anuko Time Tracker
4 // +----------------------------------------------------------------------+
5 // | Copyright (c) Anuko International Ltd. (https://www.anuko.com)
6 // +----------------------------------------------------------------------+
7 // | LIBERAL FREEWARE LICENSE: This source code document may be used
8 // | by anyone for any purpose, and freely redistributed alone or in
9 // | combination with other software, provided that the license is obeyed.
11 // | There are only two ways to violate the license:
13 // | 1. To redistribute this code in source form, with the copyright
14 // | notice or license removed or altered. (Distributing in compiled
15 // | forms without embedded copyright notices is permitted).
17 // | 2. To redistribute modified versions of this code in *any* form
18 // | that bears insufficient indications that the modifications are
19 // | not the work of the original author(s).
21 // | This license applies to this document only, not any other software
22 // | that it may be combined with.
24 // +----------------------------------------------------------------------+
26 // | https://www.anuko.com/time_tracker/credits.htm
27 // +----------------------------------------------------------------------+
29 require_once('initialize.php');
31 import('ttUserHelper');
32 import('ttTeamHelper');
33 import('ttClientHelper');
34 import('ttTimeHelper');
35 import('DateAndTime');
38 if (!ttAccessCheck(right_data_entry)) {
39 header('Location: access_denied.php');
43 // Use custom fields plugin if it is enabled.
44 if ($user->isPluginEnabled('cf')) {
45 require_once('plugins/CustomFields.class.php');
46 $custom_fields = new CustomFields($user->team_id);
47 $smarty->assign('custom_fields', $custom_fields);
50 $cl_id = $request->getParameter('id');
52 // Get the time record we are editing.
53 $time_rec = ttTimeHelper::getRecord($cl_id, $user->getActiveUser());
55 // Prohibit editing invoiced records.
56 if ($time_rec['invoice_id']) die($i18n->getKey('error.sys'));
58 $item_date = new DateAndTime(DB_DATEFORMAT, $time_rec['date']);
60 // Initialize variables.
61 $cl_start = $cl_finish = $cl_duration = $cl_date = $cl_note = $cl_project = $cl_task = $cl_billable = null;
62 if ($request->isPost()) {
63 $cl_start = trim($request->getParameter('start'));
64 $cl_finish = trim($request->getParameter('finish'));
65 $cl_duration = trim($request->getParameter('duration'));
66 $cl_date = $request->getParameter('date');
67 $cl_note = trim($request->getParameter('note'));
68 $cl_cf_1 = trim($request->getParameter('cf_1'));
69 $cl_client = $request->getParameter('client');
70 $cl_project = $request->getParameter('project');
71 $cl_task = $request->getParameter('task');
73 if ($user->isPluginEnabled('iv'))
74 $cl_billable = $request->getParameter('billable');
75 if ($user->isPluginEnabled('ps'))
76 $cl_paid = $request->getParameter('paid');
78 $cl_client = $time_rec['client_id'];
79 $cl_project = $time_rec['project_id'];
80 $cl_task = $time_rec['task_id'];
81 $cl_start = $time_rec['start'];
82 $cl_finish = $time_rec['finish'];
83 $cl_duration = $time_rec['duration'];
84 $cl_date = $item_date->toString($user->date_format);
85 $cl_note = $time_rec['comment'];
87 // If we have custom fields - obtain values for them.
89 // Get custom field value for time record.
90 $fields = $custom_fields->get($time_rec['id']);
91 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
92 $cl_cf_1 = $fields[0]['value'];
93 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
94 $cl_cf_1 = $fields[0]['option_id'];
97 $cl_billable = $time_rec['billable'];
98 $cl_paid = $time_rec['paid'];
100 // Add an info message to the form if we are editing an uncompleted record.
101 if (strlen($cl_start) > 0 && $cl_start == $cl_finish && $cl_duration == '0:00') {
104 $msg->add($i18n->getKey('form.time_edit.uncompleted'));
108 // Initialize elements of 'timeRecordForm'.
109 $form = new Form('timeRecordForm');
111 // Dropdown for clients in MODE_TIME. Use all active clients.
112 if (MODE_TIME == $user->tracking_mode && $user->isPluginEnabled('cl')) {
113 $active_clients = ttTeamHelper::getActiveClients($user->team_id, true);
114 $form->addInput(array('type'=>'combobox',
115 'onchange'=>'fillProjectDropdown(this.value);',
117 'style'=>'width: 250px;',
119 'data'=>$active_clients,
120 'datakeys'=>array('id', 'name'),
121 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
122 // Note: in other modes the client list is filtered to relevant clients only. See below.
125 if (MODE_PROJECTS == $user->tracking_mode || MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
126 // Dropdown for projects assigned to user.
127 $project_list = $user->getAssignedProjects();
128 $form->addInput(array('type'=>'combobox',
129 'onchange'=>'fillTaskDropdown(this.value);',
131 'style'=>'width: 250px;',
132 'value'=>$cl_project,
133 'data'=>$project_list,
134 'datakeys'=>array('id','name'),
135 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
137 // Dropdown for clients if the clients plugin is enabled.
138 if ($user->isPluginEnabled('cl')) {
139 $active_clients = ttTeamHelper::getActiveClients($user->team_id, true);
140 // We need an array of assigned project ids to do some trimming.
141 foreach($project_list as $project)
142 $projects_assigned_to_user[] = $project['id'];
144 // Build a client list out of active clients. Use only clients that are relevant to user.
145 // Also trim their associated project list to only assigned projects (to user).
146 foreach($active_clients as $client) {
147 $projects_assigned_to_client = explode(',', $client['projects']);
148 if (is_array($projects_assigned_to_client) && is_array($projects_assigned_to_user))
149 $intersection = array_intersect($projects_assigned_to_client, $projects_assigned_to_user);
151 $client['projects'] = implode(',', $intersection);
152 $client_list[] = $client;
155 $form->addInput(array('type'=>'combobox',
156 'onchange'=>'fillProjectDropdown(this.value);',
158 'style'=>'width: 250px;',
160 'data'=>$client_list,
161 'datakeys'=>array('id', 'name'),
162 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
166 if (MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
167 $task_list = ttTeamHelper::getActiveTasks($user->team_id);
168 $form->addInput(array('type'=>'combobox',
170 'style'=>'width: 250px;',
173 'datakeys'=>array('id','name'),
174 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
177 // Add other controls.
178 if ((TYPE_START_FINISH == $user->record_type) || (TYPE_ALL == $user->record_type)) {
179 $form->addInput(array('type'=>'text','name'=>'start','value'=>$cl_start,'onchange'=>"formDisable('start');"));
180 $form->addInput(array('type'=>'text','name'=>'finish','value'=>$cl_finish,'onchange'=>"formDisable('finish');"));
181 if ($user->punch_mode) {
182 // Make the start and finish fields read-only.
183 $form->getElement('start')->setEnabled(false);
184 $form->getElement('finish')->setEnabled(false);
187 if ((TYPE_DURATION == $user->record_type) || (TYPE_ALL == $user->record_type))
188 $form->addInput(array('type'=>'text','name'=>'duration','value'=>$cl_duration,'onchange'=>"formDisable('duration');"));
189 $form->addInput(array('type'=>'datefield','name'=>'date','maxlength'=>'20','value'=>$cl_date));
190 $form->addInput(array('type'=>'textarea','name'=>'note','style'=>'width: 250px; height: 200px;','value'=>$cl_note));
191 // If we have custom fields - add controls for them.
192 if ($custom_fields && $custom_fields->fields[0]) {
193 // Only one custom field is supported at this time.
194 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT) {
195 $form->addInput(array('type'=>'text','name'=>'cf_1','value'=>$cl_cf_1));
196 } elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN) {
197 $form->addInput(array('type'=>'combobox',
199 'style'=>'width: 250px;',
201 'data'=>$custom_fields->options,
202 'empty' => array('' => $i18n->getKey('dropdown.select'))));
205 // Hidden control for record id.
206 $form->addInput(array('type'=>'hidden','name'=>'id','value'=>$cl_id));
207 if ($user->isPluginEnabled('iv'))
208 $form->addInput(array('type'=>'checkbox','name'=>'billable','value'=>$cl_billable));
209 if ($user->canManageTeam() && $user->isPluginEnabled('ps'))
210 $form->addInput(array('type'=>'checkbox','name'=>'paid','value'=>$cl_paid));
211 $form->addInput(array('type'=>'hidden','name'=>'browser_today','value'=>'')); // User current date, which gets filled in on btn_save or btn_copy click.
212 $form->addInput(array('type'=>'submit','name'=>'btn_save','onclick'=>'browser_today.value=get_date()','value'=>$i18n->getKey('button.save')));
213 $form->addInput(array('type'=>'submit','name'=>'btn_copy','onclick'=>'browser_today.value=get_date()','value'=>$i18n->getKey('button.copy')));
214 $form->addInput(array('type'=>'submit','name'=>'btn_delete','value'=>$i18n->getKey('label.delete')));
216 if ($request->isPost()) {
218 // Validate user input.
219 if ($user->isPluginEnabled('cl') && $user->isPluginEnabled('cm') && !$cl_client)
220 $err->add($i18n->getKey('error.client'));
221 if ($custom_fields) {
222 if (!ttValidString($cl_cf_1, !$custom_fields->fields[0]['required'])) $err->add($i18n->getKey('error.field'), $custom_fields->fields[0]['label']);
224 if (MODE_PROJECTS == $user->tracking_mode || MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
225 if (!$cl_project) $err->add($i18n->getKey('error.project'));
227 if (MODE_PROJECTS_AND_TASKS == $user->tracking_mode && $user->task_required) {
228 if (!$cl_task) $err->add($i18n->getKey('error.task'));
231 if ('0' == $cl_duration)
232 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.duration'));
233 elseif ($cl_start || $cl_finish) {
234 if (!ttTimeHelper::isValidTime($cl_start))
235 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.start'));
237 if (!ttTimeHelper::isValidTime($cl_finish))
238 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.finish'));
239 if (!ttTimeHelper::isValidInterval($cl_start, $cl_finish))
240 $err->add($i18n->getKey('error.interval'), $i18n->getKey('label.finish'), $i18n->getKey('label.start'));
243 if ((TYPE_START_FINISH == $user->record_type) || (TYPE_ALL == $user->record_type)) {
244 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.start'));
245 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.finish'));
247 if ((TYPE_DURATION == $user->record_type) || (TYPE_ALL == $user->record_type))
248 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.duration'));
251 if (false === ttTimeHelper::postedDurationToMinutes($cl_duration))
252 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.duration'));
254 if (!ttValidDate($cl_date)) $err->add($i18n->getKey('error.field'), $i18n->getKey('label.date'));
255 if (!ttValidString($cl_note, true)) $err->add($i18n->getKey('error.field'), $i18n->getKey('label.note'));
256 // Finished validating user input.
258 // This is a new date for the time record.
259 $new_date = new DateAndTime($user->date_format, $cl_date);
261 // Prohibit creating entries in future.
262 if (!$user->future_entries) {
263 $browser_today = new DateAndTime(DB_DATEFORMAT, $request->getParameter('browser_today', null));
264 if ($new_date->after($browser_today))
265 $err->add($i18n->getKey('error.future_date'));
269 if ($request->getParameter('btn_save')) {
271 // 1) Prohibit saving locked time entries in any form.
272 // 2) Prohibit saving completed unlocked entries into locked interval.
273 // 3) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
275 // Now, step by step.
277 // 1) Prohibit saving locked entries in any form.
278 if ($user->isDateLocked($item_date))
279 $err->add($i18n->getKey('error.range_locked'));
281 // 2) Prohibit saving completed unlocked entries into locked range.
282 if ($err->no() && $user->isDateLocked($new_date))
283 $err->add($i18n->getKey('error.range_locked'));
285 // 3) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
286 $uncompleted = ($cl_finish == '' && $cl_duration == '');
288 $not_completed_rec = ttTimeHelper::getUncompleted($user->getActiveUser());
289 if ($not_completed_rec && ($time_rec['id'] <> $not_completed_rec['id'])) {
290 // We have another not completed record.
291 $err->add($i18n->getKey('error.uncompleted_exists')." <a href = 'time_edit.php?id=".$not_completed_rec['id']."'>".$i18n->getKey('error.goto_uncompleted')."</a>");
296 // Prohibit creating an overlapping record.
298 if (ttTimeHelper::overlaps($user->getActiveUser(), $new_date->toString(DB_DATEFORMAT), $cl_start, $cl_finish, $cl_id))
299 $err->add($i18n->getKey('error.overlap'));
304 $res = ttTimeHelper::update(array(
306 'date'=>$new_date->toString(DB_DATEFORMAT),
307 'user_id'=>$user->getActiveUser(),
308 'client'=>$cl_client,
309 'project'=>$cl_project,
312 'finish'=>$cl_finish,
313 'duration'=>$cl_duration,
315 'billable'=>$cl_billable,
318 // If we have custom fields - update values.
319 if ($res && $custom_fields) {
320 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
321 $res = $custom_fields->update($cl_id, $custom_fields->fields[0]['id'], null, $cl_cf_1);
322 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
323 $res = $custom_fields->update($cl_id, $custom_fields->fields[0]['id'], $cl_cf_1, null);
327 header('Location: time.php?date='.$new_date->toString(DB_DATEFORMAT));
333 // Save as new record.
334 if ($request->getParameter('btn_copy')) {
336 // 1) Prohibit saving into locked range.
337 // 2) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
339 // Now, step by step.
341 // 1) Prohibit saving into locked range.
342 if ($user->isDateLocked($new_date))
343 $err->add($i18n->getKey('error.range_locked'));
345 // 2) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
346 $uncompleted = ($cl_finish == '' && $cl_duration == '');
348 $not_completed_rec = ttTimeHelper::getUncompleted($user->getActiveUser());
349 if ($not_completed_rec) {
350 // We have another not completed record.
351 $err->add($i18n->getKey('error.uncompleted_exists')." <a href = 'time_edit.php?id=".$not_completed_rec['id']."'>".$i18n->getKey('error.goto_uncompleted')."</a>");
356 // Prohibit creating an overlapping record.
358 if (ttTimeHelper::overlaps($user->getActiveUser(), $new_date->toString(DB_DATEFORMAT), $cl_start, $cl_finish))
359 $err->add($i18n->getKey('error.overlap'));
362 // Now, a new insert.
365 $id = ttTimeHelper::insert(array(
366 'date'=>$new_date->toString(DB_DATEFORMAT),
367 'user_id'=>$user->getActiveUser(),
368 'client'=>$cl_client,
369 'project'=>$cl_project,
372 'finish'=>$cl_finish,
373 'duration'=>$cl_duration,
375 'billable'=>$cl_billable,
378 // Insert a custom field if we have it.
380 if ($id && $custom_fields && $cl_cf_1) {
381 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
382 $res = $custom_fields->insert($id, $custom_fields->fields[0]['id'], null, $cl_cf_1);
383 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
384 $res = $custom_fields->insert($id, $custom_fields->fields[0]['id'], $cl_cf_1, null);
387 header('Location: time.php?date='.$new_date->toString(DB_DATEFORMAT));
390 $err->add($i18n->getKey('error.db'));
394 if ($request->getParameter('btn_delete')) {
395 header("Location: time_delete.php?id=$cl_id");
400 $smarty->assign('client_list', $client_list);
401 $smarty->assign('project_list', $project_list);
402 $smarty->assign('task_list', $task_list);
403 $smarty->assign('forms', array($form->getName()=>$form->toArray()));
404 $smarty->assign('onload', 'onLoad="fillDropdowns()"');
405 $smarty->assign('title', $i18n->getKey('title.edit_time_record'));
406 $smarty->assign('content_page_name', 'time_edit.tpl');
407 $smarty->display('index.tpl');