tasks/includes/t-tasks/controllers.inc.php

<?php


class Ctrl_AddTask
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		$nested = $this->form->field( 'nested' )->value( );
		if ( 0 === (int) $nested ) {
			return $this->addTopLevelTask( );
		}
		return $this->addNestedTask( );
	}

	private function addTopLevelTask( )
	{
		$item = $this->form->field( 'item' );
		$name = $this->form->field( 'title' );
		$priority = $this->form->field( 'priority' );
		$description = $this->form->field( 'description' );

		$error = Loader::DAO( 'tasks' )->addTask( (int) $item->value( ) , $name->value( ) ,
			(int) $priority->value( ) , $description->value( ) );
		switch ( $error ) {

		case 0:
			return true;

		case 1:
			$name->putError( 'Duplicate task name for this item.' );
			break;

		case 2:
			$item->putError( 'This item has been deleted' );
			break;

		default:
			$name->putError( "An unknown error occurred ($error)" );
			break;
		}

		return null;
	}

	private function addNestedTask( )
	{
		$parent = $this->form->field( 'parent' );
		$name = $this->form->field( 'title' );
		$priority = $this->form->field( 'priority' );
		$description = $this->form->field( 'description' );

		$error = Loader::DAO( 'tasks' )->addNestedTask( (int) $parent->value( ) ,
			$name->value( ) , (int) $priority->value( ) , $description->value( ) );
		switch ( $error ) {

		case 0:
			return true;

		case 1:
			$name->putError( 'Duplicate sub-task name.' );
			break;

		default:
			$name->putError( "An unknown error occurred ($error)" );
			break;
		}

		return null;
	}
}


class Ctrl_TaskDetails
	extends Controller
{
	private $task;

	public function __construct( $task )
	{
		$this->task = $task;
	}


	public function handle( Page $page )
	{
		if ( $this->task->completed_at !== null ) {
			$bTitle = "Completed task";
		} else {
			$bTitle = "Active task";
		}

		if ( $this->task->item !== null ) {
			$items = Loader::DAO( 'items' );
			$items->getLineage( $this->task->item = $items->get( $this->task->item ) );
		} else {
			$this->task->parent_task = Loader::DAO( 'tasks' )->get( $this->task->parent_task );
		}

		$box = Loader::View( 'box' , $bTitle , Loader::View( 'task_details' , $this->task ) );

		$tasks = Loader::DAO( 'tasks' );
		if ( $this->task->completed_by === null ) {
			$box->addButton( BoxButton::create( 'Edit task' , 'tasks/edit?id=' . $this->task->id )
					->setClass( 'icon edit' ) );

			if ( $tasks->canFinish( $this->task ) ) {
				$box->addButton( BoxButton::create( 'Mark as completed' , 'tasks/finish?id=' . $this->task->id )
						->setClass( 'icon stop' ) );
			}

			if ( $this->task->assigned_id !== $_SESSION[ 'uid' ] ) {
				$box->addButton( BoxButton::create( 'Claim task' , 'tasks/claim?id=' . $this->task->id )
						->setClass( 'icon claim' ) );
			}

			if ( $this->task->can_move_up == 't' ) {
				$box->addButton( BoxButton::create( 'Move task to grandparent' ,
					'tasks/move/up?id=' . $this->task->id )->setClass( 'icon move-up' ) );
			}
			if ( ! empty( $this->task->moveDownTargets ) ) {
				$box->addButton( BoxButton::create( 'Move task to sibling' ,
					'tasks/move/down?id=' . $this->task->id )->setClass( 'icon move-down' ) );
			}
		} else {
			if ( $tasks->canRestart( $this->task ) ) {
				$box->addButton( BoxButton::create( 'Re-activate' , 'tasks/restart?id=' . $this->task->id )
					->setClass( 'icon start' ) );
			}
			$timestamp = strtotime( $this->task->completed_at );
		}

		if ( Loader::DAO( 'tasks' )->canDelete( $this->task ) ) {
			$box->addButton( BoxButton::create( 'Delete' , 'tasks/delete?id=' . $this->task->id )
					->setClass( 'icon delete' ) );
		}

		return $box;
	}
}


class Ctrl_TaskListSubtasks
	extends Controller
{
	private $task;

	public function __construct( $task )
	{
		$this->task = $task;
	}


	public function handle( Page $page )
	{
		$box = Loader::View( 'box' , 'Sub-tasks' ,
			Loader::View( 'tasks_list' , $this->task->subtasks , array( 'deps' , 'assigned' , 'completed' ) ) );

		if ( $this->task->completed_by === null ) {
			$box->addButton( BoxButton::create( 'Add sub-task' , 'tasks/add?parent=' . $this->task->id )
				->setClass( 'list-add' ) );
		}

		return $box;
	}
}


class Ctrl_TaskDependencies
	extends Controller
{
	private $task;

	public function __construct( $task )
	{
		$this->task = $task;
	}


	public function handle( Page $page )
	{
		$views = array( );

		if ( ! empty( $this->task->dependencies )
				|| ( $this->task->completed_by === null && ! empty( $this->task->possibleDependencies ) ) ) {
			$views[] = ( $depBox = Loader::View( 'box' , 'Dependencies' ,
				Loader::View( 'task_dependencies' , $this->task , false ) ) );

			if ( ! empty( $this->task->possibleDependencies ) ) {
				$depBox->addButton( BoxButton::create( 'Add dependency' , 'tasks/deps/add?to=' . $this->task->id )
						->setClass( 'list-add' ) );
			}
		}

		if ( ! empty( $this->task->reverseDependencies ) ) {
			array_push( $views , Loader::View( 'box' , 'Reverse dependencies' ,
				Loader::View( 'task_dependencies' , $this->task , true ) ) );
		}

		return $views;
	}
}


class Ctrl_TaskNotes
	extends Controller
{
	private $task;

	public function __construct( $task )
	{
		$this->task = $task;
	}


	public function handle( Page $page )
	{
		$result = array( );
		foreach ( $this->task->notes as $note ) {
			$box = Loader::View( 'box' , null , Loader::View( 'task_note' , $note ) );
			if ( $this->task->completed_at === null && $note->uid == $_SESSION[ 'uid' ] ) {
				$box->addButton( BoxButton::create( 'Edit comment' , 'tasks/notes/edit?id=' . $note->id )
						->setClass( 'icon edit' ) )
					->addButton( BoxButton::create( 'Delete comment' , 'tasks/notes/delete?id=' . $note->id )
						->setClass( 'icon delete' ) );
			}
			array_push( $result , $box );
		}
		return $result;
	}
}


class Ctrl_DeleteTask
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		Loader::DAO( 'tasks' )->delete( (int) $this->form->field( 'id' )->value( ) );
		return true;
	}
}


class Ctrl_ToggleTask
	extends Controller
{
	private $restart;

	public function __construct( $restart )
	{
		$this->isRestart = $restart;
	}

	public function handle( Page $page )
	{
		// Check selected task
		try {
			$id = (int) $this->getParameter( 'id' , 'GET' );
		} catch ( ParameterException $e ) {
			return 'tasks';
		}

		$tasks = Loader::DAO( 'tasks' );
		$task = $tasks->get( $id );
		if ( $task === null ) {
			return 'tasks';
		}

		if ( $this->isRestart && $tasks->canRestart( $task ) ) {
			$tasks->restart( $id , '[AUTO] Task re-activated.' );
		} else if ( ! $this->isRestart && $tasks->canFinish( $task ) ) {
			$tasks->finish( $id , '[AUTO] Task completed.' );
		}

		return 'tasks/view?id=' . $id;
	}
}


class Ctrl_EditTask
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		$id = $this->form->field( 'id' );

		$nested = $this->form->field( 'nested' )->value( );
		if ( 0 == (int) $nested ) {
			$item = $this->form->field( 'item' );
		} else {
			$item = null;
		}

		$name = $this->form->field( 'title' );
		$priority = $this->form->field( 'priority' );
		$description = $this->form->field( 'description' );
		$assignee = $this->form->field( 'assigned-to' );

		if ( $item != null ) {
			return $this->handleTopLevelTask( $id , $item , $name , $priority , $description , $assignee );
		}
		return $this->handleNestedTask(  $id , $name , $priority , $description , $assignee );
	}

	private function handleNestedTask( $id , $name , $priority , $description , $assignee )
	{
		$error = Loader::DAO( 'tasks' )->updateNestedTask( (int) $id->value( ) , $name->value( ) ,
			(int) $priority->value( ) , $description->value( ) ,
			(int) $assignee->value( ) );

		switch ( $error ) {

		case 0:
			return true;

		case 1:
			$name->putError( 'Another sub-task already uses this title.' );
			break;

		case 2:
			$assignee->putError( 'This user has been deleted.' );
			break;

		default:
			$name->putError( "An unknown error occurred ($error)" );
			break;
		}

		return null;
	}

	private function handleTopLevelTask( $id , $item , $name , $priority , $description , $assignee )
	{
		$error = Loader::DAO( 'tasks' )->updateTask( (int) $id->value( ) ,
			(int) $item->value( ) , $name->value( ) ,
			(int) $priority->value( ) , $description->value( ) ,
			(int) $assignee->value( ) );

		switch ( $error ) {

		case 0:
			return true;

		case 1:
			$name->putError( 'A task already uses this title for this item.' );
			break;

		case 2:
			$item->putError( 'This item has been deleted.' );
			break;

		case 3:
			$assignee->putError( 'This user has been deleted.' );
			break;

		default:
			$name->putError( "An unknown error occurred ($error)" );
			break;
		}

		return null;
	}
}


class Ctrl_AddTaskNoteForm
	extends Controller
{
	private $task;

	public function __construct( $task )
	{
		$this->task = $task;
	}


	public function handle( Page $page )
	{
		return Loader::Create( 'Form' , 'Add' , 'add-note' , 'Add a comment' )
			->setSuccessURL( 'tasks/view?id=' . $this->task->id )
			->setAction( '?id=' . $this->task->id . '#add-note-form' )
			->addField( Loader::Create( 'Field' , 'text' , 'textarea' )
				->setDescription( 'Comment:' )
				->setValidator( Loader::Create( 'Validator_StringLength' , 'This comment' , 5 ) ) )
			->addController( Loader::Ctrl( 'add_task_note' , $this->task ) )
			->controller( );
	}
}


class Ctrl_AddTaskNote
	extends Controller
	implements FormAware
{
	private $task;
	private $form;

	public function __construct( $task )
	{
		$this->task = $task;
	}

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		Loader::DAO( 'tasks' )->addNote( $this->task->id , $this->form->field( 'text' )->value( ) );
		return true;
	}

}


class Ctrl_DeleteNote
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		Loader::DAO( 'tasks' )->deleteNote( (int) $this->form->field( 'id' )->value( ) );
		return true;
	}
}


class Ctrl_EditNote
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		$id = (int) $this->form->field( 'id' )->value( );
		$text = $this->form->field( 'text' )->value( );
		Loader::DAO( 'tasks' )->updateNote( $id , $text );
		return true;
	}
}


class Ctrl_DependencyAdd
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		$id = (int) $this->form->field( 'to' )->value( );
		$dependency = $this->form->field( 'dependency' );
		$error = Loader::DAO( 'tasks' )->addDependency( $id , $dependency->value( ) );

		switch ( $error ) {

		case 0:
			return true;

		case 1:
			$dependency->putError( 'The task you selected has been deleted.' );
			break;

		case 2:
			$dependency->putError( 'This dependency is no longer possible.' );
			break;

		case 3:
			$dependency->putError( 'These tasks are no longer at the same level.' );
			break;

		default:
			$dependency->putError( "An unknown error occurred ($error)" );
			break;
		}

		return null;
	}
}


class Ctrl_DependencyDelete
	extends Controller
	implements FormAware
{
	private $form;

	public function setForm( Form $form )
	{
		$this->form = $form;
	}

	public function handle( Page $page )
	{
		Loader::DAO( 'tasks' )->deleteDependency(
			(int) $this->form->field( 'from' )->value( ) ,
			(int) $this->form->field( 'to' )->value( ) );
		return true;
	}
}


class Ctrl_TaskClaim
	extends Controller
{

	public function handle( Page $page )
	{
		try {
			$id = (int) $this->getParameter( 'id' );
		} catch ( ParameterException $e ) {
			return 'tasks';
		}

		$dao = Loader::DAO( 'tasks' );
		$dao->assignTaskTo( $id , $_SESSION[ 'uid' ] );
		return 'tasks/view?id=' . $id;
	}

}