1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace NerdsAndCompany\Schematic\Behaviors; |
4
|
|
|
|
5
|
|
|
use Craft; |
6
|
|
|
use TypeError; |
7
|
|
|
use yii\base\Behavior; |
8
|
|
|
use craft\base\Model; |
9
|
|
|
use craft\records\VolumeFolder; |
10
|
|
|
use craft\fields\Users; |
11
|
|
|
use NerdsAndCompany\Schematic\Schematic; |
12
|
|
|
use NerdsAndCompany\Schematic\Events\SourceMappingEvent; |
13
|
|
|
|
14
|
|
|
/** |
15
|
|
|
* Schematic Sources Behavior. |
16
|
|
|
* |
17
|
|
|
* Sync Craft Setups. |
18
|
|
|
* |
19
|
|
|
* @author Nerds & Company |
20
|
|
|
* @copyright Copyright (c) 2015-2019, Nerds & Company |
21
|
|
|
* @license MIT |
22
|
|
|
* |
23
|
|
|
* @see http://www.nerds.company |
24
|
|
|
*/ |
25
|
|
|
class SourcesBehavior extends Behavior |
26
|
|
|
{ |
27
|
|
|
/** Hack to be able to avoid the active record call in VolumeFolder::findOne() */ |
28
|
|
|
public $mockFolder = null; |
29
|
|
|
|
30
|
|
|
/** |
31
|
|
|
* Recursively find sources in definition attributes. |
32
|
|
|
* |
33
|
|
|
* @param string $fieldType |
34
|
|
|
* @param array $attributes |
35
|
|
|
* @param string $indexFrom |
36
|
|
|
* @param string $indexTo |
37
|
|
|
* |
38
|
|
|
* @return array |
39
|
|
|
*/ |
40
|
32 |
|
public function findSources(string $fieldType, array $attributes, string $indexFrom, string $indexTo): array |
41
|
|
|
{ |
42
|
32 |
|
foreach ($attributes as $key => $attribute) { |
43
|
32 |
|
if ($key === 'source') { |
44
|
4 |
|
$attributes[$key] = $this->getSource($fieldType, $attribute, $indexFrom, $indexTo); |
45
|
32 |
|
} elseif ($key === 'sources') { |
46
|
4 |
|
$attributes[$key] = $this->getSources($fieldType, $attribute, $indexFrom, $indexTo); |
47
|
32 |
|
} elseif (is_array($attribute)) { |
48
|
32 |
|
$attributes[$key] = $this->findSources($fieldType, $attribute, $indexFrom, $indexTo); |
49
|
|
|
} |
50
|
|
|
} |
51
|
|
|
|
52
|
32 |
|
return $attributes; |
53
|
|
|
} |
54
|
|
|
|
55
|
|
|
/** |
56
|
|
|
* Get sources based on the indexFrom attribute and return them with the indexTo attribute. |
57
|
|
|
* |
58
|
|
|
* @param string $fieldType |
59
|
|
|
* @param string|array $sources |
60
|
|
|
* @param string $indexFrom |
61
|
|
|
* @param string $indexTo |
62
|
|
|
* |
63
|
|
|
* @return array|string |
64
|
|
|
*/ |
65
|
9 |
|
public function getSources(string $fieldType, $sources, string $indexFrom, string $indexTo) |
66
|
|
|
{ |
67
|
9 |
|
$mappedSources = $sources; |
68
|
9 |
|
if (is_array($sources)) { |
69
|
7 |
|
$mappedSources = []; |
70
|
7 |
|
$sources = array_filter($sources); |
71
|
7 |
|
foreach ($sources as $source) { |
72
|
7 |
|
$mappedSources[] = $this->getSource($fieldType, $source, $indexFrom, $indexTo); |
73
|
|
|
} |
74
|
|
|
} |
75
|
|
|
|
76
|
9 |
|
return $mappedSources; |
77
|
|
|
} |
78
|
|
|
|
79
|
|
|
/** |
80
|
|
|
* Gets a source by the attribute indexFrom, and returns it with attribute $indexTo. |
81
|
|
|
* |
82
|
|
|
* @TODO Break up and simplify this method |
83
|
|
|
* |
84
|
|
|
* @param string $fieldType |
85
|
|
|
* @param string $source |
86
|
|
|
* @param string $indexFrom |
87
|
|
|
* @param string $indexTo |
88
|
|
|
* |
89
|
|
|
* @return string|null |
90
|
|
|
* |
91
|
|
|
* @SuppressWarnings(PHPMD.CyclomaticComplexity) |
92
|
|
|
* @SuppressWarnings(PHPMD.NPathComplexity) |
93
|
|
|
*/ |
94
|
9 |
|
public function getSource(string $fieldType, string $source = null, string $indexFrom, string $indexTo) |
95
|
|
|
{ |
96
|
9 |
|
if (false === strpos($source, ':')) { |
97
|
7 |
|
return $source; |
98
|
|
|
} |
99
|
|
|
|
100
|
|
|
/** @var Model $sourceObject */ |
101
|
9 |
|
$sourceObject = null; |
102
|
|
|
|
103
|
|
|
// Get service and method by source |
104
|
9 |
|
list($sourceType, $sourceFrom) = explode(':', $source); |
105
|
|
|
switch ($sourceType) { |
106
|
9 |
|
case 'editSite': |
107
|
|
|
$service = Craft::$app->sites; |
108
|
|
|
$method = 'getSiteBy'; |
109
|
|
|
break; |
110
|
9 |
|
case 'single': |
111
|
9 |
|
case 'section': |
112
|
9 |
|
case 'createEntries': |
113
|
9 |
|
case 'editPeerEntries': |
114
|
9 |
|
case 'deleteEntries': |
115
|
9 |
|
case 'deletePeerEntries': |
116
|
9 |
|
case 'deletePeerEntryDrafts': |
117
|
9 |
|
case 'editEntries': |
118
|
9 |
|
case 'editPeerEntryDrafts': |
119
|
9 |
|
case 'publishEntries': |
120
|
9 |
|
case 'publishPeerEntries': |
121
|
9 |
|
case 'publishPeerEntryDrafts': |
122
|
5 |
|
$service = Craft::$app->sections; |
123
|
5 |
|
$method = 'getSectionBy'; |
124
|
5 |
|
break; |
125
|
9 |
|
case 'assignUserGroup': |
126
|
|
|
$service = Craft::$app->userGroups; |
127
|
|
|
$method = 'getGroupBy'; |
128
|
|
|
break; |
129
|
9 |
|
case 'group': |
130
|
7 |
|
case 'editCategories': |
131
|
5 |
|
$service = Users::class == $fieldType ? Craft::$app->userGroups : Craft::$app->categories; |
132
|
5 |
|
$method = 'getGroupBy'; |
133
|
5 |
|
break; |
134
|
7 |
|
case 'folder': |
135
|
2 |
|
$service = $this; |
136
|
2 |
|
$method = 'getFolderBy'; |
137
|
2 |
|
break; |
138
|
5 |
|
case 'createFoldersInVolume': |
139
|
5 |
|
case 'deleteFilesAndFoldersInVolume': |
140
|
5 |
|
case 'saveAssetInVolume': |
141
|
5 |
|
case 'viewVolume': |
142
|
3 |
|
$service = Craft::$app->volumes; |
143
|
3 |
|
$method = 'getVolumeBy'; |
144
|
3 |
|
break; |
145
|
2 |
|
case 'taggroup': |
146
|
|
|
$service = Craft::$app->tags; |
147
|
|
|
$method = 'getTagGroupBy'; |
148
|
|
|
break; |
149
|
2 |
|
case 'field': |
150
|
2 |
|
$service = Craft::$app->fields; |
151
|
2 |
|
$method = 'getFieldBy'; |
152
|
2 |
|
break; |
153
|
|
|
case 'editGlobalSet': |
154
|
|
|
$service = Craft::$app->globals; |
155
|
|
|
$method = 'getSetBy'; |
156
|
|
|
break; |
157
|
|
|
case 'utility': |
158
|
|
|
return $source; |
159
|
|
|
} |
160
|
|
|
|
161
|
|
|
// Send event |
162
|
9 |
|
$plugin = Craft::$app->controller->module; |
163
|
9 |
|
$event = new SourceMappingEvent([ |
164
|
9 |
|
'source' => $source, |
165
|
9 |
|
'service' => $service ?? null, |
166
|
9 |
|
'method' => $method ?? null, |
167
|
|
|
]); |
168
|
9 |
|
$plugin->trigger($plugin::EVENT_MAP_SOURCE, $event); |
169
|
9 |
|
$service = $event->service; |
170
|
9 |
|
$method = $event->method; |
171
|
|
|
|
172
|
|
|
// Try service and method |
173
|
9 |
|
if (isset($service) && isset($method) && isset($sourceFrom)) { |
174
|
9 |
|
$method = $method.ucfirst($indexFrom); |
175
|
|
|
try { |
176
|
9 |
|
$sourceObject = $service->$method($sourceFrom); |
|
|
|
|
177
|
|
|
} catch (TypeError $e) { |
178
|
|
|
Schematic::error('An error occured mapping source '.$source.' from '.$indexFrom.' to '.$indexTo); |
179
|
|
|
Schematic::error($e->getMessage()); |
180
|
|
|
|
181
|
|
|
return null; |
182
|
|
|
} |
183
|
|
|
} |
184
|
|
|
|
185
|
9 |
|
if ($sourceObject) { |
186
|
8 |
|
return $sourceType.':'.$sourceObject->$indexTo; |
187
|
|
|
} |
188
|
|
|
|
189
|
1 |
|
Schematic::warning('No mapping found for source '.$source); |
190
|
|
|
|
191
|
1 |
|
return null; |
192
|
|
|
} |
193
|
|
|
|
194
|
|
|
/** |
195
|
|
|
* Get a folder by id |
196
|
|
|
* @SuppressWarnings(PHPMD.UnusedPrivateMethod) |
197
|
|
|
* |
198
|
|
|
* @param int $folderId |
199
|
|
|
* @return object |
200
|
|
|
*/ |
201
|
1 |
|
private function getFolderById(int $folderId): \stdClass |
202
|
|
|
{ |
203
|
1 |
|
$folder = Craft::$app->assets->getFolderById($folderId); |
204
|
1 |
|
if ($folder) { |
205
|
1 |
|
$volume = $folder->getVolume(); |
206
|
|
|
return (object) [ |
207
|
1 |
|
'id' => $folderId, |
208
|
1 |
|
'handle' => $volume->handle |
209
|
|
|
]; |
210
|
|
|
} |
211
|
|
|
return null; |
212
|
|
|
} |
213
|
|
|
|
214
|
|
|
/** |
215
|
|
|
* Get folder by volume id |
216
|
|
|
* |
217
|
|
|
* @param int $volumeId |
218
|
|
|
* @return VolumeFolder |
219
|
|
|
*/ |
220
|
1 |
|
private function getFolderByVolumeId(int $volumeId): VolumeFolder |
221
|
|
|
{ |
222
|
1 |
|
return $this->mockFolder ? $this->mockFolder : VolumeFolder::findOne(['volumeId' => $volumeId]); |
223
|
|
|
} |
224
|
|
|
|
225
|
|
|
/** |
226
|
|
|
* Set a mock folder for the tests |
227
|
|
|
* |
228
|
|
|
* @param VolumeFolder $mockFolder |
229
|
|
|
*/ |
230
|
1 |
|
public function setMockFolder(VolumeFolder $mockFolder) |
231
|
|
|
{ |
232
|
1 |
|
$this->mockFolder = $mockFolder; |
233
|
1 |
|
} |
234
|
|
|
|
235
|
|
|
/** |
236
|
|
|
* Get a folder by volume handle |
237
|
|
|
* @SuppressWarnings(PHPMD.UnusedPrivateMethod) |
238
|
|
|
* |
239
|
|
|
* @param string $folderHandle |
240
|
|
|
* @return object |
241
|
|
|
*/ |
242
|
1 |
|
private function getFolderByHandle(string $folderHandle): \stdClass |
243
|
|
|
{ |
244
|
1 |
|
$volume = Craft::$app->volumes->getVolumeByHandle($folderHandle); |
245
|
1 |
|
if ($volume) { |
246
|
1 |
|
$folder = $this->getFolderByVolumeId($volume->id); |
247
|
1 |
|
if ($folder) { |
248
|
|
|
return (object) [ |
249
|
1 |
|
'id' => $folder->id, |
250
|
1 |
|
'handle' => $folderHandle |
251
|
|
|
]; |
252
|
|
|
} |
253
|
|
|
} |
254
|
|
|
return null; |
255
|
|
|
} |
256
|
|
|
} |
257
|
|
|
|
Methods can only be called on objects. This check looks for methods being called on variables that have been inferred to never be objects.