c6a6e737c4
* Add customer functions to order and refund classes * Extract shared order and refund methods to trait * Add refund filter to advanced filters in orders report * Filter refund types in orders data store * Extract refunds subquery to parent report data store method * Add refund subquery filtering to order stats data store * Add tests around refund type filtering * Change the default option for the refunds filter |
||
---|---|---|
.. | ||
categories | ||
coupons | ||
customers | ||
downloads | ||
orders | ||
products | ||
revenue | ||
stock | ||
taxes | ||
README.md | ||
index.js | ||
style.scss |
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 thereport
from the path, which should matchreport
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.