The Field Criterion class.
Provides content filtering based on Fields contents & values.
Properties¶
$operator¶
The operator used by the Criterion.
|
|
$target¶
The target used by the criteria (field, metadata...).
|
|
$value¶
The value(s) matched by the criteria.
|
|
$valueData¶
Additional value data, required by some criterions, MapLocationDistance for instance.
|
|
$customFields¶
Custom field definitions to query instead of default field.
|
|
Methods¶
__construct() ¶
Performs operator validation based on the Criterion specifications returned by {@see getSpecifications()}.
|
|
Parameters
Name | Type | Default value | Description |
---|---|---|---|
$operator | string|null | - |
The operator the Criterion uses. If null is given, will default to Operator::IN if $value is an array, Operator::EQ if it is not. |
$value | mixed | - | - |
$valueData | Value|null | null | - |
getCustomField() ¶
Return custom field.
|
|
If no custom field is set, return null
Parameters
Name | Type | Default value | Description |
---|---|---|---|
$type | string | - | - |
$field | string | - | - |
Return values
string|null
getSpecifications() ¶
Criterion description function.
|
|
Returns the combination of the Criterion's supported operator/value, as an array of Specifications objects
- Operator is one supported Operator, as an Operator::* constant
- ValueType is the type of input value this operator requires, either array or single
- SupportedTypes is an array of types the operator will accept
- ValueCountLimitation is an integer saying how many values are expected.
// IN and EQ are supported
return [
// The EQ operator expects a single value, either as an integer or a string
new Specifications(
Operator::EQ,
Specifications::FORMAT_SINGLE,
Specifications::TYPE_INTEGER | Specifications::TYPE_STRING
),
// The IN operator expects an array of values, of either integers or strings
new Specifications(
Operator::IN,
Specifications::FORMAT_ARRAY,
Specifications::TYPE_INTEGER | Specifications::TYPE_STRING
)
]
Return values
array<string|int, Specifications>
setCustomField() ¶
Set a custom field to query.
|
|
Set a custom field to query for a defined field in a defined type.
Parameters
Name | Type | Default value | Description |
---|---|---|---|
$type | string | - | - |
$field | string | - | - |
$customField | string | - | - |