In this article, you'll learn how to edit the landing page of your Data Hub so that it serves your goals best. The article covers the following topics:
- Which customization options are avialable for the landing page?
- How to edit the front page of a Data Hub?
Which customization options are avialable for the landing page?
The main page of a Data Hub can be customized using the Widget Board module. The module allows you to add and manage widgets, their parameters, appearance and location on the home page. There are the following main types of widgets availabe in the Widget Board:
- List of items - a widget for displaying any lists of elements, such as lists of resources from an API, custom lists, or data from a custom dataset. It can be either a vertical or horizontal list of items with or without images.
- Resources - a widgets that can show various resources as a list or as a slider. Resources include dashboards, presentations, datasets or data update notifications.
- Calendar - a widget that allows to present a list of events in a form of slider. It allows to distinguish between past, future and ongoing events as well as to filter events by country and date.
- Headline indicators - a widget that allows to display critical KPIs as cards so that you can moniotor them directly from the home page.
How to edit the front page of a Data Hub?
To edit the main page of a Data Hub, open the Data Hub and switch to the edit mode by clicking a pencil icon at the right side of the home page.
Note: only users with the appropriate admin permissions can enable edit mode. By default, all managers of a Data Hub have edit permissions. This setting is customizable and can be changed.
After you click the pencil icon you get into the Widget Board editor.
Each tile has controls that allow you to customize both the tile itself and all widgets within it.
There are the following controls available:
Width controls allow you to set the width of a column relative to others. Choose from several preset widths.
Buttons with a plus icon above and below the tile allow you to add another tile to this column.
Buttons with a plus icon to the left and right of the tile allow you to add a new column.
The button with the eye icon allows you to hide the tile in view mode.
The button with the pencil icon allows you to configure the widgets in this tile (if there are several widgets, the widget that is currently selected will open for editing by default):
The module allows you to configure all of a widget's parameters, as well as its appearance, if necessary. You can also use custom styles and headers and footers. Each widget has its own settings, but many widgets also have common ones.
Note that the widget settings window consists of of two tabs. The first one contains settings for the functioning of the widget; the second, for its appearance.
The button with the gear icon is responsible for the settings of the tile, allowing you to customize its appearance. It is also possible to set up custom styles and headers and footers.
The button with the ellipsis icon displays additional functions for working with a tile, such as moving a tile to another row, importing / exporting, or deleting a tile.
Top panel of the Widget Board
This panel is displayed only in edit mode. It allows you to perform the following actions with the Widget Board and its dataset:
Change Widget Board name. This is not normally needed, but with the Board Title as Page Title option enabled, this title is displayed in the title on the page.
See the ID of the current Widget Board instance and the language used in it. The ID is unique for each instance. It must be specified when connecting the component in the page code (or the id “home“ is used by default).
Note: there are cases when a Data Hub uses several Widget Board instances switched through the url parameter, or even several instances on one page. In this case, each instance needs its own identifier.
Open the Widget Board settings editor (gear icon). It contains specific settings that may not even be useful.
Import and export Widget Board settings. This can be useful when copying a Widget Board between portals or environments.
Make the dataset public or private. Datasets for storing custom component data should always be public.
Save or discard changes. The functionality of these buttons duplicates similar, floating buttons near the right edge of the page.
The module supports work with different languages. If set correctly, different content will be displayed depending on the selected language.
When users create a dataset, an instance of the Widget Board for the current language is created.
To create an instance of the Widget Board in another language, after saving, switch to another language and try to make changes. When you save the settings, the module will create a new independent instance of the Widget Board for the current language.
Once you create multiple Widget Board instances, it will be necessary to edit the instance for each language independently, switching to the desired language.