<?php namespace Kanboard\Action; use Kanboard\Model\TaskLinkModel; /** * Assign a color to a specific task link * * @package Kanboard\Action * @author Frederic Guillot */ class TaskAssignColorLink extends Base { /** * Get automatic action description * * @access public * @return string */ public function getDescription() { return t('Change task color when using a specific task link'); } /** * Get the list of compatible events * * @access public * @return array */ public function getCompatibleEvents() { return array( TaskLinkModel::EVENT_CREATE_UPDATE, ); } /** * Get the required parameter for the action (defined by the user) * * @access public * @return array */ public function getActionRequiredParameters() { return array( 'color_id' => t('Color'), 'link_id' => t('Link type'), ); } /** * Get the required parameter for the event * * @access public * @return string[] */ public function getEventRequiredParameters() { return array( 'task_link' => array( 'task_id', 'link_id', ) ); } /** * Execute the action (change the task color) * * @access public * @param array $data Event data dictionary * @return bool True if the action was executed or false when not executed */ public function doAction(array $data) { $values = array( 'id' => $data['task_link']['task_id'], 'color_id' => $this->getParam('color_id'), ); return $this->taskModificationModel->update($values, false); } /** * Check if the event data meet the action condition * * @access public * @param array $data Event data dictionary * @return bool */ public function hasRequiredCondition(array $data) { return $data['task_link']['link_id'] == $this->getParam('link_id'); } }