woocommerce/plugins/woocommerce-admin/client/dashboard
Joshua T Flowers 666f740659 Add localized validation to store address (https://github.com/woocommerce/woocommerce-admin/pull/8123)
* Use locale labels for store info

* Get address validation errors based on locale

* Fix validation rules based on locale

* Fix up store address in location task step

* Add changelog entry
2022-01-14 08:39:25 -05:00
..
components Add localized validation to store address (https://github.com/woocommerce/woocommerce-admin/pull/8123) 2022-01-14 08:39:25 -05:00
dashboard-charts Remove unpublished wc-admin-settings package and update getSetting usage (https://github.com/woocommerce/woocommerce-admin/pull/8057) 2022-01-06 08:53:30 -04:00
leaderboards Remove unpublished wc-admin-settings package and update getSetting usage (https://github.com/woocommerce/woocommerce-admin/pull/8057) 2022-01-06 08:53:30 -04:00
store-performance Remove unpublished wc-admin-settings package and update getSetting usage (https://github.com/woocommerce/woocommerce-admin/pull/8057) 2022-01-06 08:53:30 -04:00
test Task list - add a shortcut back to store setup (https://github.com/woocommerce/woocommerce-admin/pull/4853) 2020-08-06 10:02:24 +12:00
README.md Remove the use of Dashicons and replace with `@wordpress/icons` or `gridicons` (https://github.com/woocommerce/woocommerce-admin/pull/7020) 2021-05-25 12:14:14 -03:00
customizable.js Make sure defaultSections is a unique object, so we do not remove icon (https://github.com/woocommerce/woocommerce-admin/pull/7475) 2021-08-09 17:32:51 -03:00
default-sections.js Remove the use of Dashicons and replace with `@wordpress/icons` or `gridicons` (https://github.com/woocommerce/woocommerce-admin/pull/7020) 2021-05-25 12:14:14 -03:00
index.js Feature Flags: Removed unused flags (https://github.com/woocommerce/woocommerce-admin/pull/7233) 2021-06-30 11:47:38 +12:00
section-controls.js Sentence case all the things analytics (https://github.com/woocommerce/woocommerce-admin/pull/6501) 2021-08-13 14:54:24 -04:00
section.js Add @woocommerce/eslint-plugin (https://github.com/woocommerce/woocommerce-admin/pull/4714) 2020-07-28 14:32:58 +12:00
style.scss Tests for task list components (https://github.com/woocommerce/woocommerce-admin/pull/7757) 2021-10-15 16:56:17 -03:00
utils.js Remove unpublished wc-admin-settings package and update getSetting usage (https://github.com/woocommerce/woocommerce-admin/pull/8057) 2022-01-06 08:53:30 -04:00

README.md

Dashboard

This folder contains the components used in the Dashboard page.

Extending the Dashboard

New Dashboard sections can be added by hooking into the filter woocommerce_dashboard_default_sections. For example:

import { arrowRight } from '@wordpress/icons';
addFilter( 'woocommerce_dashboard_default_sections', ( sections ) => {
	return [
		...sections,
		{
			key: 'example',
			component: ExampleSection,
			title: 'My Example Dashboard Section',
			isVisible: true,
			icon: arrowRight,
			hiddenBlocks: [],
		},
	];
} );

Each section is defined by an object containing the following properties.

  • key (string): The key used internally to identify the section.
  • title (string): The title shown in the Dashboard. It can be modified by users.
  • icon (function|WPComponent|null): Icon to be used to identify the section.
  • component (react component): The component containing the section content.
  • isVisible (boolean): Whether the section is visible by default. Sections can be added/hidden by users.
  • hiddenBlocks (array of strings): The keys of the blocks that must be hidden by default. Used in Sections that contain several blocks that can be shown or hidden. It can be modified by users.

The component will get the following props:

  • hiddenBlocks (array of strings): Hidden blocks according to the default settings or the user preferences if they had made any modification.
  • isFirst (boolean): Whether the component is the first one shown in the Dashboard.
  • isLast (boolean): Whether the component is the last one shown in the Dashboard.
  • onMove (boolean): Event to trigger when moving the section.
  • onRemove (boolean): Event to trigger when removing the section.
  • onTitleBlur (function): Event to trigger when the edit title input box is unfocused.
  • onTitleChange (function): Event to trigger when the edit title input box receives a change event.
  • onToggleHiddenBlock (function): Event to trigger when the user toggles one of the hidden blocks preferences.
  • titleInput (string): Current string to be displayed in the edit title input box. Title is only updated on blur, so this value will be different than title when the user is modifying the input box.
  • path (string): The exact path for this view.
  • query (object): The query string for the current view, can be used to read current preferences for time periods or chart interval/type.
  • title (string): Title of the section according to the default settings or the user preferences if they had made any modification.
  • controls (react component): Controls to move a section up/down or remove it from view to be rendered inside the EllipsisMenu.