Add ability to register a generic term aggregation

lib/adapters/class-adapter.php

@@ -15,6 +15,7 @@
 use Elasticsearch_Extensions\Aggregations\Post_Type;
 use Elasticsearch_Extensions\Aggregations\Relative_Date;
 use Elasticsearch_Extensions\Aggregations\Taxonomy;
+use Elasticsearch_Extensions\Aggregations\Term;
 use Elasticsearch_Extensions\DSL;
 use Elasticsearch_Extensions\Interfaces\Hookable;
 
@@ -171,6 +172,28 @@ public function add_taxonomy_aggregation( string $taxonomy, array $args = [] ):
  $this->add_aggregation( new Taxonomy( $this->dsl, wp_parse_args( $args, [ 'taxonomy' => $taxonomy ] ) ) );
  }
 
+ /**
+ * Adds a new generic term aggregation to the list of active aggregations.
+ *
+ * @param string $term_field The term field to aggregate on.
+ * @param string $query_var The query var to use for this aggregation for filters on the front-end.
+ * @param array $args Arguments to pass to the adapter's aggregation configuration.
+ */
+ public function add_term_aggregation( string $term_field, string $query_var, array $args = [] ): void {
+ $this->add_aggregation(
+ new Term(
+ $this->dsl,
+ wp_parse_args(
+ $args,
+ [
+ 'query_var' => $query_var,
+ 'term_field' => $this->dsl->map_field( $term_field ),
+ ]
+ )
+ )
+ );
+ }
+
  /**
  * Get an aggregation by its label.
  *

lib/class-controller.php

@@ -189,6 +189,24 @@ public function enable_taxonomy_aggregation( string $taxonomy, array $args = []
  return $this;
  }
 
+ /**
+ * A function to enable a generic Elasticsearch 'term' aggregation. Users must provide an
+ * Elasticsearch term field to aggregate on and a query var to use. This function should only
+ * be used if a more specific term-type aggregation (e.g., taxonomy, post type) is not
+ * available for the kind of aggregation you want to create.
+ *
+ * @param string $term_field The term field to aggregate on.
+ * @param string $query_var The query var to use for this aggregation for filters on the front-end.
+ * @param array $args Arguments to pass to the adapter's aggregation configuration.
+ *
+ * @return Controller The instance of the class to allow for chaining.
+ */
+ public function enable_term_aggregation( string $term_field, string $query_var, array $args = [] ): Controller {
+ $this->adapter->add_term_aggregation( $term_field, $query_var, $args );
+
+ return $this;
+ }
+
  /**
  * Get a specific aggregation from the adapter by its label.
  *