When you create a page, you can make it available on the portal. To do this, you need to create the portal node, that will bind your page with the portal record.

The following diagram illustrates a typical portal structure:

Integrate a page into a portal


To integrate a page into the portal, you need to complete the step below:

  1. Create a portal record.
  2. Create a portal node.
  3. Create a page.

You should consider portal structure first before configuring. So it should have at least one portal node and at least one page to work properly. Otherwise, it will not display correctly.

Create a portal record

Create a portal record, so you will be able to bind a page, its elements, and a portal node to it.

To create a single portal, complete the steps below:

  1. Navigate to Portal Structure → Portals.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

When filling in the Path Name field, keep in mind, that this is the URL suffix of your future portal, so fill in this field carefully.



FieldMandatoryDescription
TitleNSpecify an internal portal title.
Path NameN

Specify a suffix to use in a portal URL. For example, if you type portal, the instance URL for this portal will be <your_instance_url>/portal

This value should be unique and cannot be used by other portals.


LogoNSpecify a portal logo appearing in the page header.
FaviconNSpecify a portal favicon appearing in the header.

SCSS variables

NDefine the portal-specific SCSS classes developed to customize the portal.

SCSS styles

NDefine the portal-specific SCSS styles developed to customize the portal.
Active
Select the checkbox to make the portal active or inactive.
Login PageNSpecify a login page for the portal, selecting a preferred one from the dictionary. You can skip this step and get back to it later after you create the necessary pages.
Home PageNSpecify a home page for the portal, selecting a preferred one from the dictionary. You can skip this step and get back to it later after creating the necessary pages.
404 PageNSpecify a 404 error page for the portal, selecting a preferred one from the dictionary. You can skip this step and get back to it later after creating the necessary pages.
Footer ContainerNSpecify a portal footer, selecting a preferred one from the container list. You can skip this step and get back to it later after creating the necessary containers.
Header ContainerNSpecify a portal header, selecting a preferred one from the container list. You can skip this step and get back to it later after creating the necessary containers.
Header Navigation MenuNSpecify a reference to portal header menu that is implemented with the corresponding tree.


Create a portal node

Within the portal node, there are two various essence types are used to configure portal structure:

  • Portal nodes are massive structural components defining layouts of portals, categories, and pages through the Page field.
  • Categories and items are pages that bind child objects based on the same features. Categories are any structures based on parent-child relationships, e.g., Knowledge Base with categorized Articles in it. Portal Nodes help implement ready-to-use structures into the portal structure.

To create a portal node, complete the steps below:

  1. Navigate to Portal Structure → Portal Nodes.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.


Field

Mandatory

Description

PortalNSpecify a portal to define a structure with the portal node.
Parent NodeNSpecify a parent node. This node is used as a high-level element for the menus and breadcrumbs.
PageNSpecify a page containing a template to define a structure with the portal node.
Item TableNSpecify a table containing portal items. For example, it can be the Article (article) table.
Item Parent ColumnN

Specify the column that will define parent-child relationship between items and categories.  For example, if the Article table has been chosen as the item table, you can select the KB Category (knowledge_base_category) column as an item parent category column.

Category Item ConditionN

Specify conditions that must be met to display a category item. Use the condition builder to build complex AND/OR filters for this. You can also define a sorting there by any preferable field.

For example, you need to display only published Knowledge Base articles sorted by the publication date. To do this, complete the following steps:

Keep in mind that in this example, Item Table should be equal to Article.

  1. In the Category Item Condition field, click the funnel icon to call the condition builder.
    1. In the Field field, select State
    2. In the Operator field, select is
    3. In the Value field, select Published.
  2. Click Sort.
  3. In the field appeared, select Order.
  4. Select the preferred sorting order (ascending or descending).
  5. Close the condition builder. The conditions are saved.

Item PageNA template of the item specified in the Page field.
ActiveNSelect the checkbox to make the portal node active. 
PublicN

Select the checkbox to make the page visible for unauthorized users.

When this checkbox is selected, the page is available for public access, so use this checkbox cautiously.


Enable Dynamic NodesNSelect the checkbox to enable or disable the possibility of the dynamic nodes resizing.
Category TableNSpecify the table containing the portal item categories. For example, it can be the KB Category (knowledge_base_category) table.
Category Parent ColumnNSpecify the column to define parent-child relationship for elements. For example, if the KB Category table has been chosen as a category table, select the Parent KB Category (parent_knowledge_base_category) column.
Category ConditionNSpecify the conditions that must be met to display a category. Use the condition builder to build the complex AND/OR filters for this. You can also define a sorting there by any preferable field.



Configure the portal structure

To configure a portal structure, you need to complete the following instructions:

  1. Bind the portal record you have created and portal node (or nodes). If you have created nodes within the portal record, then it will be done automatically at the time of the creation.

    1. Open the portal record you need to work with.
    2. Scroll down to the Related Lists area and open the Portal Node tab.
    3. Click Edit.
    4. Move desired portal node records from Available to Selected areas.

    5. Click Save.


    To define the portal node record ID, complete the steps below:

    1. Navigate to Portal Structure → Portal Nodes.
    2. Open the desired portal record.
    3. The node record ID is displayed in the URL.


  2. Bind this node to a previously created page you want to display on the portal. Specify reference to this page in the Page field of the node record form.