Completed
Push — develop ( 3d6b5a...688bc1 )
by Mohamed
07:41
created

CrudTrait::delete()   B

Complexity

Conditions 2
Paths 2

Size

Total Lines 27
Code Lines 19

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 6

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 27
ccs 0
cts 13
cp 0
rs 8.8571
cc 2
eloc 19
nc 2
nop 0
crap 6
1
<?php
2
3
/*
4
 * This file is part of the Tinyissue package.
5
 *
6
 * (c) Mohamed Alsharaf <[email protected]>
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 Tinyissue\Model\Traits\Project\Issue;
13
14
use Illuminate\Database\Eloquent;
15
use Illuminate\Database\Eloquent\Relations;
16
use Tinyissue\Model;
17
use Tinyissue\Model\Activity;
18
use Tinyissue\Model\Project;
19
use Tinyissue\Model\Project\Issue\Attachment;
20
use Tinyissue\Model\User;
21
22
/**
23
 * CrudTrait is trait class containing the methods for adding/editing/deleting the Project\Issue model.
24
 *
25
 * @author Mohamed Alsharaf <[email protected]>
26
 *
27
 * @property int                        $id
28
 * @property int                        $created_by
29
 * @property int                        $project_id
30
 * @property string                     $title
31
 * @property string                     $body
32
 * @property int                        $assigned_to
33
 * @property int                        $time_quote
34
 * @property int                        $closed_by
35
 * @property int                        $closed_at
36
 * @property int                        status
37
 * @property int                        $updated_at
38
 * @property int                        $updated_by
39
 * @property Project                    $project
40
 * @property User                       $user
41
 * @property User                       $updatedBy
42
 *
43
 * @method   Eloquent\Model             save()
44
 * @method   Eloquent\Model             fill(array $attributes)
45
 * @method   Relations\BelongsToMany    tags()
46
 * @method   Relations\HasMany          activities()
47
 * @method   Relations\HasMany          comments()
48
 */
49
trait CrudTrait
50
{
51
    /**
52
     * Set the issue is updated by a user.
53
     *
54
     * @param int $userId
55
     *
56
     * @return Eloquent\Model
57
     */
58 10
    public function changeUpdatedBy($userId)
59
    {
60 10
        $this->updated_by = $userId;
61 10
        $this->touch();
0 ignored issues
show
Bug introduced by
It seems like touch() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
62
63 10
        return $this->save();
64
    }
65
66
    /**
67
     * Reassign the issue to a new user.
68
     *
69
     * @param int|User $assignTo
70
     * @param User     $user
71
     *
72
     * @return Eloquent\Model
73
     */
74 3
    public function reassign($assignTo, User $user)
75
    {
76 3
        $assignToId        = !$assignTo instanceof User ? $assignTo : $assignTo->id;
77 3
        $this->assigned_to = $assignToId;
78
79
        // Add event on successful save
80
        static::saved(function (Project\Issue $issue) use ($user) {
81 3
            $this->queueAssign($issue, $user);
0 ignored issues
show
Bug introduced by
It seems like queueAssign() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
82 3
        });
83
84 3
        $this->save();
85
86 3
        return $this->activities()->save(new User\Activity([
87 3
            'type_id'   => Activity::TYPE_REASSIGN_ISSUE,
88 3
            'parent_id' => $this->project->id,
89 3
            'user_id'   => $user->id,
90 3
            'action_id' => $this->assigned_to,
91
        ]));
92
    }
93
94
    /**
95
     * Update the given issue.
96
     *
97
     * @param array $input
98
     *
99
     * @return Eloquent\Model
100
     */
101 4
    public function updateIssue(array $input)
102
    {
103
        $fill = [
104 4
            'title'       => $input['title'],
105 4
            'body'        => $input['body'],
106 4
            'assigned_to' => $input['assigned_to'],
107 4
            'time_quote'  => $input['time_quote'],
108 4
            'updated_by'  => $this->updatedBy->id,
109
        ];
110 4
        $fill['lock_quote'] = isset($input['time_quote']['lock']) ? $input['time_quote']['lock'] : false;
111
112
        /* Add to activity log for assignment if changed */
113 4
        if ($input['assigned_to'] != $this->assigned_to) {
114 1
            $this->activities()->save(new User\Activity([
115 1
                'type_id'   => Activity::TYPE_REASSIGN_ISSUE,
116 1
                'parent_id' => $this->project->id,
117 1
                'user_id'   => $this->updatedBy->id,
118 1
                'action_id' => $this->assigned_to,
119
            ]));
120
        }
121
122 4
        $this->fill($fill);
123
124 4
        $this->syncTags($input, $this->tags()->with('parent')->get());
0 ignored issues
show
Bug introduced by
It seems like syncTags() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
125
126
        // Add event on successful save
127
        static::saved(function (Project\Issue $issue) {
128 4
            $this->queueUpdate($issue, $issue->updatedBy);
0 ignored issues
show
Bug introduced by
It seems like queueUpdate() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
129 4
        });
130
131 4
        return $this->save();
132
    }
133
134
    /**
135
     * Create a new issue.
136
     *
137
     * @param array $input
138
     *
139
     * @return CrudTrait
0 ignored issues
show
Comprehensibility Bug introduced by
The return type CrudTrait is a trait, and thus cannot be used for type-hinting in PHP. Maybe consider adding an interface and use that for type-hinting?

In PHP traits cannot be used for type-hinting as they do not define a well-defined structure. This is because any class that uses a trait can rename that trait’s methods.

If you would like to return an object that has a guaranteed set of methods, you could create a companion interface that lists these methods explicitly.

Loading history...
140
     */
141 34
    public function createIssue(array $input)
142
    {
143
        $fill = [
144 34
            'created_by' => $this->user->id,
145 34
            'project_id' => $this->project->id,
146 34
            'title'      => $input['title'],
147 34
            'body'       => $input['body'],
148
        ];
149
150 34
        if ($this->user->permission('issue-modify')) {
151 33
            $fill['assigned_to'] = $input['assigned_to'];
152 33
            $fill['time_quote']  = $input['time_quote'];
153
        }
154
155 34
        $this->fill($fill)->save();
156
157
        // Add issue to messages queue
158 34
        $this->queueAdd($this, $this->user);
0 ignored issues
show
Bug introduced by
It seems like queueAdd() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
159
160
        /* Add to user's activity log */
161 34
        $this->activities()->save(new User\Activity([
162 34
            'type_id'   => Activity::TYPE_CREATE_ISSUE,
163 34
            'parent_id' => $this->project->id,
164 34
            'user_id'   => $this->user->id,
165
        ]));
166
167
        /* Add attachments to issue */
168 34
        Attachment::where('upload_token', '=', $input['upload_token'])
0 ignored issues
show
Unused Code introduced by
The call to Attachment::where() has too many arguments starting with 'upload_token'.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
169 34
            ->where('uploaded_by', '=', $this->user->id)
170 34
            ->update(['issue_id' => $this->id]);
171
172
        // Add default tag to newly created issue
173 34
        $defaultTag = app('tinyissue.settings')->getFirstStatusTagId();
174 34
        if ($defaultTag > 0 && empty($input['tag_status'])) {
175
            $input['tag_status'] = $defaultTag;
176
        }
177
178 34
        $this->syncTags($input);
0 ignored issues
show
Bug introduced by
It seems like syncTags() must be provided by classes using this trait. How about adding it as abstract method to this trait?

This check looks for methods that are used by a trait but not required by it.

To illustrate, let’s look at the following code example

trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}

The trait Idable provides a method equalsId that in turn relies on the method getId(). If this method does not exist on a class mixing in this trait, the method will fail.

Adding the getId() as an abstract method to the trait will make sure it is available.

Loading history...
179
180 34
        return $this;
181
    }
182
183
    /**
184
     * Move the issue (comments & activities) to another project.
185
     *
186
     * @param int $projectId
187
     *
188
     * @return $this
189
     */
190 1
    public function changeProject($projectId)
191
    {
192 1
        $this->project_id = $projectId;
193 1
        $this->save();
194 1
        $comments = $this->comments()->get();
195 1
        foreach ($comments as $comment) {
196 1
            $comment->project_id = $projectId;
197 1
            $comment->save();
198
        }
199
200 1
        $activities = $this->activities()->get();
201 1
        foreach ($activities as $activity) {
202 1
            $activity->parent_id = $projectId;
203 1
            $activity->save();
204
        }
205
206 1
        return $this;
207
    }
208
209
    /**
210
     * Delete an issue.
211
     *
212
     * @return bool
213
     *
214
     * @throws \Exception
215
     */
216
    public function delete()
217
    {
218
        $id          = $this->id;
219
        $projectId   = $this->project_id;
220
        $comments    = $this->comments;
0 ignored issues
show
Bug introduced by
The property comments does not exist. Did you maybe forget to declare it?

In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code:

class MyClass { }

$x = new MyClass();
$x->foo = true;

Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion:

class MyClass {
    public $foo;
}

$x = new MyClass();
$x->foo = true;
Loading history...
221
        $attachments = $this->attachments;
0 ignored issues
show
Bug introduced by
The property attachments does not exist. Did you maybe forget to declare it?

In PHP it is possible to write to properties without declaring them. For example, the following is perfectly valid PHP code:

class MyClass { }

$x = new MyClass();
$x->foo = true;

Generally, it is a good practice to explictly declare properties to avoid accidental typos and provide IDE auto-completion:

class MyClass {
    public $foo;
}

$x = new MyClass();
$x->foo = true;
Loading history...
222
223
        $status = parent::delete();
224
225
        if ($status) {
226
            $attachments->each(function (Attachment $attachment) use ($projectId) {
227
                $path = config('filesystems.disks.local.root')
228
                    . '/' . config('tinyissue.uploads_dir')
229
                    . '/' . $projectId
230
                    . '/' . $attachment->upload_token;
231
                $attachment->deleteFile($path, $attachment->filename);
232
                $attachment->delete();
233
            });
234
            $comments->each(function (Project\Issue\Comment $comment) {
235
                $comment->deleteComment(auth()->user());
0 ignored issues
show
Documentation introduced by
auth()->user() is of type object<Illuminate\Contra...h\Authenticatable>|null, but the function expects a object<Tinyissue\Model\User>.

It seems like the type of the argument is not accepted by the function/method which you are calling.

In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug.

We suggest to add an explicit type cast like in the following example:

function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
Loading history...
236
            });
237
            User\Activity::where('parent_id', '=', $projectId)->where('item_id', '=', $id)->delete();
238
            \DB::table('projects_issues_tags')->where('issue_id', '=', $id)->delete();
239
        }
240
241
        return $status;
242
    }
243
}
244