Pages

What is a page

A page in your app is a way of organizing and restricting data and content in your app. You can add as many pages as you wish and organize data in each page with it’s own custom settings and restrictions.

Adding a page

To add a new page, click on the “+ Add Page” button.

You’ll be prompted to enter 4 values to expedite building your page. Any of these values can be edited after the page has been added.

  1. Page Name - this can be any name you choose and does not need to be unique.

  2. Page Description

  3. Layout

  4. Page Structure

  5. Add page to menu

Page Name

Page name will be used for creating a unique ‘slug’ or url in your app. Learn more about the slug here.

Layout

Layout choose which layout this page should be nested beneath. Learn more about layouts here. 

Page Structure

Page Structure choose a specific pre build row and column configuration. Learn more about rows and columns here. 

 

Page Content

Within the page Content you can add Rows, Columns, System and Data Components within those columns.

 

Securing pages

Each page can be set with unique security permissions such as restricting the page to specific users roles. These settings can be configured by selecting a page, clicking Settings and modifying the section by Page Security. 

 

There are 3 options for page security: 

  1. Anyone, no login required
  2. Only Logged In Users
  3. Only Users In Specific Roles

 

Anyone, no login required

Using this default setting, the page will be visible to anyone. 

 

Only Logged In Users

When this is enabled, only users who are logged in can view this page. It won't matter which role they belong to, as long as they're logged in they will indeed see the page. To restrict based on roles, use the next option. 

 

Only Users In Specific Roles

Set which roles the user must be part of to see this page. You can add more than one role and as long as the user matches ANY of these roles they will have access. 

When any permission restrictions are configured on a page, the page will show a lock/padlock icon next to it. 

 

Page rules

What are page rules?

Page rules enable you to run additional checks prior to page loading and determine if a particular action should be taken. 

For example: When page loads if user's phone number is blank, direct them to their profile page to update their number. 

The following page rules are available: 

 

Show a message

Showing a message will override the page content and instead only show a message you specified. The message can be shown with any HTML content as well as pre-defined alert type: 

Error

When message is set to show as Error/Danger it will look like this: 

Warning

When message is set to show Warning it will look like this: 

Alert

When message is set to show Alert it will look like this: 

Success

When message is set to show Success it will look like this: 

No Style

When message is set to show No Style it will look like this:

 

Redirect to another page

You can also choose to redirect the user to any parent page in your app. 

 

Redirect to a URL 

You can redirect users to any URL, this can be a URL inside your app or any website you choose. 

 

Page Rule Conditions

Whichever page rule you choose you can add custom conditions to determine when this rule should be applied. The page rule conditions are either based on the logged in user or when adding page rules to child pages can be run based on those values. 

 

Page settings

In addition to the Page Security and Page Rules you can also change the page name, slug and layout for any given page. 

When working with auto generated child pages, the name is auto generated. It can be helpful to modify this name in the page settings after its created. 

Home page

Each app can have a default page which is used as the home page in your app. This simply means when someone goes to your domain or sub-domain this is the page they will be naturally directed to. 

The page set as the Home Page will have a star next to it on the page list.

 

Types of pages

There are 2 types of pages that can be added into your app.

  • Parent page

  • Child page

Parent page

A parent page is a page you manually created by adding a new page. This is a page that sits at the top level of your app. Parent pages

Child page

A child page is a page that is directly connected to a component in page one level above it. When adding certain links to a component a child page will automatically be created.

parent-child.jpg

 

Deleting a child page will not delete the link in the parent component, however deleting the link that created the child page will in fact remove the page.

 

Page load process

When a page is requested by a user, the server goes through a process to determine what do show the user. Below is a diagram of that process. 

Page-Load-Diagram-Page-1.jpg