Create a Landing Page

This procedure adds a new landing page.

Note

To create a new landing page based on settings in an existing landing page, it is recommended that you clone the landing page you want to work with, save it as a new landing page, and edit the settings to create the new landing page.

Perform these steps:

  1. Log in as the provider administrator, or higher.

  2. Choose the hierarchy level for the landing page.

  3. Go to (default menu) Role Management > Landing Pages.

  4. 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.

  5. On the Details tab:

    • Define a name for the new landing page.

    • In Meta Tasks, click the Plus icon (+), then configure the following: button text, model type, Href, field display policy, configuration template, display format (list or form), and fixed and configurable filters (if required).

    • In Counters, click the Plus icon (+), then configure the following: a title for the counter, choose an icon to use, the model type, field display policy, configuration template, and fixed and configurable filters (if required).

    • In Sections, click the Plus icon (+), then configure the landing page sections: provide a title, an image URL, and configure links on the landing page:

      To configure the links, click the Plus icon (+) for each link you want to add to the landing page, and configure the links:

      • Select an icon for the link, and specify the link text.

      • If you want the link to display only in some circumstances, you can use a macro in the Condition field to define criteria that will show or hide the link. The default is True, which means that if no condition is provided, the link displays, else, use a macro to define when to show or hide the link.

      • Select a model type, which will show related field display policies and configuration templates that can be applied.

      • In the Href field, define a link to to be used for external or internal links.

        Note

        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, the Add Phone page would have the following href: 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.

      • Select a Field Display Policy and Configuration Template.

      • From the Custom Component drop-down, select the VOSS portal custom component. See: Custom Components for Menu Layouts and Landing Pages

      • Display As. The link type is displayed as the chosen Display As item:

        Form: Displays an input form (for an Href resource value other than view/ models, a resource ends with /add/).

        Inline List: The link points to the first five list of items.

        List: List view of a resource referenced by Type or Href. If List is chosen as the Display As type, then the resulting list can also be filtered. See Configurable Filters in Menus and Landing Pages.

        Tree: A tree view of resource to display (if the system Href provides a tree path).

    • If you wish to re-arrange the order of items, click the hamburger icon in the first column and drag items to re-order.

  6. On the Welcome Header tab:

    • In Header Text, provide a single line static welcome message for the top of the landing page.
    • In Line Text, provide required line text for the welcome line displayed beneath 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.

  7. Save the landing page.

  8. Assign the landing page to the relevant roles.

Edit a Landing Page

To edit an existing landing page, click on the landing page to open its editing screen. Update settings, and save your changes.