CommentCreationMoveTaskColumn::doAction()   A
last analyzed

Complexity

Conditions 2
Paths 2

Size

Total Lines 14
Code Lines 8

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 2
eloc 8
nc 2
nop 1
dl 0
loc 14
rs 9.4285
c 0
b 0
f 0
1
<?php
2
3
/*
4
 * This file is part of Jitamin.
5
 *
6
 * Copyright (C) Jitamin Team
7
 *
8
 * For the full copyright and license information, please view the LICENSE
9
 * file that was distributed with this source code.
10
 */
11
12
namespace Jitamin\Action;
13
14
use Jitamin\Model\TaskModel;
15
16
/**
17
 * Add a comment of the triggering event to the task description.
18
 */
19
class CommentCreationMoveTaskColumn extends Base
20
{
21
    /**
22
     * Get automatic action description.
23
     *
24
     * @return string
25
     */
26
    public function getDescription()
27
    {
28
        return t('Add a comment log when moving the task between columns');
29
    }
30
31
    /**
32
     * Get the list of compatible events.
33
     *
34
     * @return array
35
     */
36
    public function getCompatibleEvents()
37
    {
38
        return [
39
            TaskModel::EVENT_MOVE_COLUMN,
40
        ];
41
    }
42
43
    /**
44
     * Get the required parameter for the action (defined by the user).
45
     *
46
     * @return array
47
     */
48
    public function getActionRequiredParameters()
49
    {
50
        return ['column_id' => t('Column')];
51
    }
52
53
    /**
54
     * Get the required parameter for the event.
55
     *
56
     * @return string[]
57
     */
58
    public function getEventRequiredParameters()
59
    {
60
        return [
61
            'task_id',
62
            'task' => [
63
                'column_id',
64
                'project_id',
65
            ],
66
        ];
67
    }
68
69
    /**
70
     * Execute the action (append to the task description).
71
     *
72
     * @param array $data Event data dictionary
73
     *
74
     * @return bool True if the action was executed or false when not executed
75
     */
76
    public function doAction(array $data)
77
    {
78
        if (!$this->userSession->isLogged()) {
0 ignored issues
show
Documentation introduced by
The property userSession does not exist on object<Jitamin\Action\Co...CreationMoveTaskColumn>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
79
            return false;
80
        }
81
82
        $column = $this->columnModel->getById($data['task']['column_id']);
0 ignored issues
show
Documentation introduced by
The property columnModel does not exist on object<Jitamin\Action\Co...CreationMoveTaskColumn>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
83
84
        return (bool) $this->commentModel->create([
0 ignored issues
show
Documentation introduced by
The property commentModel does not exist on object<Jitamin\Action\Co...CreationMoveTaskColumn>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
85
            'comment' => t('Moved to column %s', $column['title']),
86
            'task_id' => $data['task_id'],
87
            'user_id' => $this->userSession->getId(),
0 ignored issues
show
Documentation introduced by
The property userSession does not exist on object<Jitamin\Action\Co...CreationMoveTaskColumn>. Since you implemented __get, maybe consider adding a @property annotation.

Since your code implements the magic getter _get, this function will be called for any read access on an undefined variable. You can add the @property annotation to your class or interface to document the existence of this variable.

<?php

/**
 * @property int $x
 * @property int $y
 * @property string $text
 */
class MyLabel
{
    private $properties;

    private $allowedProperties = array('x', 'y', 'text');

    public function __get($name)
    {
        if (isset($properties[$name]) && in_array($name, $this->allowedProperties)) {
            return $properties[$name];
        } else {
            return null;
        }
    }

    public function __set($name, $value)
    {
        if (in_array($name, $this->allowedProperties)) {
            $properties[$name] = $value;
        } else {
            throw new \LogicException("Property $name is not defined.");
        }
    }

}

If the property has read access only, you can use the @property-read annotation instead.

Of course, you may also just have mistyped another name, in which case you should fix the error.

See also the PhpDoc documentation for @property.

Loading history...
88
        ]);
89
    }
90
91
    /**
92
     * Check if the event data meet the action condition.
93
     *
94
     * @param array $data Event data dictionary
95
     *
96
     * @return bool
97
     */
98
    public function hasRequiredCondition(array $data)
99
    {
100
        return $data['task']['column_id'] == $this->getParam('column_id');
101
    }
102
}
103