Important

You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Board Extension 

Enable Board Appearance on a Grid 

To add board appearance on a grid:

  • Navigate to the datagrid.yml file

  • Add the following lines to the datagrid configuration:

datagrids:
    {grid-uid}:
        # <grid configuration> goes here
        appearances:
            board:
                {board-uid}: #unique board id
                    label: Board Label
                    group_by:
                        property: option_set_field
                        order_by:
                            priority: ASC
                    card_view: demobundle/js/app/views/board/your-entity-card-view

Hint

As board appearance uses save_api_accessor internally, make sure that at least one of the following options is appropriately configured:

  • save_api_accessor for column transition option (check documentation)

  • save_api_accessor for default transition (check default_transition configuration option below)

  • save_api_accessor for inline editing (check this article

Datagrid Configuration Details 

  • label (Optional): A label to be shown in the appearance switcher.

  • icon (Optional): The icon class to be shown in the appearance switcher.

  • group_by (Required): Configuration array for column grouping property.

group_by:
    property: status #required, enum property to be used for board columns
    order_by: #optional, used to define a property's field, which should be used for column sort order.
        priority: ASC

  • default_column (Optional): Specifies a column ID to show entities with no value set for group_by property. By default, the first column will be used.

  • plugin (Optional): Specifies the plugin realization. Default orodatagrid/js/app/plugins/grid-component/board-appearance-plugin

  • board_view (Optional): Specifies the view for kanban board. Default orodatagrid/js/app/views/board/board-view

  • card_view (Required): Specifies the view for kanban card.

  • column_header_view (Optional): Specifies the view for board column header. Default orodatagrid/js/app/views/board/column-header-view

  • column_view (Optional): Specifies the view for board column. Default orodatagrid/js/app/views/board/column-view

  • acl_resource (Optional): Enabled Acl resource checks whether board items transitions are allowed. If no permission is granted to a user, they see the board in read only mode.

  • processor (Optional): Specified the name of the board processor. default processor is used by default.

  • default_transition (Optional): Section to specify configuration for the transition, e.g., update property when cards are dragged and dropped from one column to another.

default_transition:
    class: #class to be used for transition
    params: #additional params to pass to transition
        key: value
    save_api_accessor: #Describes the way to send update request. Please see documentation for :ref:`oroui/js/tools/api-accessor <bundle-docs-platform-ui-bundle-apiaccessor>`.

Related Articles