.. _landing_pages:
Landing Pages
-------------
.. _21.3|EKB-8094:
Overview
...........
A landing page is the page you see when you log in, or when clicking the **Home** button
from anywhere in the system, or when choosing a menu item that has been defined as a landing page.
A default landing page ships with the system, and is associated with pre-defined roles in
the hierarchy, for example Provider, Customer, and Site administrators.
.. note::
This topic describes functionality as displayed in the Admin Portal. The look and
feel of landing page and menu layout configuration options may differ in the classic Admin GUI.
|landing-page-provider-home|
Customized Landing Pages
'''''''''''''''''''''''''''
Landing pages may be customized for different user roles, and have several configuration
options:
* Add shortcut links to frequently used functionality
* Enhance the look and feel on the user's Admin Portal
* Add images and links in vertical or horizontal patterns with unlimited boxes and
shortcuts
Editable landing pages provide a way to set up direct links
to areas in the system, which can be used as short-cuts by the administrators in
line with their role.
Existing images can be used or new images can be added in line with branded
look and feel.
You may clone (copy) existing landing pages and then create a new landing page based on pre-populated
settings, or the landing page can be exported, edited externally, and then re-imported. Designers
with access to the tag function can use tag versions to uniquely identify different landing
pages, and to track and control changes.
The CSS of the Theme can be used to control the layout of the landing page.
|customize-landing-page|
.. rubric:: Related Topics
*
.. raw:: latex
Menu Layouts in the Core Feature Guide
.. raw:: html
Menu Layouts
*
.. raw:: latex
Advanced Configuration Guide
.. raw:: html
Advanced Configuration Guide
*
.. raw:: latex
Macros in VOSS Automate in the Core Feature Guide
.. raw:: html
Macros in VOSS Automate
*
.. raw:: latex
Fixed and Configurable Filters in Menus and Landing Pages in the Core Feature Guide
.. raw:: html
Fixed and Configurable Filters in Menus and Landing Pages
*
.. raw:: latex
Custom Icon Names Reference in the Core Feature Guide
.. raw:: html
Custom Icon Names Reference
*
.. raw:: latex
Custom Components for Menu Layouts and Landing Pages in the Core Feature Guide
.. raw:: html
Custom Components for Menu Layouts and Landing Pages
.. _create_a_landing_page:
Add or Edit a Landing Page
............................
.. _19.3.1|VOSS-546|EKB-3607:
.. _21.1|VOSS-770|EKB-9491:
This procedure adds a new landing page or edits an existing landing page.
1. Log in to the Admin Portal as a Provider administrator, or higher.
#. Choose the hierarchy level for the landing page, for example, Customer.
#. Go to (default menu) **Role Management > Landing Pages**.
#. Choose an option:
* To create a new landing page based on settings in an existing landing page (recommended),
click on the relevant landing page to open its editing screen, then click **Clone**. Now
modify the settings of the cloned landing page and save it as a new landing page.
* To edit an existing landing page, click on the landing page in the list view
to open its editing screen, update its settings, and save your changes.
#. On the **Details** tab, configure the following options for the landing page:
.. note::
* For configuration details, see :ref:`reference-landing-pages-fields`
* Rows with nested items or links contain a chevron (>) instead of a Plus icon (+) so that
you can see which items have child lists.
* An asterisk indicates required values.
* Add a name
* Configure meta tasks (button text, model type, Href, FDP, CFT, display format, filters)
* Configure counters (filters, icon, title, model type, FDP, CFT).
* Configure sections, and links in sections.
#. On the **Welcome Header**, configure the following options:
.. note::
For configuration details, see :ref:`reference-landing-pages-fields`
* Header text
* Line text
#. Save the landing page.
#. Assign the landing page to the relevant roles.
.. _reference-landing-pages-fields:
Landing Pages Field Reference
.................................
.. _20.1.1|EKB-4170:
This section describes landing page configuration options:
.. note::
You can view, add, and edit landing pages in the Admin Portal
via (default menus) **Role Management > Landing Pages**. See :ref:`create_a_landing_page`
**You can select the following tabs on the Landing Pages add/edit screen**:
* Details tab
* Welcome Header tab
Details Tab
''''''''''''
The Details tab defines the following options for the landing page:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+-----------------------------------+------------------------------------------------------------------------------------------+
| Column | Description |
+===================================+==========================================================================================+
| Name | The name of the landing page. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Meta Tasks | These rows display the shortcut buttons (one or more) at the top of the home page |
| | screen (directly below the line text, if configured). Click in the row to edit an |
| | existing shortcut button, or click the Plus icon (+) to add a new shortcut button. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Counters | These rows display the model-type instance counts (one or more) that display on the |
| | landing page. Click in a row to edit an existing counter, or click the Plus icon |
| | (+) to add a new counter. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Sections | These rows display the sections (one or more) that display as blocks on the landing |
| | page. Click on an item to edit it, or click the Plus (+) icon to add a new section. |
| | Use the hamburger icon to re-order the sections. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Links | Configures links in sections on landing pages. |
+-----------------------------------+------------------------------------------------------------------------------------------+
.. rubric:: Common functionality
The table describes edit functionality typically available for landing page elements:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+-----------------------------------+------------------------------------------------------------------------------------------+
| Column | Description |
+===================================+==========================================================================================+
| Reorder | Click on the reorder icon in the relevant row to change the location of a landing page |
| | element. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Add, clone, or delete row | Click an icon to either add a row, clone (copy) a row, or to delete the row. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Type | The model type to associate with the landing page element. Blank when href field is |
| | populated. The model type shows the related FDPs (field display policies) and CFTs |
| | (configuration templates) that can be applied. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Href | Hrefs are generally recommended for external links. For backwards compatibility, hrefs |
| | can be used for links within the application to link directly to a form. For example, |
| | (example API URL for a list of items of type relation/SubscriberPhone) the **Add Phone** |
| | page would have the following href (API URL): |
| | ``api/relation/SubscriberPhone/add`` |
| | |
| | In this case, you'll need to use JSON-format landing page import, or bulk load, to add |
| | any associated field display policies (FDPs) and configuration templates for the menu |
| | item. The recommendation is not to use Hrefs to reference view/ type models. |
| | |
| | Href is a direct reference to a model type (the path), if applicable. If |
| | used, the **Type** field is empty. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Field Display Policy | The field display policy associated with the landing page element. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Configuration Template | The configuration template associated with the landing page element. |
+-----------------------------------+------------------------------------------------------------------------------------------+
.. rubric:: Meta Tasks
The table describes Meta Tasks configuration options:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+-----------------------------------+------------------------------------------------------------------------------------------+
| Column | Description |
+===================================+==========================================================================================+
| Button Text | Text for the button. |
+-----------------------------------+------------------------------------------------------------------------------------------+
.. rubric:: Counters
The table describes configuration options for Counters:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+-----------------------------------+------------------------------------------------------------------------------------------+
| Column | Description |
+===================================+==========================================================================================+
| Icon | The icon to be used for this counter. |
+-----------------------------------+------------------------------------------------------------------------------------------+
| Title | Mandatory. The title to be displayed for this counter, for example, *Phones*, *Users*. |
+-----------------------------------+------------------------------------------------------------------------------------------+
.. rubric:: Sections
The table describes configuration options for Sections:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Column | Description |
+==================================================+===========================================================================================+
| Links | Displays a Links table where you can configure links in the section. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Title | Mandatory. The section title as it will show on the Landing page. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Image URL | Optional URL image to be displayed as section image. For example, let's say a theme is |
| | uploaded with landing page images, and the theme folder has a subfolder with the |
| | following file: *mytheme/img/landingpage/landing1.png* |
| | |
| | In this case, the URL would be: */www/themes/mytheme/img/landingpage/landing1.png* |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Condition | Click in the cell to add or edit a macro that allows you to display/hide the section, |
| | based on a condition specified in a macro. If the macro evaluates to true, the section |
| | displays, else, when false, the section is hidden. |
| | The default is true (sections you add display by default). |
| | See the Advanced Configuration Guide for more information about using macros. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
.. rubric:: Links
The table describes configuration options for Links in sections on a landing page:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Column | Description |
+==================================================+===========================================================================================+
| Filters | Click the filter icon in the relevant row to display a dialog where you can choose fixed |
| | and configurable filters for the link. |
| | |
| | Fixed filters cannot be removed. The following options are available for configurable |
| | filters for links: |
| | |
| | * Columns (Displays only when *Display As* option is *Inline List*, and the value for |
| | *Display Multiple Columns* is set to *Yes*) |
| | * Filter By |
| | * Filter Type |
| | * Filter String |
| | |
| | |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Icon | The icon to use for the link. Click in the cell to choose an icon. Icons display |
| | in the drop-down with a descriptive name. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Display Multiple Columns | Available only when **Display As** option is *Inline List*. Defines whether the link |
| | displays as multiple columns. When set to Yes (select the checkbox in the field), you |
| | can set column values in the filters for this link. When set to No, the filters do not |
| | have an option to specify columns. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Link Text | Mandatory. Text for the link. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
.. tabularcolumns:: |p{5cm}|p{10cm}|
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Column | Description |
+==================================================+===========================================================================================+
| Condition | Optional. Specify a macro as a condition to define whether the link displays on the |
| | landing page. If the macro evaluates to True (default), the link displays. See the |
| | Advanced Configuration Guide for more information about using macros as conditional |
| | criteria. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Href | If a direct reference to a model type is used for the menu item, the specified path. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Custom Component | Click in the cell to choose an Admin Portal custom components. Options in the drop-down |
| | depend on the model you choose in the **Type** field. For example, when choosing model |
| | type `view/AddPhone`, the custom component available for selection is **Add Phone**. The |
| | custom components allow you to display GUI content (such as landing pages, lists, and |
| | forms) in the same layout as they appear in the Business Admin Portal. |
| | |
| | Custom components are also available for multi vendor environments and for |
| | Microsoft-only environments. |
| | This feature is only available in the new VOSS Automate Admin Portal. |
| | |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
.. tabularcolumns:: |p{5cm}|p{10cm}|
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
| Column | Description |
+==================================================+===========================================================================================+
| Display As | Click in the cell to choose how the menu item should display. The default is `List`. |
| | |
| | Options are: List, Landing Page, Form, External Link, Tree |
| | |
| | * List (default) |
| | |
| | For two or more instances. If you |
| | choose List, and you've selected a default FDP and |
| | CFT for the model type, users with a user role associated with the menu layout view the |
| | model type based on these options. It is also possible to filter the list view. |
| | |
| | If you choose List display referenced by Type or Href, note that a tool |
| | (``tool/[toolname]``) can also be presented as a list, for example: |
| | ``/api/tool/Transaction/?entity=data/Event&operation=execute`` |
| | |
| | * Inline List |
| | |
| | The link points to the first five list of items. When choosing this option, you can |
| | choose Yes or No for option **Display as Multiple Columns**. When set to Yes, you can |
| | define columns in the filters for this link. |
| | |
| | * Landing Page |
| | |
| | Allows you to choose an existing landing page, which will |
| | display when this menu item is chosen. |
| | |
| | This option is *only* available in the VOSS Admin Portal GUI. |
| | |
| | * Form (for a single instance) |
| | |
| | Displays an input form (for an Href resource value other than view/models, a resource |
| | ends with /add/). If you're using href and you choose the Form display, the href value |
| | points to a model instance with the pkid, for example |
| | ``data/Countries/5331a739d0278d7893e26d2e``, or ends with ``/add/``. |
| | The ``view/`` model types always open the *Add* form; thus, if used, the value should |
| | not have the ``/add/`` endpoint, for example, as in this JSON: |
| | |
| | :: |
| | |
| | { |
| | "type": "view/QuickSubscriber", |
| | "display": "form", |
| | "title": "Quick Add Subscriber" |
| | } |
| | |
| | * External Link |
| | |
| | Recommended for use with href, where a URL specified as the href value opens as a new |
| | browser tab. You'll need to disable pop-up blocking on the users browsers to allow the |
| | external link to resolve. |
| | |
| | * Tree (if available, for two or more instances) |
| | |
| | Choosing a Tree display shows a tree view of the resource. When using href with Tree |
| | display, the href provides the tree path. |
+--------------------------------------------------+-------------------------------------------------------------------------------------------+
.. rubric:: Related Topics
* :ref:`filters_in_menus_and_landing_pages`
* :ref:`landing_pages`
* :ref:`create_a_landing_page`
* :ref:`voss-custom-components`
Welcome Header Tab
''''''''''''''''''''
The table describes the fields on the Welcome Header tab for landing page configuration:
.. tabularcolumns:: |p{5cm}|p{10cm}|
+--------------+---------------------------------------------------------------------------------------------------------------------------+
| Field | Description |
+==============+===========================================================================================================================+
| Header Text | A single line static welcome message displayed at the top of the landing page. |
+--------------+---------------------------------------------------------------------------------------------------------------------------+
| Line Text | Text for the welcome line displayed under the header. Use [userrole] as a placeholder to insert the current user's role, |
| | to serve as the header. For example: ``/www/img/landingPageIcons/User.png`` |
+--------------+---------------------------------------------------------------------------------------------------------------------------+
.. |landing-page-provider-home| image:: /src/images/landing-page-provider-home.png
.. |customize-landing-page| image:: /src/images/customize-landing-page.png