woocommerce/plugins/woocommerce-admin/client/analytics/report
Joshua T Flowers 000d666096 Add tax filtering to orders data (https://github.com/woocommerce/woocommerce-admin/pull/3197)
* Add tax rates filter to orders report

* Add tax rate filters to orders data store

* Add tax rate query filters to order stats data store

* Add tax rate orders link to taxes table
2019-11-13 11:22:06 +08:00
..
categories Address revenue discrepancies (https://github.com/woocommerce/woocommerce-admin/pull/3095) 2019-10-25 09:29:09 -03:00
coupons Remove "filter" from the report charts filter names. 2019-08-28 07:55:55 -07:00
customers wcSettings: fix countries getSettings (https://github.com/woocommerce/woocommerce-admin/pull/2974) 2019-10-01 10:43:26 +13:00
downloads Remove "filter" from the report charts filter names. 2019-08-28 07:55:55 -07:00
orders Add tax filtering to orders data (https://github.com/woocommerce/woocommerce-admin/pull/3197) 2019-11-13 11:22:06 +08:00
products Address revenue discrepancies (https://github.com/woocommerce/woocommerce-admin/pull/3095) 2019-10-25 09:29:09 -03:00
revenue Remove "filter" from the report charts filter names. 2019-08-28 07:55:55 -07:00
stock Refactor: Alternative approach to implementing extendable settings from the server (https://github.com/woocommerce/woocommerce-admin/pull/2917) 2019-09-23 17:47:08 -04:00
taxes Add tax filtering to orders data (https://github.com/woocommerce/woocommerce-admin/pull/3197) 2019-11-13 11:22:06 +08:00
README.md update analytics report readme 2019-04-29 08:58:33 -03:00
index.js Refactor: Alternative approach to implementing extendable settings from the server (https://github.com/woocommerce/woocommerce-admin/pull/2917) 2019-09-23 17:47:08 -04:00
style.scss Update Card component to use Muriel design (https://github.com/woocommerce/woocommerce-admin/pull/2252) 2019-05-22 16:38:25 +08: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 woocommerce-admin, by hooking into the reports filter, woocommerce_admin_reports_list. For example:

addFilter( 'woocommerce_admin_reports_list', 'analytics/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_admin_reports_list does not add the item to the admin menu, you'll need to do that in PHP with the woocommerce_admin_report_menu_items filter.