diff --git a/docs/Aggregation/Terms.md b/docs/Aggregation/Terms.md new file mode 100644 index 0000000000000000000000000000000000000000..66a8213c01d838b6b787d7850f99a9099bd5b4e6 --- /dev/null +++ b/docs/Aggregation/Terms.md @@ -0,0 +1,31 @@ +# Terms Aggregation + +> More info about terms aggregation is in the [official elasticsearch docs][1] + +A multi-bucket value source based aggregation where buckets are dynamically +built - one per unique value. + +## Simple example + +```JSON +{ + "aggregations" : { + "agg_genders" : { + "terms" : { "field" : "gender" } + } + } +} +``` + +And now the query via DSL: + +```php +$termsAggregation = new TermsAggregation('genders', 'gender'); + +$search = new Search(); +$search->addAggregation($termsAggregation); + +$queryArray = $search->toArray(); +``` + +[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-terms-aggregation.html