woocommerce/plugins/woocommerce-admin/client/analytics/report/customers/config.js

/**
 * External dependencies
 */
import { __, _x } from '@wordpress/i18n';
import { decodeEntities } from '@wordpress/html-entities';
import { applyFilters } from '@wordpress/hooks';
import { resolveSelect } from '@wordpress/data';
import { NAMESPACE, COUNTRIES_STORE_NAME } from '@woocommerce/data';

/**
 * Internal dependencies
 */
import {
	getCustomerLabels,
	getRequestByIdString,
} from '../../../lib/async-requests';

const CUSTOMERS_REPORT_FILTERS_FILTER =
	'woocommerce_admin_customers_report_filters';
const CUSTOMERS_REPORT_ADVANCED_FILTERS_FILTER =
	'woocommerce_admin_customers_report_advanced_filters';

/**
 * @typedef {import('../index.js').filter} filter
 */

/**
 * Customers Report Filters.
 *
 * @filter woocommerce_admin_customers_report_filters
 * @param {Array.<filter>} filters Report filters.
 */
export const filters = applyFilters( CUSTOMERS_REPORT_FILTERS_FILTER, [
	{
		label: __( 'Show', 'woocommerce' ),
		staticParams: [ 'paged', 'per_page' ],
		param: 'filter',
		showFilters: () => true,
		filters: [
			{ label: __( 'All Customers', 'woocommerce' ), value: 'all' },
			{
				label: __( 'Single Customer', 'woocommerce' ),
				value: 'select_customer',
				chartMode: 'item-comparison',
				subFilters: [
					{
						component: 'Search',
						value: 'single_customer',
						chartMode: 'item-comparison',
						path: [ 'select_customer' ],
						settings: {
							type: 'customers',
							param: 'customers',
							getLabels: getCustomerLabels,
							labels: {
								placeholder: __(
									'Type to search for a customer',
									'woocommerce'
								),
								button: __( 'Single Customer', 'woocommerce' ),
							},
						},
					},
				],
			},
			{
				label: __( 'Advanced filters', 'woocommerce' ),
				value: 'advanced',
			},
		],
	},
] );

/*eslint-disable max-len*/
/**
 * Customers Report Advanced Filters.
 *
 * @filter woocommerce_admin_customers_report_advanced_filters
 * @param {Object} advancedFilters         Report Advanced Filters.
 * @param {string} advancedFilters.title   Interpolated component string for Advanced Filters title.
 * @param {Object} advancedFilters.filters An object specifying a report's Advanced Filters.
 */
export const advancedFilters = applyFilters(
	CUSTOMERS_REPORT_ADVANCED_FILTERS_FILTER,
	{
		title: _x(
			'Customers match <select/> filters',
			'A sentence describing filters for Customers. See screen shot for context: https://cloudup.com/cCsm3GeXJbE',
			'woocommerce'
		),
		filters: {
			name: {
				labels: {
					add: __( 'Name', 'woocommerce' ),
					placeholder: __( 'Search', 'woocommerce' ),
					remove: __( 'Remove customer name filter', 'woocommerce' ),
					rule: __(
						'Select a customer name filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a Product filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Name</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select customer name', 'woocommerce' ),
				},
				rules: [
					{
						value: 'includes',
						/* translators: Sentence fragment, logical, "Includes" refers to customer names including a given name(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Includes',
							'customer names',
							'woocommerce'
						),
					},
					{
						value: 'excludes',
						/* translators: Sentence fragment, logical, "Excludes" refers to customer names excluding a given name(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Excludes',
							'customer names',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Search',
					type: 'customers',
					getLabels: getRequestByIdString(
						NAMESPACE + '/customers',
						( customer ) => ( {
							id: customer.id,
							label: customer.name,
						} )
					),
				},
			},
			country: {
				labels: {
					add: __( 'Country / Region', 'woocommerce' ),
					placeholder: __( 'Search', 'woocommerce' ),
					remove: __(
						'Remove country / region filter',
						'woocommerce'
					),
					rule: __(
						'Select a country / region filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a Product filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Country / Region</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select country / region', 'woocommerce' ),
				},
				rules: [
					{
						value: 'includes',
						/* translators: Sentence fragment, logical, "Includes" refers to countries including a given country or countries. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Includes', 'countries', 'woocommerce' ),
					},
					{
						value: 'excludes',
						/* translators: Sentence fragment, logical, "Excludes" refers to countries excluding a given country or countries. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Excludes', 'countries', 'woocommerce' ),
					},
				],
				input: {
					component: 'Search',
					type: 'countries',
					getLabels: async ( value ) => {
						const countries = await resolveSelect(
							COUNTRIES_STORE_NAME
						).getCountries();

						const allLabels = countries.map( ( country ) => ( {
							key: country.code,
							label: decodeEntities( country.name ),
						} ) );

						const labels = value.split( ',' );
						return await allLabels.filter( ( label ) => {
							return labels.includes( label.key );
						} );
					},
				},
			},
			username: {
				labels: {
					add: __( 'Username', 'woocommerce' ),
					placeholder: __(
						'Search customer username',
						'woocommerce'
					),
					remove: __(
						'Remove customer username filter',
						'woocommerce'
					),
					rule: __(
						'Select a customer username filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a customer username filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Username</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select customer username', 'woocommerce' ),
				},
				rules: [
					{
						value: 'includes',
						/* translators: Sentence fragment, logical, "Includes" refers to customer usernames including a given username(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Includes',
							'customer usernames',
							'woocommerce'
						),
					},
					{
						value: 'excludes',
						/* translators: Sentence fragment, logical, "Excludes" refers to customer usernames excluding a given username(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Excludes',
							'customer usernames',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Search',
					type: 'usernames',
					getLabels: getCustomerLabels,
				},
			},
			email: {
				labels: {
					add: __( 'Email', 'woocommerce' ),
					placeholder: __( 'Search customer email', 'woocommerce' ),
					remove: __( 'Remove customer email filter', 'woocommerce' ),
					rule: __(
						'Select a customer email filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a customer email filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Email</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select customer email', 'woocommerce' ),
				},
				rules: [
					{
						value: 'includes',
						/* translators: Sentence fragment, logical, "Includes" refers to customer emails including a given email(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Includes',
							'customer emails',
							'woocommerce'
						),
					},
					{
						value: 'excludes',
						/* translators: Sentence fragment, logical, "Excludes" refers to customer emails excluding a given email(s). Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Excludes',
							'customer emails',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Search',
					type: 'emails',
					getLabels: getRequestByIdString(
						NAMESPACE + '/customers',
						( customer ) => ( {
							id: customer.id,
							label: customer.email,
						} )
					),
				},
			},
			orders_count: {
				labels: {
					add: __( 'No. of Orders', 'woocommerce' ),
					remove: __( 'Remove order filter', 'woocommerce' ),
					rule: __(
						'Select an order count filter match',
						'woocommerce'
					),
					title: __(
						'<title>No. of Orders</title> <rule/> <filter/>',
						'woocommerce'
					),
				},
				rules: [
					{
						value: 'max',
						/* translators: Sentence fragment, logical, "Less Than" refers to number of orders a customer has placed, less than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Less Than',
							'number of orders',
							'woocommerce'
						),
					},
					{
						value: 'min',
						/* translators: Sentence fragment, logical, "More Than" refers to number of orders a customer has placed, more than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'More Than',
							'number of orders',
							'woocommerce'
						),
					},
					{
						value: 'between',
						/* translators: Sentence fragment, logical, "Between" refers to number of orders a customer has placed, between two given integers. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Between',
							'number of orders',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Number',
				},
			},
			total_spend: {
				labels: {
					add: __( 'Total Spend', 'woocommerce' ),
					remove: __( 'Remove total spend filter', 'woocommerce' ),
					rule: __(
						'Select a total spend filter match',
						'woocommerce'
					),
					title: __(
						'<title>Total Spend</title> <rule/> <filter/>',
						'woocommerce'
					),
				},
				rules: [
					{
						value: 'max',
						/* translators: Sentence fragment, logical, "Less Than" refers to total spending by a customer, less than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Less Than',
							'total spend by customer',
							'woocommerce'
						),
					},
					{
						value: 'min',
						/* translators: Sentence fragment, logical, "Less Than" refers to total spending by a customer, more than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'More Than',
							'total spend by customer',
							'woocommerce'
						),
					},
					{
						value: 'between',
						/* translators: Sentence fragment, logical, "Between" refers to total spending by a customer, between two given amounts. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Between',
							'total spend by customer',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Currency',
				},
			},
			avg_order_value: {
				labels: {
					add: __( 'AOV', 'woocommerce' ),
					remove: __(
						'Remove average order value filter',
						'woocommerce'
					),
					rule: __(
						'Select an average order value filter match',
						'woocommerce'
					),
					title: __(
						'<title>AOV</title> <rule/> <filter/>',
						'woocommerce'
					),
				},
				rules: [
					{
						value: 'max',
						/* translators: Sentence fragment, logical, "Less Than" refers to average order value of a customer, more than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Less Than',
							'average order value of customer',
							'woocommerce'
						),
					},
					{
						value: 'min',
						/* translators: Sentence fragment, logical, "Less Than" refers to average order value of a customer, less than a given amount. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */

						label: _x(
							'More Than',
							'average order value of customer',
							'woocommerce'
						),
					},
					{
						value: 'between',
						/* translators: Sentence fragment, logical, "Between" refers to average order value of a customer, between two given amounts. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x(
							'Between',
							'average order value of customer',
							'woocommerce'
						),
					},
				],
				input: {
					component: 'Currency',
				},
			},
			registered: {
				labels: {
					add: __( 'Registered', 'woocommerce' ),
					remove: __( 'Remove registered filter', 'woocommerce' ),
					rule: __(
						'Select a registered filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a Product filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Registered</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select registered date', 'woocommerce' ),
				},
				rules: [
					{
						value: 'before',
						/* translators: Sentence fragment, logical, "Before" refers to customers registered before a given date. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Before', 'date', 'woocommerce' ),
					},
					{
						value: 'after',
						/* translators: Sentence fragment, logical, "after" refers to customers registered after a given date. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'After', 'date', 'woocommerce' ),
					},
					{
						value: 'between',
						/* translators: Sentence fragment, logical, "Between" refers to average order value of a customer, between two given amounts. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Between', 'date', 'woocommerce' ),
					},
				],
				input: {
					component: 'Date',
				},
			},
			last_active: {
				labels: {
					add: __( 'Last active', 'woocommerce' ),
					remove: __( 'Remove last active filter', 'woocommerce' ),
					rule: __(
						'Select a last active filter match',
						'woocommerce'
					),
					/* translators: A sentence describing a Product filter. See screen shot for context: https://cloudup.com/cCsm3GeXJbE */
					title: __(
						'<title>Last active</title> <rule/> <filter/>',
						'woocommerce'
					),
					filter: __( 'Select registered date', 'woocommerce' ),
				},
				rules: [
					{
						value: 'before',
						/* translators: Sentence fragment, logical, "Before" refers to customers registered before a given date. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Before', 'date', 'woocommerce' ),
					},
					{
						value: 'after',
						/* translators: Sentence fragment, logical, "after" refers to customers registered after a given date. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'After', 'date', 'woocommerce' ),
					},
					{
						value: 'between',
						/* translators: Sentence fragment, logical, "Between" refers to average order value of a customer, between two given amounts. Screenshot for context: https://cloudup.com/cCsm3GeXJbE */
						label: _x( 'Between', 'date', 'woocommerce' ),
					},
				],
				input: {
					component: 'Date',
				},
			},
		},
	}
);
/*eslint-enable max-len*/