Intro

Criteria are the filters for Content and Location Search, for generic use of API Search see Search Criteria and Sort Clauses.

A Criterion consist of two parts just like SortClause and FacetBuilder:

• The API Value: Criterion
• Specific handler per search engine: Criterion Handler

Criterion represents the value you use in the API, while CriterionHandler deals with the business logic in the background translating the value to something the Search engine can understand.

Common concepts for most Criteria

For how to use each and every Criterion see the list below, as it depends on the Criterion Value constructor, but in general you should be aware of the following common concepts:

• target: Exposed if the given Criterion supports targeting a specific sub field, example: FieldDefinition or Meta Data identifier
• value: The value(s) to filter on, this is typically a  scalar or array of scalars.
• operator: Exposed on some Criteria
  • All operators can be seen on eZ\Publish\API\Repository\Values\Content\Query\Criterion\Operator, at time of writing: IN, EQ, GT, GTE, LT, LTE, LIKE, BETWEEN, CONTAINS
  • Most Criteria do not expose this and select EQ or IN depending on if value is scalar or array
  • IN & BETWEEN always acts on an array of values, while the other operators act on single scalar value
• valueData : Additional value data, required by some Criteria, MapLocationDistance for instance

List of Criteria

The list below reflects Criteria available in the eZ\Publish\API\Repository\Values\Content\Query\Criterion namespace (it is also possible to make a custom Criterion):

Only for LocationSearch

Only for ContentSearch

Common

Related topics:

• Search Criteria and Sort Clauses
• Sort Clauses reference