Getting Started with Navigation and UI¶
Oro applications offer high flexibility and customization, which means that the user interface of the stores may differ. However, the integral parts that constitute the interface are cross-functional.
The screenshots in this guide are provided for illustration purposes only, as layouts and available functionality may vary as the result of customization.
The key elements of the front store menu are represented below.
Links are placed at the top right of the page.
User Menu is located on the top left of the page and contains the following sections:
For non-authenticated user (guest):
The Sign In button.
For a user that has signed in:
The name of the signed in user, e.g. Signed in as: Amanda Cole.
A link to the user account.
The Sign Out button.
Quick Access Menu¶
Quick access menu provides quick access to the most frequent or important actions:
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.
In the top left corner of the view page, you can see where the current page is located in the menu. The name of the selected view table is usually located in the row below.
Sorting options are located on the left of the view page under the view table name below the filter. They allow sorting records alphabetically, by price or relevance.
Layout options are located on the far right under the view table name.
The following layout options are available:
- Compact Details:
If you have a lot of records, they all may not fit in 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.
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.
A saved view is a table with applied filters or custom ordering.
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:
- To view the list of available tables: click on the arrow next to the table name.
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.
To share the selected saved view: click
To unshare the selected saved view: click
To set the selected saved view as default: click
To rename the selected saved view: click
To delete the selected saved view: click
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.
The following action buttons can be available:
Refresh the view table: click to update the view table.
Reset the view table: click 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.
Table settings: click to define which columns to show in the table:
- 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.
- 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.
Filters: click 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 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:
To show/hide filters, click
Note that not all filters may be visible by default.
To add, remove, search or reset filters, click and perform the required action.
To apply a filter, click on its button in the bar, 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.
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.
The following example is an illustration of filters in action:
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.
The types of options available are subject to the type of data contained in the table and to the system configuration.