woocommerce/plugins/woocommerce-admin/client/analytics/report
Joshua T Flowers 3ac97e00c4 Add single category filter to products report (https://github.com/woocommerce/woocommerce-admin/pull/1350)
* Add namespace v4 for WC product/categories endpoint

* Update categories wc-api to use v4 namespace constant

* Add single product category filter to product categories report

* Add link to filtered product report from category report

* Use persistedQuery for category links

* Check if category is defined before displaying category link

* Remove selectedTags when filter does not match queried filter
2019-01-22 01:12:00 +08:00
..
categories Add single category filter to products report (https://github.com/woocommerce/woocommerce-admin/pull/1350) 2019-01-22 01:12:00 +08:00
coupons Add helpText to coupon compare button (https://github.com/woocommerce/woocommerce-admin/pull/1333) 2019-01-18 10:22:51 +08:00
customers Add country code as keyword for countries search (https://github.com/woocommerce/woocommerce-admin/pull/1337) 2019-01-18 11:13:07 +08:00
downloads Makes table dates accessible (https://github.com/woocommerce/woocommerce-admin/pull/1274) 2019-01-14 10:54:44 +01:00
orders Update all wc-admin endpoints to v4 (https://github.com/woocommerce/woocommerce-admin/pull/1298) 2019-01-18 10:52:58 +08:00
products Add single category filter to products report (https://github.com/woocommerce/woocommerce-admin/pull/1350) 2019-01-22 01:12:00 +08:00
revenue Set default order to 'desc' in time tables (https://github.com/woocommerce/woocommerce-admin/pull/1341) 2019-01-17 22:14:12 +01:00
stock REST API: Allow sorting by stock_status in stocks endpoint (https://github.com/woocommerce/woocommerce-admin/pull/1335) 2019-01-22 01:11:20 +08:00
taxes Update/taxes endpoint hookup/941 (https://github.com/woocommerce/woocommerce-admin/pull/1008) 2018-12-18 10:26:46 +08:00
README.md Extensions: Add filter to allow third-party registration of reports (https://github.com/woocommerce/woocommerce-admin/pull/298) 2018-08-20 17:24:17 -04:00
index.js Downloads Report: add summary number, chart and table (https://github.com/woocommerce/woocommerce-admin/pull/1113) 2018-12-19 12:18:43 +01:00
style.scss Add loading indicators, error state, and EmptyContent to the revenue report. (#347, woocommerce/woocommerce-admin#348) 2018-09-05 12:45:49 -04:00

README.md

Reports

The core reports offered by WooCommerce live in this folder. The Header is added automatically by the parent Report component, each individual component should contain just the report contents.

Extending Reports

New reports can be added by third-parties without altering wc-admin, by hooking into the reports filter, woocommerce-reports-list. For example:

addFilter( 'woocommerce-reports-list', 'wc-example/my-report', pages => {
	return [
		...pages,
		{
			report: 'example',
			title: 'My Example Extension',
			component: Report,
		},
	];
} );

Each report is defined by an object containing report, title, component.

  • report (string): The path used to show the report, ex: /analytics/example
  • title (string): The title shown in the breadcrumbs & document title.
  • component (react component): The component containing the report content- everything on the page under the breadcrumbs header.

The component will get the following props:

  • query (object): The query string for the current view, can be used to paginate reports, or sort/filter report data.
  • path (string): The exact path for this view.
  • pathMatch (string): The route matched for this view, should always be /analytics/:report.
  • params (object): This will contain the report from the path, which should match report in the page object.

Note: Adding your page to woocommerce-reports-list does not add the item to the admin menu, you'll need to do that in PHP with wc_admin_register_page.