/**
* Edit a task
*
* @ingroup pages
*/
function taskEdit($task = NULL)
{
global $PH;
### object or from database? ###
if (!$task) {
$ids = getPassedIds('tsk', 'tasks_*');
if (!$ids) {
$PH->abortWarning(__("Select some task(s) to edit"), ERROR_NOTE);
return;
} else {
if (count($ids) > 1) {
$PH->show('taskEditMultiple');
exit;
} else {
if (!($task = Task::getEditableById($ids[0]))) {
$PH->abortWarning(__("You do not have enough rights to edit this task"), ERROR_RIGHTS);
}
}
}
}
### get parent project ####
if (!($project = Project::getVisibleById($task->project))) {
$PH->abortWarning("FATAL error! parent project not found");
}
### abort, if not enough rights ###
$project->validateEditItem($task);
$page = new Page(array('use_jscalendar' => true, 'autofocus_field' => 'task_name'));
initPageForTask($page, $task, $project);
if ($task->id) {
$page->title = $task->name;
$page->title_minor = $task->short;
} else {
if ($task->category == TCATEGORY_MILESTONE) {
$page->title = __("New milestone");
} else {
if ($task->category == TCATEGORY_VERSION) {
$page->title = __("New version");
} else {
if ($task->category == TCATEGORY_DOCU) {
$page->title = __("New topic");
} else {
if ($task->category == TCATEGORY_FOLDER) {
$page->title = __("New folder");
} else {
$page->title = __("New task");
if ($task->parent_task && ($parent_task = Task::getVisibleById($task->parent_task))) {
$page->title_minor = sprintf(__('for %s', 'e.g. new task for something'), $parent_task->name);
} else {
$page->title_minor = sprintf(__('for %s', 'e.g. new task for something'), $project->name);
}
}
}
}
}
}
echo new PageHeader();
echo new PageContentOpen();
require_once confGet('DIR_STREBER') . 'render/render_form.inc.php';
global $auth;
global $REPRODUCIBILITY_VALUES;
global $g_prio_names;
global $g_status_names;
$block = new PageBlock(array('id' => 'functions'));
$block->render_blockStart();
$form = new PageForm();
$form->button_cancel = true;
$form->add($task->fields['name']->getFormElement($task));
$list = array();
if ($task->category == TCATEGORY_MILESTONE || $task->category == TCATEGORY_VERSION) {
$list = array(TCATEGORY_MILESTONE, TCATEGORY_VERSION);
### make sure it's valid
if ($task->category != TCATEGORY_MILESTONE || $task->category != TCATEGORY_VERSION) {
if ($task->is_released > RELEASED_UPCOMMING) {
$task->category = TCATEGORY_VERSION;
} else {
$task->category = TCATEGORY_MILESTONE;
}
}
} else {
$list = array();
if ($project->settings & PROJECT_SETTING_ENABLE_TASKS) {
$list[] = TCATEGORY_TASK;
}
if ($project->settings & PROJECT_SETTING_ENABLE_BUGS) {
$list[] = TCATEGORY_BUG;
}
$list[] = TCATEGORY_DOCU;
$list[] = TCATEGORY_FOLDER;
}
global $g_tcategory_names;
$cats = array();
foreach ($list as $c) {
$cats[$c] = $g_tcategory_names[$c];
}
$form->add(new Form_Dropdown('task_category', __("Display as"), array_flip($cats), $task->category));
### warning if folder with subtasks ###
if ($task->id && $task->category == TCATEGORY_FOLDER && ($num_subtasks = count($task->getSubtasks()))) {
$form->add(new Form_CustomHtml('<p><label></label>' . sprintf(__("This folder has %s subtasks. Changing category will ungroup them."), $num_subtasks) . '</p>'));
}
$form->add($tab_group = new Page_TabGroup());
$tab_group->add($tab = new Page_Tab('task', __("Task")));
### normaltasks and folders ##
if (!$task->isMilestoneOrVersion()) {
if ($project->settings & PROJECT_SETTING_ENABLE_MILESTONES) {
$tab->add(new Form_DropdownGrouped('task_for_milestone', __('For Milestone'), $project->buildPlannedForMilestoneList(), $task->for_milestone));
}
### prio ###
if ($task->category != TCATEGORY_MILESTONE && $task->category != TCATEGORY_VERSION) {
$tab->add(new Form_Dropdown('task_prio', __("Prio", "Form label"), array_flip($g_prio_names), $task->prio));
}
}
### for existing tasks, get already assigned
if ($task->id) {
$assigned_people = $task->getAssignedPeople();
#$task_assignments = $task->getAssignments();
} else {
### check new assigments ###
$count = 0;
while ($id_new = get('task_assign_to_' . $count)) {
$count++;
### check if already assigned ###
if ($p = Person::getVisibleById($id_new)) {
$assigned_people[] = $p;
}
}
if (!$count) {
$parents = $task->getFolder();
if ($parents) {
$parents = array_reverse($parents);
foreach ($parents as $p) {
if ($ap = $p->getAssignedPeople()) {
$assigned_people = $ap;
break;
}
}
}
}
}
$team = array(__('- select person -') => 0);
### create team-list ###
foreach ($project->getPeople() as $p) {
$team[$p->name] = $p->id;
}
### create drop-down-lists ###
$count_new = 0;
$count_all = 0;
if (isset($assigned_people)) {
foreach ($assigned_people as $ap) {
if (!($p = Person::getVisibleById($ap->id))) {
continue;
# skip if invalid person
}
if ($task->id) {
$tab->add(new Form_Dropdown('task_assigned_to_' . $ap->id, __("Assigned to"), $team, $ap->id));
} else {
$tab->add(new Form_Dropdown('task_assign_to_' . $count_new, __("Assign to"), $team, $ap->id));
$count_new++;
}
$count_all++;
unset($team[$ap->name]);
}
}
### add empty drop-downlist for new assignments ###
$str_label = $count_all == 0 ? __("Assign to", "Form label") : __("Also assign to", "Form label");
$tab->add(new Form_Dropdown("task_assign_to_{$count_new}", $str_label, $team, 0));
### completion ###
if (!$task->is_released > RELEASED_UPCOMMING) {
#$form->add($task->fields['estimated' ]->getFormElement($task));
$ar = array(__('undefined') => -1, '0%' => 0, '10%' => 10, '20%' => 20, '30%' => 30, '40%' => 40, '50%' => 50, '60%' => 60, '70%' => 70, '80%' => 80, '90%' => 90, '95%' => 95, '98%' => 98, '99%' => 99, '100%' => 100);
$tab->add(new Form_Dropdown('task_completion', __("Completed"), $ar, $task->completion));
}
$st = array();
foreach ($g_status_names as $s => $n) {
if ($s >= STATUS_NEW) {
$st[$s] = $n;
}
}
if ($task->isMilestoneOrVersion()) {
unset($st[STATUS_NEW]);
}
$field_status = new Form_Dropdown('task_status', "Status", array_flip($st), $task->status);
if ($task->fields['status']->invalid) {
$field_status->invalid = true;
}
$tab->add($field_status);
if (!$task->isMilestoneOrVersion()) {
if ($project->settings & PROJECT_SETTING_ENABLE_MILESTONES) {
### resolved version ###
$tab->add(new Form_DropdownGrouped('task_resolved_version', __('Resolved in'), $project->buildResolvedInList(), $task->resolved_version));
}
### resolved reason ###
global $g_resolve_reason_names;
$tab->add(new Form_Dropdown('task_resolve_reason', __('Resolve reason'), array_flip($g_resolve_reason_names), $task->resolve_reason));
}
$tab_group->add($tab = new Page_Tab("bug", __("Bug Report")));
### use issue-report ###
global $g_severity_names;
global $g_reproducibility_names;
### create new one ###
if ($task->issue_report <= 0) {
$issue = new Issue(array('id' => 0));
### get recent issue-reports ###
if ($recent_ir = Issue::getCreatedRecently()) {
$default_version = '';
$default_plattform = '';
$default_production_build = '';
$default_os = '';
foreach ($recent_ir as $ir) {
if ($ir->project == $project->id) {
if (!$issue->version && $ir->version) {
$issue->version = $ir->version;
}
if (!$issue->plattform && $ir->plattform) {
$issue->plattform = $ir->plattform;
}
if (!$issue->os && $ir->os) {
$issue->os = $ir->os;
}
if (!$issue->production_build && $ir->production_build) {
$issue->production_build = $ir->production_build;
}
}
}
}
} else {
/**
* note: if task is visible ignore visibility of issue report
*/
$issue = Issue::getById($task->issue_report);
}
if ($issue) {
$tab->add(new Form_Dropdown('issue_severity', __("Severity", "Form label, attribute of issue-reports"), array_flip($g_severity_names), $issue->severity));
$tab->add(new Form_Dropdown('issue_reproducibility', __("Reproducibility", "Form label, attribute of issue-reports"), array_flip($g_reproducibility_names), $issue->reproducibility));
foreach ($issue->fields as $field) {
$tab->add($field->getFormElement($issue));
}
$tab->add(new Form_HiddenField('task_issue_report', '', $task->issue_report));
} else {
trigger_error("could not get Issue with id ({$task->issue}-report)", E_USER_NOTICE);
}
$tab_group->add($tab = new Page_Tab("timing", __("Timing")));
### estimated ###
if (!$task->isMilestoneOrVersion()) {
#$tab->add($task->fields['estimated' ]->getFormElement($task));
$ar = array(__('undefined') => 0, __('30 min') => 30 * 60, __('1 h') => 60 * 60, __('2 h') => 2 * 60 * 60, __('4 h') => 4 * 60 * 60, __('1 Day') => 1 * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('2 Days') => 2 * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('3 Days') => 3 * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('4 Days') => 4 * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('1 Week') => 1 * confGet('WORKDAYS_PER_WEEK') * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('2 Weeks') => 2 * confGet('WORKDAYS_PER_WEEK') * confGet('WORKHOURS_PER_DAY') * 60 * 60, __('3 Weeks') => 3 * confGet('WORKDAYS_PER_WEEK') * confGet('WORKHOURS_PER_DAY') * 60 * 60);
$tab->add(new Form_Dropdown('task_estimated', __("Estimated time"), $ar, $task->estimated));
$tab->add(new Form_Dropdown('task_estimated_max', __("Estimated worst case"), $ar, $task->estimated_max));
}
### planned time ###
if (!$task->isMilestoneOrVersion()) {
$tab->add($task->fields['planned_start']->getFormElement($task));
}
$tab->add($task->fields['planned_end']->getFormElement($task));
if ($task->isMilestoneOrVersion()) {
global $g_released_names;
$tab->add(new Form_Dropdown('task_is_released', __("Release as version", "Form label, attribute of issue-reports"), array_flip($g_released_names), $task->is_released));
$tab->add($task->fields['time_released']->getFormElement($task));
}
$tab_group->add($tab = new Page_Tab('description', __("Description")));
$e = $task->fields['description']->getFormElement($task);
$e->rows = 20;
$tab->add($e);
$tab_group->add($tab = new Page_Tab('display', __("Display")));
### short ###
$tab->add($task->fields['short']->getFormElement($task));
### order id ###
$tab->add($task->fields['order_id']->getFormElement($task));
### Shows as news ###
$tab->add($task->fields['is_news']->getFormElement($task));
### Shows Folder as documentation ###
$tab->add($task->fields['show_folder_as_documentation']->getFormElement($task));
### public-level ###
if (($pub_levels = $task->getValidUserSetPublicLevels()) && count($pub_levels) > 1) {
$tab->add(new Form_Dropdown('task_pub_level', __("Publish to"), $pub_levels, $task->pub_level));
}
### label ###
if (!$task->isOfCategory(TCATEGORY_VERSION, TCATEGORY_MILESTONE, TCATEGORY_FOLDER)) {
$labels = array(__('undefined') => 0);
$counter = 1;
foreach (explode(",", $project->labels) as $l) {
$labels[$l] = $counter++;
}
$tab->add(new Form_Dropdown('task_label', __("Label"), $labels, $task->label));
}
if (confGet('INTERNAL_COST_FEATURE') && $auth->cur_user->user_rights & RIGHT_VIEWALL && $auth->cur_user->user_rights & RIGHT_EDITALL) {
$tab_group->add($tab = new Page_Tab("internal", __("Internal")));
$tab->add($task->fields['calculation']->getFormElement($task));
}
/**
* to reduce spam, enforce captcha test for guests
*/
global $auth;
if ($auth->cur_user->id == confGet('ANONYMOUS_USER')) {
$form->addCaptcha();
}
$form->add($task->fields['parent_task']->getFormElement($task));
#echo "<input type=hidden name='tsk' value='$task->id'>";
$form->add(new Form_HiddenField('tsk', '', $task->id));
#echo "<input type=hidden name='task_project' value='$project->id'>";
$form->add(new Form_HiddenField('task_project', '', $project->id));
### create another task ###
if ($task->id == 0) {
$checked = get('create_another') ? 'checked' : '';
$form->form_options[] = "<input id='create_another' name='create_another' type=checkbox {$checked}><label for='create_another'>" . __("Create another task after submit") . "</label>";
}
echo $form;
$PH->go_submit = 'taskEditSubmit';
if ($return = get('return')) {
echo "<input type=hidden name='return' value='{$return}'>";
}
$block->render_blockEnd();
#@@@ passing project-id is an security-issue, because it might allow to add tasks to unverified projects.
# Double-checking project-rights in taskEditSubmit() required
echo new PageContentClose();
echo new PageHtmlEnd();
}
/**
* View efforts for a task
*
* @ingroup pages
*/
function TaskViewEfforts()
{
global $PH;
require_once confGet('DIR_STREBER') . 'lists/list_efforts.inc.php';
### get current project ###
$id = getOnePassedId('task', 'tasks_*');
if (!($task = Task::getVisibleById($id))) {
$PH->abortWarning("invalid task-id");
return;
}
### create from handle ###
$PH->defineFromHandle(array('task' => $task->id));
if (!($project = Project::getVisibleById($task->project))) {
$PH->abortWarning("not enough rights");
}
$page = new Page();
initPageForTask($page, $task, $project);
$page->title_minor = __("Task Efforts");
### page functions ###
$page->add_function(new PageFunction(array('target' => 'effortNew', 'params' => array('task' => $task->id), 'icon' => 'new', 'name' => __('new Effort'))));
### render title ###
echo new PageHeader();
echo new PageContentOpen();
$order_by = get('sort_' . $PH->cur_page->id . "_efforts");
require_once confGet('DIR_STREBER') . 'db/class_effort.inc.php';
$efforts = Effort::getAll(array('task' => $task->id, 'order_by' => $order_by));
$list = new ListBlock_efforts();
$list->render_list($efforts);
### 'add new task'-field ###
$PH->go_submit = 'effortNew';
echo '<input type="hidden" name="task" value="' . $id . '">';
echo new PageContentClose();
echo new PageHtmlEnd();
}
/**
* view task a documentation page @ingroup pages
*/
function taskViewAsDocu()
{
global $PH;
global $auth;
require_once confGet('DIR_STREBER') . 'render/render_wiki.inc.php';
require_once confGet('DIR_STREBER') . 'db/db_itemperson.inc.php';
### get task ####
$tsk = get('tsk');
$editable = false;
# flag, if this task can be edited
if ($task = Task::getEditableById($tsk)) {
$editable = true;
} else {
if (!($task = Task::getVisibleById($tsk))) {
$PH->abortWarning("invalid task-id", ERROR_FATAL);
}
}
if (!($project = Project::getVisibleById($task->project))) {
$PH->abortWarning("this task has an invalid project id", ERROR_DATASTRUCTURE);
}
### create from handle ###
$from_handle = $PH->defineFromHandle(array('tsk' => $task->id));
global $g_wiki_task;
$g_wiki_task = $task;
### set up page and write header ####
measure_start("page_render");
$page = new Page();
$page->use_autocomplete = true;
initPageForTask($page, $task, $project);
$page->title_minor_html = $PH->getLink('taskView', sprintf('#%d', $task->id), array('tsk' => $task->id));
if ($task->state == -1) {
$page->title_minor_html .= ' ' . sprintf(__('(deleted %s)', 'page title add on with date of deletion'), renderTimestamp($task->deleted));
}
### page functions ###
if ($project->isPersonVisibleTeamMember($auth->cur_user)) {
### edit ###
if ($editable) {
$page->add_function(new PageFunction(array('target' => 'taskEdit', 'params' => array('tsk' => $task->id), 'icon' => 'edit', 'tooltip' => __('Edit this task'), 'name' => __('Edit'))));
$page->add_function(new PageFunction(array('target' => 'tasksMoveToFolder', 'params' => array('tsk' => $task->id), 'icon' => 'edit', 'name' => __('Move', 'page function to move current task'))));
if ($task->state == 1) {
$page->add_function(new PageFunction(array('target' => 'tasksDelete', 'params' => array('tsk' => $task->id), 'icon' => 'delete', 'tooltip' => __('Delete this task'), 'name' => __('Delete'))));
} else {
if ($task->state == -1) {
$page->add_function(new PageFunction(array('target' => 'tasksUndelete', 'params' => array('tsk' => $task->id), 'icon' => 'undelete', 'tooltip' => __('Restore this task'), 'name' => __('Undelete'))));
}
}
}
if ($auth->cur_user->settings & USER_SETTING_ENABLE_EFFORTS && $project->settings & PROJECT_SETTING_ENABLE_EFFORTS) {
$page->add_function(new PageFunction(array('target' => 'effortNew', 'params' => array('parent_task' => $task->id), 'icon' => 'effort', 'name' => __('Book Effort'))));
}
### new ###
if ($task->category == TCATEGORY_FOLDER) {
$page->add_function(new PageFunction(array('target' => 'taskNew', 'params' => array('parent_task' => $task->id, 'task_category' => TCATEGORY_DOCU, 'task_show_folder_as_documentation' => 1), 'icon' => 'edit', 'name' => __('New topic'))));
} else {
if ($task->parent_task) {
$page->add_function(new PageFunction(array('target' => 'taskNew', 'params' => array('parent_task' => $task->parent_task, 'task_category' => TCATEGORY_DOCU, 'task_show_folder_as_documentation' => 1), 'icon' => 'edit', 'name' => __('New topic'))));
} else {
$page->add_function(new PageFunction(array('target' => 'taskNew', 'params' => array('prj' => $task->project, 'task_category' => TCATEGORY_DOCU), 'icon' => 'edit', 'name' => __('New topic'))));
}
}
if ($auth->cur_user->settings & USER_SETTING_ENABLE_BOOKMARKS) {
require_once confGet('DIR_STREBER') . 'db/db_itemperson.inc.php';
$item = ItemPerson::getAll(array('person' => $auth->cur_user->id, 'item' => $task->id));
if (!$item || $item[0]->is_bookmark == 0) {
$page->add_function(new PageFunction(array('target' => 'itemsAsBookmark', 'params' => array('task' => $task->id), 'tooltip' => __('Mark this task as bookmark'), 'name' => __('Bookmark'))));
} else {
$page->add_function(new PageFunction(array('target' => 'itemsRemoveBookmark', 'params' => array('task' => $task->id), 'tooltip' => __('Remove this bookmark'), 'name' => __('Remove Bookmark'))));
}
}
}
### render title ###
echo new PageHeader();
echo new PageContentOpen_Columns();
require_once confGet('DIR_STREBER') . 'lists/list_docustructure.inc.php';
$list = new Block_DocuNavigation(array('current_task' => $task));
$list->print_all();
$block = new PageBlock(array('id' => 'summary', 'reduced_header' => true));
$block->render_blockStart();
echo "<div class=text>";
if ($person_creator = Person::getVisibleById($task->created_by)) {
echo "<div class=labeled><label>" . __("Created", "Label in Task summary") . "</label>" . renderDateHtml($task->created) . ' / ' . $person_creator->getLink() . '</div>';
}
if ($person_modify = Person::getVisibleById($task->modified_by)) {
echo "<div class=labeled><label>" . __("Modified", "Label in Task summary") . "</label>" . renderDateHtml($task->modified) . ' / ' . $person_modify->getLink() . '</div>';
}
require_once confGet('DIR_STREBER') . "db/db_itemchange.inc.php";
$versions = ItemVersion::getFromItem($task);
if (count($versions) > 1) {
$str_version = $PH->getLink('itemViewDiff', sprintf(__("View previous %s versions"), count($versions)), array('item' => $task->id));
echo "<div class=labeled><label></label>{$str_version}</div>";
}
### publish to ###
global $g_pub_level_names;
if ($task->pub_level != PUB_LEVEL_OPEN && isset($g_pub_level_names[$task->pub_level])) {
echo "<div class=labeled><label>" . __("Publish to", "Label in Task summary") . "</label>" . $g_pub_level_names[$task->pub_level];
if ($editable) {
echo '<br>(' . $PH->getLink('itemsSetPubLevel', __('Set to Open'), array('item' => $task->id, 'item_pub_level' => PUB_LEVEL_OPEN)) . ')';
}
echo "</div>";
}
echo "</div>";
$block->render_blockEnd();
require_once confGet('DIR_STREBER') . 'blocks/files_attached_to_item.inc.php';
print new FilesAttachedToItemBlock($task);
echo new PageContentNextCol();
require_once confGet('DIR_STREBER') . 'db/db_itemperson.inc.php';
if ($view = ItemPerson::getAll(array('person' => $auth->cur_user->id, 'item' => $task->id, 'feedback_requested_by' => true))) {
if ($requested_by = Person::getPeople(array('id' => $view[0]->feedback_requested_by))) {
echo "<div class=item_notice>";
echo "<h3>" . sprintf(__("Your feedback is requested by %s."), asHtml($requested_by[0]->nickname)) . "</h3>";
echo __("Please edit or comment this item.");
echo "</div>";
}
}
#$descriptionWithUpdates= $task->getTextfieldWithUpdateNotes('description');
echo "<div class=description>";
echo wikifieldAsHtml($task, 'description', array('empty_text' => "[quote]" . __("This topic does not have any text yet.\nDoubleclick here to add some.") . "[/quote]"));
echo "</div>";
### Apply automatic link conversions
if (checkAutoWikiAdjustments()) {
$task->description = applyAutoWikiAdjustments($task->description);
$task->update(array('description'), false);
}
require_once confGet('DIR_STREBER') . 'blocks/comments_on_item_block.inc.php';
print new CommentsOnItemBlock($task);
echo new PageContentClose();
echo new PageHtmlEnd();
measure_stop("page_render");
$task->nowViewedByUser();
}
