Manage Common Controls in the Storefront 

Tables (Grids) 

Views in the form of tables can be considered the most commonly used UI elements in Oro applications. They are interactive, as they not only display data about specific store records but contain links to these records’ pages. Views are also configurable – so you can adjust the appearance and contents of the tables to your taste and needs.

Such tables represent aggregated views of data and store records, making it easy to locate and manage records, with every grid page functionally tailored to the type of information it represents.

../../../../_images/GridSample.png

Location Trail (Breadcrumbs) 

You can trace where the current page is located in the menu in the breadcrumbs under the top navigation bar.

../../../../_images/GridLocationName.png

Display Options 

Views

When browsing the website, buyers have the flexibility to choose how they view content, with three distinct options available: gallery view Grid-SVG, list view List-SVG, or compact view CompactList-SVG.

../../../../_images/GridPages.png

Sorting

Buyers can sort records alphabetically, by price, relevance, or other attributes related to the products displayed on the page you are viewing.

../../../../_images/DispayOptionsSorting.png

Page Navigation

If you have many records, they all may not fit on one data page. In this case, use the pager block in the center above the view table.

In the pager block, you can see the page that you are currently on, the total number of data pages and the total number of records in the view table.

../../../../_images/DisplayOptionsPages.png

You can navigate between pages using the < Prev and > Next page buttons. To open a particular page, type its number in the field that displays the current page and press Enter.

Saved Views 

A saved view is a table with applied filters or custom orders.

The default table view is what you see when you open a view page, it shows unfiltered data.

Tables can be viewed, saved as new ones, shared, renamed, set as default and deleted:

  1. To view the list of available tables: click on the ChevronDown-SVG arrow next to the table name.

    ../../../../_images/SavedView.png
  2. To save a table as a new one: click Save as New.

    • Enter New List Name: Define a name of the new view table.

    • Set as Default: Select this checkbox to set the new table as the default one.

    • Add: Click Add to add a new saved view table.

    • Cancel: Click Cancel to exit.

    ../../../../_images/SaveViewAsDefault.png

    The following actions are available for saved view:

    • share the selected saved view: Bookmark-SVG

    • unshare the selected saved view: BookmarkFilled-SVG

    • set the selected saved view as default: Grid-SVG

    • rename the selected saved view: Pencil-SVG

    • delete the selected saved view: Trash-SVG

    ../../../../_images/saved-view-actions.png

Action Buttons 

Action buttons are on the right of the view page. They enable you to perform a number of actions with records. The set of such buttons varies depending on the type of the view opened.

../../../../_images/GridActionButtons.png

The following action buttons can be available:

  1. Refresh the view table: click Refresh-SVG to update the view table.

  2. Reset the view table: click Reset-SVG to clear view table customization and return to default settings. Reset applies to all filters, records per page and sorting changes that you have made.

  3. Table settings: click Columns-SVG to define which columns to show in the table:

    ../../../../_images/TableSettings.png
    • You can manually select the columns by clicking on the checkbox next to the required field.

    • To show/hide all columns in the table, click Select All/Deselect All.

    • To clear customization, click Reset-SVG Reset.

    • To change the order of the columns, click on the ellipsis icon next to the name of the column you wish to move, hold the mouse button, and drag the column to the required position.

  4. Filters: click Settings-SVG to show/hide filters to select specific items to be shown in the table. More information on filters is provided in the Filters section below.

Filters 

Filters are used when you need to quickly pick out the records you need from the entire data pool.

The following actions are available for filters:

  1. To show/hide filters, click the filter toggle icon Sliders-SVG.

    ../../../../_images/Filters.png

    Note

    Note that not all filters may be visible by default.

  2. To apply a filter, click on its button in the bar and select the required option from the dropdown list.

    ../../../../_images/FiltersSelect.png

    Note

    The dropdown list displays all the attributes available for the products on the page you are currently viewing. If there no products related to the searching attributes, the attributes may be hidden from the dropdown list

    or remain visible but disabled depending on the website configuration when no items matching selected attributes in filters were found.

  1. Another way to apply a filter is to click on its button and specify your query in the control that appears. Note that filter controls might look different depending on the type of data you are going to filter — whether it is textual, numeric, date or option set. After the filter is applied, its query will appear in the control, so you can easily recall how you have filtered the data.

    ../../../../_images/FiltersApplied.png
  1. To remove a filter, click on a cross x after the query.

    If you wish to reset all applied filters, click x Clear All Filters.

Note

Filter in the storefront can be displayed either at the top (default) or in the left sidebar.

The storefront product page illustrating the filter in the left sidebar

Grid Options 

View tables usually contain one or more options applied to specific records within them. These options take the form of individual icons or icons within the ellipsis menu that can be collapsed.

../../../../_images/TableOptions.png ../../../../_images/TableOptions2.png

Note

The types of options available are subject to the type of data contained in the table and to the system configuration.

Mass Delete in Tables 

With mass actions, you can apply one action to multiple items at the same time, which can simplify and speed up the process of selecting the required items.

In the storefront, mass delete action is available in the Address book and Users sections only for the registered users.

../../../../_images/mass_actions_1.png

To use mass delete action in the storefront, you need to be logged into the storefront account.

Product Data Export 

Registered customer users can export products, their prices, and price tiers into a .csv file from the storefront product collection and search results pages, if option Product Grid Export is enabled in the back-office settings.

To download a product data .csv file:

  1. Click on the download icon on the top right of the product grid.

    Export product data from the storefront product collection page
  2. Check your inbox for instructions on how to download the file.

Product Price 

In the storefront, price per item may change depending on the number of items you want to purchase where in the price tier the quantity falls.

Suppose we have one product in the default price list with the following price tiers set in the back-office:

  • 1 item - $76.79

  • 10 items - $72.95

  • 20 items - $69.11

  • 50 items - $65.2

  • 100 items - $61.43

Illustration of price tiers for one product

This means that product price per 1 item will change depending on how many items a buyer wants to purchase. The more they purchase, the cheaper the price per item is going to be in this scenario. The following image illustrates how price tiers are going to be displayed for a user in the storefront.

When a buyer tries to change the quantity of the items, this triggers change in the price per item.

Illustration of the price change after when a user changes product quantity