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; |
13
|
|
|
|
14
|
|
|
use Illuminate\Database\Eloquent; |
15
|
|
|
use Illuminate\Database\Eloquent\Relations; |
16
|
|
|
use Illuminate\Database\Eloquent\Relations\Relation; |
17
|
|
|
use Illuminate\Database\Query; |
18
|
|
|
use Tinyissue\Model\Project; |
19
|
|
|
use Tinyissue\Model\Tag; |
20
|
|
|
use Tinyissue\Model\User; |
21
|
|
|
|
22
|
|
|
/** |
23
|
|
|
* QueryTrait is trait class containing the database queries methods for the Project model. |
24
|
|
|
* |
25
|
|
|
* @author Mohamed Alsharaf <[email protected]> |
26
|
|
|
* |
27
|
|
|
* @property int $id |
28
|
|
|
* |
29
|
|
|
* @method Eloquent\Model where($column, $operator = null, $value = null, $boolean = 'and') |
30
|
|
|
* @method Query\Builder join($table, $one, $operator = null, $two = null, $type = 'inner', $where = false) |
31
|
|
|
* @method Relations\HasMany users() |
32
|
|
|
* @method Relations\HasMany issues() |
33
|
|
|
* @method void filterAssignTo(Query\Builder $query, $userId) |
34
|
|
|
* @method void filterTitleOrBody(Query\Builder $query, $keyword) |
35
|
|
|
* @method void filterTags(Eloquent\Builder $query, array $tags) |
36
|
|
|
* @method void sortByUpdated(Query\Builder $query, $order = 'asc') |
37
|
|
|
* @method Eloquent\Collection sortByTag(Query\Builder $query, $tagGroup, $order = 'asc') |
38
|
|
|
*/ |
39
|
|
|
trait QueryTrait |
40
|
|
|
{ |
41
|
|
|
/** |
42
|
|
|
* Returns collection of active projects. |
43
|
|
|
* |
44
|
|
|
* @return Eloquent\Collection |
45
|
|
|
*/ |
46
|
|
|
public static function activeProjects() |
47
|
|
|
{ |
48
|
|
|
return static::where('status', '=', Project::STATUS_OPEN) |
49
|
|
|
->orderBy('name', 'ASC') |
50
|
|
|
->get(); |
51
|
|
|
} |
52
|
|
|
|
53
|
|
|
/** |
54
|
|
|
* Returns collection of public projects. |
55
|
|
|
* |
56
|
|
|
* @return Eloquent\Collection |
57
|
|
|
*/ |
58
|
|
|
public function publicProjects() |
59
|
|
|
{ |
60
|
|
|
return $this->where('private', '=', Project::PRIVATE_NO) |
61
|
|
|
->orderBy('name', 'ASC') |
62
|
|
|
->get(); |
63
|
|
|
} |
64
|
|
|
|
65
|
|
|
/** |
66
|
|
|
* Returns all users that are not assigned in the current project. |
67
|
|
|
* |
68
|
|
|
* @return array |
69
|
|
|
*/ |
70
|
1 |
|
public function usersNotIn() |
71
|
|
|
{ |
72
|
1 |
|
if ($this->id > 0) { |
73
|
|
|
$userIds = $this->users()->lists('user_id')->all(); |
74
|
|
|
$users = User::where('deleted', '=', User::NOT_DELETED_USERS)->whereNotIn('id', $userIds)->get(); |
75
|
|
|
} else { |
76
|
1 |
|
$users = User::where('deleted', '=', User::NOT_DELETED_USERS)->get(); |
77
|
|
|
} |
78
|
|
|
|
79
|
1 |
|
return $users->lists('fullname', 'id')->all(); |
80
|
|
|
} |
81
|
|
|
|
82
|
|
|
/** |
83
|
|
|
* Fetch and filter issues in the project. |
84
|
|
|
* |
85
|
|
|
* @param int $status |
86
|
|
|
* @param array $filter |
87
|
|
|
* |
88
|
|
|
* @return \Illuminate\Database\Eloquent\Collection |
89
|
|
|
*/ |
90
|
2 |
|
public function listIssues($status = Project\Issue::STATUS_OPEN, array $filter = []) |
91
|
|
|
{ |
92
|
2 |
|
$sortOrder = array_get($filter, 'sort.sortorder', 'desc'); |
93
|
2 |
|
$sortBy = array_get($filter, 'sort.sortby', null); |
94
|
|
|
|
95
|
2 |
|
$query = $this->issues() |
96
|
2 |
|
->with('countComments', 'user', 'updatedBy', 'tags', 'tags.parent') |
97
|
2 |
|
->with([ |
98
|
|
|
'tags' => function (Relation $query) use ($status, $sortOrder) { |
99
|
2 |
|
$status = $status == Project\Issue::STATUS_OPEN ? Tag::STATUS_OPEN : Tag::STATUS_CLOSED; |
|
|
|
|
100
|
2 |
|
$query->where('name', '!=', |
101
|
2 |
|
($status == Project\Issue::STATUS_OPEN ? Tag::STATUS_OPEN : Tag::STATUS_CLOSED)); |
102
|
2 |
|
$query->orderBy('name', $sortOrder); |
103
|
2 |
|
}, |
104
|
|
|
]) |
105
|
2 |
|
->where('status', '=', $status); |
106
|
|
|
|
107
|
|
|
// Filter issues |
108
|
2 |
|
$this->filterAssignTo($query, array_get($filter, 'assignto')); |
109
|
2 |
|
$this->filterTitleOrBody($query, array_get($filter, 'keyword')); |
110
|
2 |
|
$this->filterTags($query, array_get($filter, 'tags')); |
111
|
|
|
|
112
|
|
|
// Sort |
113
|
2 |
|
if ($sortBy == 'updated') { |
114
|
|
|
$this->sortByUpdated($query, $sortOrder); |
115
|
2 |
|
} elseif (($tagGroup = substr($sortBy, strlen('tag:'))) > 0) { |
116
|
|
|
return $this->sortByTag($query, $tagGroup, $sortOrder); |
117
|
|
|
} |
118
|
|
|
|
119
|
2 |
|
return $query->get(); |
120
|
|
|
} |
121
|
|
|
|
122
|
|
|
/** |
123
|
|
|
* Fetch issues assigned to a user. |
124
|
|
|
* |
125
|
|
|
* @param int $userId |
126
|
|
|
* |
127
|
|
|
* @return \Illuminate\Database\Eloquent\Collection |
128
|
|
|
*/ |
129
|
1 |
|
public function listAssignedIssues($userId) |
130
|
|
|
{ |
131
|
1 |
|
return $this->issues() |
132
|
1 |
|
->with('countComments', 'user', 'updatedBy') |
133
|
1 |
|
->where('status', '=', Project\Issue::STATUS_OPEN) |
134
|
1 |
|
->where('assigned_to', '=', $userId) |
135
|
1 |
|
->orderBy('updated_at', 'DESC') |
136
|
1 |
|
->get(); |
137
|
|
|
} |
138
|
|
|
|
139
|
|
|
/** |
140
|
|
|
* Returns projects with issues details eager loaded. |
141
|
|
|
* |
142
|
|
|
* @param int $status |
143
|
|
|
* @param int $private |
144
|
|
|
* |
145
|
|
|
* @return Relations\HasMany |
146
|
|
|
*/ |
147
|
4 |
|
public function projectsWidthIssues($status = Project::STATUS_OPEN, $private = Project::PRIVATE_NO) |
148
|
|
|
{ |
149
|
|
|
$query = $this |
150
|
4 |
|
->where('status', '=', $status) |
151
|
4 |
|
->orderBy('name'); |
152
|
|
|
|
153
|
4 |
|
if ($private !== Project::PRIVATE_ALL) { |
154
|
4 |
|
$query->where('private', '=', $private); |
155
|
|
|
} |
156
|
|
|
|
157
|
4 |
|
$query->with([ |
158
|
|
View Code Duplication |
'issues' => function (Relations\Relation $query) use ($status) { |
|
|
|
|
159
|
3 |
|
$query->with('updatedBy'); |
160
|
3 |
|
if ($status === Project::STATUS_OPEN) { |
161
|
3 |
|
$query->where('status', '=', Project\Issue::STATUS_OPEN); |
162
|
|
|
} |
163
|
4 |
|
}, |
164
|
|
|
'issues.user' => function () { |
165
|
4 |
|
}, |
166
|
|
|
'issues.countComments' => function () { |
167
|
4 |
|
}, |
168
|
|
|
]); |
169
|
|
|
|
170
|
4 |
|
return $query; |
171
|
|
|
} |
172
|
|
|
|
173
|
|
|
/** |
174
|
|
|
* Returns collection of tags for Kanban view. |
175
|
|
|
* |
176
|
|
|
* @return mixed |
177
|
|
|
*/ |
178
|
|
|
public function getKanbanTags() |
179
|
|
|
{ |
180
|
|
|
$tags = $this->kanbanTags()->get(); |
|
|
|
|
181
|
|
|
if (!$tags->count()) { |
182
|
|
|
$tags = (new Tag())->getOpenAndCloseTags(); |
183
|
|
|
$kanbanTags = $this->kanbanTags(); |
|
|
|
|
184
|
|
View Code Duplication |
foreach ($tags as $position => $tag) { |
|
|
|
|
185
|
|
|
$position = $tag->name === Tag::STATUS_OPEN ? -1 : $position; |
186
|
|
|
$position = $tag->name === Tag::STATUS_CLOSED ? 100 : $position; |
187
|
|
|
$kanbanTags->attach([$tag->id => ['position' => $position]]); |
188
|
|
|
} |
189
|
|
|
} |
190
|
|
|
|
191
|
|
|
return $tags; |
192
|
|
|
} |
193
|
|
|
|
194
|
|
|
/** |
195
|
|
|
* Returns collection of issues grouped by tags. |
196
|
|
|
* |
197
|
|
|
* @param $tagIds |
198
|
|
|
* |
199
|
|
|
* @return mixed |
200
|
|
|
*/ |
201
|
|
|
public function issuesGroupByTags($tagIds) |
202
|
|
|
{ |
203
|
|
|
$issues = $this->issues() |
204
|
|
|
->with('user', 'tags') |
205
|
|
|
->with([ |
206
|
|
|
'tags' => function (Relation $query) use ($tagIds) { |
207
|
|
|
$query->whereIn('id', $tagIds); |
208
|
|
|
}, |
209
|
|
|
]) |
210
|
|
|
->orderBy('id') |
211
|
|
|
->get() |
212
|
|
|
->groupBy(function (Project\Issue $issue) { |
213
|
|
|
$tag = $issue->tags->last(); |
|
|
|
|
214
|
|
|
if (!$tag) { |
215
|
|
|
// Workaround: Some older issues before the tags feature may not have open/close tag |
216
|
|
|
return $issue->status === Project\Issue::STATUS_OPEN ? Tag::STATUS_OPEN : Tag::STATUS_CLOSED; |
217
|
|
|
} |
218
|
|
|
|
219
|
|
|
return $tag->name; |
220
|
|
|
}); |
221
|
|
|
|
222
|
|
|
return $issues; |
223
|
|
|
} |
224
|
|
|
} |
225
|
|
|
|
It seems like you are assigning to a variable which was imported through a
use
statement which was not imported by reference.For clarity, we suggest to use a different name or import by reference depending on whether you would like to have the change visibile in outer-scope.
Change not visible in outer-scope
Change visible in outer-scope