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');
76 $cl_client = $time_rec['client_id'];
77 $cl_project = $time_rec['project_id'];
78 $cl_task = $time_rec['task_id'];
79 $cl_start = $time_rec['start'];
80 $cl_finish = $time_rec['finish'];
81 $cl_duration = $time_rec['duration'];
82 $cl_date = $item_date->toString($user->date_format);
83 $cl_note = $time_rec['comment'];
85 // If we have custom fields - obtain values for them.
87 // Get custom field value for time record.
88 $fields = $custom_fields->get($time_rec['id']);
89 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
90 $cl_cf_1 = $fields[0]['value'];
91 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
92 $cl_cf_1 = $fields[0]['option_id'];
95 $cl_billable = $time_rec['billable'];
97 // Add an info message to the form if we are editing an uncompleted record.
98 if (($cl_start == $cl_finish) && ($cl_duration == '0:00')) {
101 $msg->add($i18n->getKey('form.time_edit.uncompleted'));
105 // Initialize elements of 'timeRecordForm'.
106 $form = new Form('timeRecordForm');
108 // Dropdown for clients in MODE_TIME. Use all active clients.
109 if (MODE_TIME == $user->tracking_mode && $user->isPluginEnabled('cl')) {
110 $active_clients = ttTeamHelper::getActiveClients($user->team_id, true);
111 $form->addInput(array('type'=>'combobox',
112 'onchange'=>'fillProjectDropdown(this.value);',
114 'style'=>'width: 250px;',
116 'data'=>$active_clients,
117 'datakeys'=>array('id', 'name'),
118 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
119 // Note: in other modes the client list is filtered to relevant clients only. See below.
122 if (MODE_PROJECTS == $user->tracking_mode || MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
123 // Dropdown for projects assigned to user.
124 $project_list = $user->getAssignedProjects();
125 $form->addInput(array('type'=>'combobox',
126 'onchange'=>'fillTaskDropdown(this.value);',
128 'style'=>'width: 250px;',
129 'value'=>$cl_project,
130 'data'=>$project_list,
131 'datakeys'=>array('id','name'),
132 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
134 // Dropdown for clients if the clients plugin is enabled.
135 if ($user->isPluginEnabled('cl')) {
136 $active_clients = ttTeamHelper::getActiveClients($user->team_id, true);
137 // We need an array of assigned project ids to do some trimming.
138 foreach($project_list as $project)
139 $projects_assigned_to_user[] = $project['id'];
141 // Build a client list out of active clients. Use only clients that are relevant to user.
142 // Also trim their associated project list to only assigned projects (to user).
143 foreach($active_clients as $client) {
144 $projects_assigned_to_client = explode(',', $client['projects']);
145 if (is_array($projects_assigned_to_client) && is_array($projects_assigned_to_user))
146 $intersection = array_intersect($projects_assigned_to_client, $projects_assigned_to_user);
148 $client['projects'] = implode(',', $intersection);
149 $client_list[] = $client;
152 $form->addInput(array('type'=>'combobox',
153 'onchange'=>'fillProjectDropdown(this.value);',
155 'style'=>'width: 250px;',
157 'data'=>$client_list,
158 'datakeys'=>array('id', 'name'),
159 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
163 if (MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
164 $task_list = ttTeamHelper::getActiveTasks($user->team_id);
165 $form->addInput(array('type'=>'combobox',
167 'style'=>'width: 250px;',
170 'datakeys'=>array('id','name'),
171 'empty'=>array(''=>$i18n->getKey('dropdown.select'))));
174 // Add other controls.
175 if ((TYPE_START_FINISH == $user->record_type) || (TYPE_ALL == $user->record_type)) {
176 $form->addInput(array('type'=>'text','name'=>'start','value'=>$cl_start,'onchange'=>"formDisable('start');"));
177 $form->addInput(array('type'=>'text','name'=>'finish','value'=>$cl_finish,'onchange'=>"formDisable('finish');"));
179 if (!$user->canManageTeam() && defined('READONLY_START_FINISH') && isTrue(READONLY_START_FINISH)) {
180 // Make the start and finish fields read-only.
181 $form->getElement('start')->setEnable(false);
182 $form->getElement('finish')->setEnable(false);
184 if ((TYPE_DURATION == $user->record_type) || (TYPE_ALL == $user->record_type))
185 $form->addInput(array('type'=>'text','name'=>'duration','value'=>$cl_duration,'onchange'=>"formDisable('duration');"));
186 $form->addInput(array('type'=>'datefield','name'=>'date','maxlength'=>'20','value'=>$cl_date));
187 $form->addInput(array('type'=>'textarea','name'=>'note','style'=>'width: 250px; height: 200px;','value'=>$cl_note));
188 // If we have custom fields - add controls for them.
189 if ($custom_fields && $custom_fields->fields[0]) {
190 // Only one custom field is supported at this time.
191 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT) {
192 $form->addInput(array('type'=>'text','name'=>'cf_1','value'=>$cl_cf_1));
193 } elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN) {
194 $form->addInput(array('type'=>'combobox',
196 'style'=>'width: 250px;',
198 'data'=>$custom_fields->options,
199 'empty' => array('' => $i18n->getKey('dropdown.select'))));
202 // Hidden control for record id.
203 $form->addInput(array('type'=>'hidden','name'=>'id','value'=>$cl_id));
204 if ($user->isPluginEnabled('iv'))
205 $form->addInput(array('type'=>'checkbox','name'=>'billable','data'=>1,'value'=>$cl_billable));
206 $form->addInput(array('type'=>'hidden','name'=>'browser_today','value'=>'')); // User current date, which gets filled in on btn_save or btn_copy click.
207 $form->addInput(array('type'=>'submit','name'=>'btn_save','onclick'=>'browser_today.value=get_date()','value'=>$i18n->getKey('button.save')));
208 $form->addInput(array('type'=>'submit','name'=>'btn_copy','onclick'=>'browser_today.value=get_date()','value'=>$i18n->getKey('button.copy')));
209 $form->addInput(array('type'=>'submit','name'=>'btn_delete','value'=>$i18n->getKey('label.delete')));
211 if ($request->isPost()) {
213 // Validate user input.
214 if ($user->isPluginEnabled('cl') && $user->isPluginEnabled('cm') && !$cl_client)
215 $err->add($i18n->getKey('error.client'));
216 if ($custom_fields) {
217 if (!ttValidString($cl_cf_1, !$custom_fields->fields[0]['required'])) $err->add($i18n->getKey('error.field'), $custom_fields->fields[0]['label']);
219 if (MODE_PROJECTS == $user->tracking_mode || MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
220 if (!$cl_project) $err->add($i18n->getKey('error.project'));
222 if (MODE_PROJECTS_AND_TASKS == $user->tracking_mode) {
223 if (!$cl_task) $err->add($i18n->getKey('error.task'));
226 if ('0' == $cl_duration)
227 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.duration'));
228 elseif ($cl_start || $cl_finish) {
229 if (!ttTimeHelper::isValidTime($cl_start))
230 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.start'));
232 if (!ttTimeHelper::isValidTime($cl_finish))
233 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.finish'));
234 if (!ttTimeHelper::isValidInterval($cl_start, $cl_finish))
235 $err->add($i18n->getKey('error.interval'), $i18n->getKey('label.finish'), $i18n->getKey('label.start'));
238 if ((TYPE_START_FINISH == $user->record_type) || (TYPE_ALL == $user->record_type)) {
239 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.start'));
240 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.finish'));
242 if ((TYPE_DURATION == $user->record_type) || (TYPE_ALL == $user->record_type))
243 $err->add($i18n->getKey('error.empty'), $i18n->getKey('label.duration'));
246 if (!ttTimeHelper::isValidDuration($cl_duration))
247 $err->add($i18n->getKey('error.field'), $i18n->getKey('label.duration'));
249 if (!ttValidDate($cl_date)) $err->add($i18n->getKey('error.field'), $i18n->getKey('label.date'));
250 if (!ttValidString($cl_note, true)) $err->add($i18n->getKey('error.field'), $i18n->getKey('label.note'));
251 // Finished validating user input.
253 // This is a new date for the time record.
254 $new_date = new DateAndTime($user->date_format, $cl_date);
256 // Prohibit creating entries in future.
257 if (defined('FUTURE_ENTRIES') && !isTrue(FUTURE_ENTRIES)) {
258 $browser_today = new DateAndTime(DB_DATEFORMAT, $request->getParameter('browser_today', null));
259 if ($new_date->after($browser_today))
260 $err->add($i18n->getKey('error.future_date'));
264 if ($request->getParameter('btn_save')) {
266 // 1) Prohibit saving locked time entries in any form.
267 // 2) Prohibit saving completed unlocked entries into locked interval.
268 // 3) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
270 // Now, step by step.
272 // 1) Prohibit saving locked entries in any form.
273 if ($user->isDateLocked($item_date))
274 $err->add($i18n->getKey('error.period_locked'));
276 // 2) Prohibit saving completed unlocked entries into locked range.
277 if ($err->no() && $user->isDateLocked($new_date))
278 $err->add($i18n->getKey('error.period_locked'));
280 // 3) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
281 $uncompleted = ($cl_finish == '' && $cl_duration == '');
283 $not_completed_rec = ttTimeHelper::getUncompleted($user->getActiveUser());
284 if ($not_completed_rec && ($time_rec['id'] <> $not_completed_rec['id'])) {
285 // We have another not completed record.
286 $err->add($i18n->getKey('error.uncompleted_exists')." <a href = 'time_edit.php?id=".$not_completed_rec['id']."'>".$i18n->getKey('error.goto_uncompleted')."</a>");
291 // Prohibit creating an overlapping record.
293 if (ttTimeHelper::overlaps($user->getActiveUser(), $new_date->toString(DB_DATEFORMAT), $cl_start, $cl_finish, $cl_id))
294 $err->add($i18n->getKey('error.overlap'));
299 $res = ttTimeHelper::update(array(
301 'date'=>$new_date->toString(DB_DATEFORMAT),
302 'user_id'=>$user->getActiveUser(),
303 'client'=>$cl_client,
304 'project'=>$cl_project,
307 'finish'=>$cl_finish,
308 'duration'=>$cl_duration,
310 'billable'=>$cl_billable));
312 // If we have custom fields - update values.
313 if ($res && $custom_fields) {
314 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
315 $res = $custom_fields->update($cl_id, $custom_fields->fields[0]['id'], null, $cl_cf_1);
316 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
317 $res = $custom_fields->update($cl_id, $custom_fields->fields[0]['id'], $cl_cf_1, null);
321 header('Location: time.php?date='.$new_date->toString(DB_DATEFORMAT));
327 // Save as new record.
328 if ($request->getParameter('btn_copy')) {
330 // 1) Prohibit saving into locked range.
331 // 2) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
333 // Now, step by step.
335 // 1) Prohibit saving into locked range.
336 if ($user->isDateLocked($new_date))
337 $err->add($i18n->getKey('error.period_locked'));
339 // 2) Prohibit saving uncompleted unlocked entries when another uncompleted entry exists.
340 $uncompleted = ($cl_finish == '' && $cl_duration == '');
342 $not_completed_rec = ttTimeHelper::getUncompleted($user->getActiveUser());
343 if ($not_completed_rec) {
344 // We have another not completed record.
345 $err->add($i18n->getKey('error.uncompleted_exists')." <a href = 'time_edit.php?id=".$not_completed_rec['id']."'>".$i18n->getKey('error.goto_uncompleted')."</a>");
350 // Prohibit creating an overlapping record.
352 if (ttTimeHelper::overlaps($user->getActiveUser(), $new_date->toString(DB_DATEFORMAT), $cl_start, $cl_finish))
353 $err->add($i18n->getKey('error.overlap'));
356 // Now, a new insert.
359 $id = ttTimeHelper::insert(array(
360 'date'=>$new_date->toString(DB_DATEFORMAT),
361 'user_id'=>$user->getActiveUser(),
362 'client'=>$cl_client,
363 'project'=>$cl_project,
366 'finish'=>$cl_finish,
367 'duration'=>$cl_duration,
369 'billable'=>$cl_billable));
371 // Insert a custom field if we have it.
373 if ($id && $custom_fields && $cl_cf_1) {
374 if ($custom_fields->fields[0]['type'] == CustomFields::TYPE_TEXT)
375 $res = $custom_fields->insert($id, $custom_fields->fields[0]['id'], null, $cl_cf_1);
376 elseif ($custom_fields->fields[0]['type'] == CustomFields::TYPE_DROPDOWN)
377 $res = $custom_fields->insert($id, $custom_fields->fields[0]['id'], $cl_cf_1, null);
380 header('Location: time.php?date='.$new_date->toString(DB_DATEFORMAT));
383 $err->add($i18n->getKey('error.db'));
387 if ($request->getParameter('btn_delete')) {
388 header("Location: time_delete.php?id=$cl_id");
393 $smarty->assign('client_list', $client_list);
394 $smarty->assign('project_list', $project_list);
395 $smarty->assign('task_list', $task_list);
396 $smarty->assign('forms', array($form->getName()=>$form->toArray()));
397 $smarty->assign('onload', 'onLoad="fillDropdowns()"');
398 $smarty->assign('title', $i18n->getKey('title.edit_time_record'));
399 $smarty->assign('content_page_name', 'time_edit.tpl');
400 $smarty->display('index.tpl');