1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace Sanderdekroon\Parlant\Builder; |
4
|
|
|
|
5
|
|
|
use BadMethodCallException; |
6
|
|
|
|
7
|
|
|
class NestedTaxonomy |
8
|
|
|
{ |
9
|
|
|
|
10
|
|
|
protected $query = []; |
11
|
|
|
protected $taxonomy; |
12
|
|
|
protected $relation; |
13
|
|
|
|
14
|
|
|
/** |
15
|
|
|
* Used to determine if the developer has set a default taxonomy name. |
16
|
|
|
* @var bool |
17
|
|
|
*/ |
18
|
|
|
private $hasDefaultTaxonomy; |
19
|
|
|
|
20
|
1 |
|
public function __construct($taxonomyName = null) |
21
|
|
|
{ |
22
|
1 |
|
$this->taxonomy = $taxonomyName; |
23
|
1 |
|
$this->hasDefaultTaxonomy = empty($taxonomyName) ? false : true; |
24
|
1 |
|
} |
25
|
|
|
|
26
|
|
|
/** |
27
|
|
|
* Base method for creating a tax_query within a nested context. |
28
|
|
|
* @param string $taxonomy Name of the taxonomy. |
29
|
|
|
* @param string $field The field to query (term_id, name, etc.) |
30
|
|
|
* @param string $operator The operator to compare the value to (IN, NOT In, etc.) |
31
|
|
|
* @param mixed $value The value of the term to query. Can be a string or an integer. |
32
|
|
|
* @param bool $includeChildren Whether or not to include children in hierarchical taxonomies. |
33
|
|
|
* @param string $relation The relation between different subqueries within the same nested query. |
34
|
|
|
* @param integer $level Depth level. You should not modify this yourself. |
35
|
|
|
* @return $this |
36
|
|
|
*/ |
37
|
1 |
|
protected function where($taxonomy, $field, $operator = null, $value = null, $includeChildren = true, $relation = null, $level = 2) |
38
|
|
|
{ |
39
|
1 |
|
if (func_num_args() == 3 || is_null($value)) { |
40
|
1 |
|
$value = $operator; |
41
|
1 |
|
$operator = 'IN'; |
42
|
|
|
} |
43
|
|
|
|
44
|
1 |
|
$this->setQuery(compact( |
45
|
1 |
|
'taxonomy', |
46
|
1 |
|
'field', |
47
|
1 |
|
'operator', |
48
|
1 |
|
'value', |
49
|
1 |
|
'includeChildren', |
50
|
1 |
|
'level' |
51
|
|
|
)); |
52
|
|
|
|
53
|
1 |
|
if (!empty($relation)) { |
54
|
|
|
$this->setRelation($relation); |
55
|
|
|
} |
56
|
|
|
|
57
|
1 |
|
return $this; |
58
|
|
|
} |
59
|
|
|
|
60
|
|
|
/** |
61
|
|
|
* Magically call additional helpers on a nested taxonomy query. Accepted methods are named |
62
|
|
|
* after the field they're querying. For example: slug(), name(), etc. This method also |
63
|
|
|
* figures out if the developer has set a default taxonomy that we should injext. |
64
|
|
|
* @param string $methodname The methodname the developer is calling. |
65
|
|
|
* @param array $arguments See $this->where for accepted arguments. |
66
|
|
|
* @return $this |
67
|
|
|
*/ |
68
|
1 |
|
public function __call($methodname, $arguments) |
69
|
|
|
{ |
70
|
|
|
$fieldsToMethods = [ |
71
|
1 |
|
'slug' => 'slug', |
72
|
|
|
'name' => 'name', |
73
|
|
|
'termTaxonomyId' => 'term_taxonomy_id', |
74
|
|
|
'id' => 'term_id', |
75
|
|
|
]; |
76
|
|
|
|
77
|
|
|
// If the developer is calling a method which we have not defined, |
78
|
|
|
// throw a BadMethodCall exception since we can't recover from this. |
79
|
1 |
|
if (!in_array($methodname, array_keys($fieldsToMethods))) { |
80
|
|
|
throw new BadMethodCallException('Invalid method called on NestedTaxonomy.'); |
81
|
|
|
} |
82
|
|
|
|
83
|
|
|
// If the developer has not set a default taxonomy we'll grab the first argument |
84
|
|
|
// from the method that's being called. We will assume it's the taxonomy name |
85
|
|
|
// we are looking for and set this value to the class property taxonomy. |
86
|
1 |
|
if ($this->hasDefaultTaxonomy === false) { |
87
|
1 |
|
$this->taxonomy = reset($arguments); |
88
|
1 |
|
unset($arguments[0]); |
89
|
|
|
} |
90
|
|
|
|
91
|
|
|
// Construct a where call with the gathered variables. |
92
|
1 |
|
return $this->where( |
93
|
1 |
|
$this->taxonomy, |
94
|
1 |
|
$fieldsToMethods[$methodname], |
95
|
1 |
|
...$arguments |
|
|
|
|
96
|
|
|
); |
97
|
|
|
} |
98
|
|
|
|
99
|
|
|
|
100
|
|
|
public function orWhere($taxonomy, $field, $operator = null, $value = null, $includeChildren = true) |
101
|
|
|
{ |
102
|
|
|
$this->setRelation('OR'); |
103
|
|
|
return $this->where($taxonomy, $field, $operator, $value, $includeChildren); |
104
|
|
|
} |
105
|
|
|
|
106
|
|
|
|
107
|
1 |
|
public function relation($relation) |
108
|
|
|
{ |
109
|
1 |
|
$this->setRelation($relation); |
110
|
1 |
|
return $this; |
111
|
|
|
} |
112
|
|
|
|
113
|
|
|
|
114
|
1 |
|
protected function setQuery($query) |
115
|
|
|
{ |
116
|
1 |
|
$this->query[] = $query; |
117
|
1 |
|
} |
118
|
|
|
|
119
|
|
|
|
120
|
1 |
|
public function getQuery() |
121
|
|
|
{ |
122
|
1 |
|
return $this->query; |
123
|
|
|
} |
124
|
|
|
|
125
|
|
|
|
126
|
1 |
|
protected function setRelation($relation) |
127
|
|
|
{ |
128
|
1 |
|
$this->relation = $relation; |
129
|
1 |
|
} |
130
|
|
|
|
131
|
|
|
|
132
|
1 |
|
public function getRelation() |
133
|
|
|
{ |
134
|
1 |
|
return empty($this->relation) ? 'AND' : $this->relation; |
135
|
|
|
} |
136
|
|
|
|
137
|
|
|
|
138
|
1 |
|
public function replaceQuery($query) |
139
|
|
|
{ |
140
|
1 |
|
$this->query = $query; |
141
|
1 |
|
} |
142
|
|
|
} |
143
|
|
|
|