DefineDashboardExtension

@vendure/dashboard Sourcev3.3.0

The main entry point for extensions to the React-based dashboard. Every dashboard extension must contain a call to this function, usually in the entry point file that is referenced by the dashboard property of the plugin decorator.

Every type of customisation of the dashboard can be defined here, including:

Navigation (nav sections and routes)
Layout (action bar items and page blocks)
Widgets
Form components (custom form components, input components, and display components)
Data tables
Detail forms
Login
Custom history entries

Example

Tsx

defineDashboardExtension({ navSections: [], routes: [], pageBlocks: [], actionBarItems: [],});

Signature

function defineDashboardExtension(extension: DashboardExtension): void

Parameters

extension

parameterDashboardExtension

@vendure/dashboard Sourcev3.3.0

This is the main interface for defining all extensions to the dashboard.

Every type of customisation of the dashboard can be defined here, including:

Navigation (nav sections and routes)
Layout (action bar items and page blocks)
Widgets for the Insights page
Form components
Data tables
Detail forms
Login page customisation

Signature

interface DashboardExtension {    routes?: DashboardRouteDefinition[];    navSections?: DashboardNavSectionDefinition[];    pageBlocks?: DashboardPageBlockDefinition[];    actionBarItems?: DashboardActionBarItem[];    alerts?: DashboardAlertDefinition[];    widgets?: DashboardWidgetDefinition[];    customFormComponents?: DashboardCustomFormComponents;    dataTables?: DashboardDataTableExtensionDefinition[];    detailForms?: DashboardDetailFormExtensionDefinition[];    login?: DashboardLoginExtensions;    historyEntries?: DashboardHistoryEntryComponent[];}

routes

propertyDashboardRouteDefinition[]

Allows you to define custom routes such as list or detail views.

navSections

propertyDashboardNavSectionDefinition[]

Allows you to define custom nav sections for the dashboard.

pageBlocks

propertyDashboardPageBlockDefinition[]

Allows you to define custom page blocks for any page in the dashboard.

actionBarItems

propertyDashboardActionBarItem[]

Allows you to define custom action bar items for any page in the dashboard.

alerts

propertyDashboardAlertDefinition[]

Allows you to define custom alerts that can be displayed in the dashboard.

widgets

propertyDashboardWidgetDefinition[]

Allows you to define custom routes for the dashboard, which will render the given components and optionally also add a nav menu item.

customFormComponents

propertyDashboardCustomFormComponents

Unified registration for custom form custom field components.

dataTables

propertyDashboardDataTableExtensionDefinition[]

Allows you to customize aspects of existing data tables in the dashboard.

detailForms

propertyDashboardDetailFormExtensionDefinition[]

Allows you to customize the detail form for any page in the dashboard.

propertyDashboardLoginExtensions

Allows you to customize the login page with custom components.

historyEntries

propertyDashboardHistoryEntryComponent[]

Allows a custom component to be used to render a history entry item in the Order or Customer history lists.