Automattic\WooCommerce\Admin\API\Reports

GenericQuery{} │ WC 9.3.0

A generic class for a report-specific query to be used in Analytics.

Example usage: <pre><code class="language-php">$args = array( 'before' => '2018-07-19 00:00:00', 'after' => '2018-07-05 00:00:00', 'page' => 2, ); $report = new GenericQuery( $args, 'coupons' ); $mydata = $report->get_data(); </code></pre>

It uses the name provided in the class property or in the constructor call to load the report-{name} data store.

It's used by the {@see GenericController GenericController}.

Использование

$GenericQuery = new GenericQuery();
// use class methods

Методы

1. public __construct( $args, $name = null )
2. public get_data()
3. protected get_default_query_vars()

Список изменений

Код GenericQuery{} GenericQuery{} ^{WC 9.3.3}

class GenericQuery extends \WC_Object_Query {

	/**
	 * Specific query name.
	 * Will be used to load the `report-{name}` data store,
	 * and to call `woocommerce_analytics_{snake_case(name)}_*` filters.
	 *
	 * @var string
	 */
	protected $name;

	/**
	 * Create a new query.
	 *
	 * @param array  $args Criteria to query on in a format similar to WP_Query.
	 * @param string $name Query name.
	 * @extends WC_Object_Query::_construct
	 */
	public function __construct( $args, $name = null ) {
		$this->name = $name ?? $this->name;

		return parent::__construct( $args ); // phpcs:ignore Universal.CodeAnalysis.ConstructorDestructorReturn.ReturnValueFound
	}
	/**
	 * Valid fields for Products report.
	 *
	 * @return array
	 */
	protected function get_default_query_vars() {
		return array();
	}

	/**
	 * Get data from `report-{$name}` store, based on the current query vars.
	 * Filters query vars through `woocommerce_analytics_{snake_case(name)}_query_args` filter.
	 * Filters results through `woocommerce_analytics_{snake_case(name)}_select_query` filter.
	 *
	 * @return mixed filtered results from the data store.
	 */
	public function get_data() {
		$snake_name = str_replace( '-', '_', $this->name );
		/**
		 * Filter query args given for the report.
		 *
		 * @since 9.3.0
		 *
		 * @param array $query_args Query args.
		 */
		$args = apply_filters( "woocommerce_analytics_{$snake_name}_query_args", $this->get_query_vars() );

		$data_store = \WC_Data_Store::load( "report-{$this->name}" );
		$results    = $data_store->get_data( $args );
		/**
		 * Filter report query results.
		 *
		 * @since 9.3.0
		 *
		 * @param stdClass|WP_Error $results Results from the data store.
		 * @param array             $args    Query args used to get the data (potentially filtered).
		 */
		return apply_filters( "woocommerce_analytics_{$snake_name}_select_query", $results, $args );
	}
}