Custom pages Configuration

This feature is part of Moodle Workplace™, which is available through Moodle Certified Partners and Service Providers only.

Managing custom pages

You can access the management of programs via Site administration > Appearance > Custom pages or directly via the Custom pages icon in the Workplace launcher.

The following columns and actions are available for custom pages:

Name: The name of custom page
Type indicator: The options are Global page or empty (local page)
Title in navigation: The text in the primary navigation menu or Unlisted (only accessible via URL)
Audience: Displays all selected audiences. If empty, no user can view this page.
Weight: Indicates the order in which the page titles are shown in the user's navigation - the page with the lowest number is shown first, the one with the highest number last.
Actions
- Edit: Change custom page content, details, and audience
- Duplicate: Create a copy of the custom page of the same type
- Duplicate to local page: Create a copy of a global page in a tenant (global pages only)
- Duplicate to global page: Create a copy of a local page as a global page (local pages only)
- Duplicate to start page: Create a copy of a start page
- Copy URL: Lets the user copy the page url to the clipboard. This is mainly relevant for sharing non-published custom pages.
- Show / Hide from navigation: Toggle whether custom page is shown / hidden in primary navigation
- Delete: Remove page

You can filter the custom page table by the following fields:

Page type: Global page, Local page or Start page
Name: Text filters
Time created: Date filters

Creating new custom pages

To create a new custom page, press the New page button and select one of the three options:

New global page: create a custom page that is available in all tenants, including the current one
New start page: create a custom page that will be available to be set as a start page by all users in all tenants
New local page: create a custom page that is only available in the current tenant

The fields to be provided are identical for all page types:

Name: The name will be used as page heading and as the text in the primary navigation.
Show in primary navigation: When selected, the page will be shown in the primary navigation menu. When disabled, only users with access to the page, must do so via its URL. This allows administrators to create pages that are not shown in the primary navigation, but can be referenced from other locations via their URL.
Title in navigation: The text in the primary navigation can be overridden here.
Weight: Specify the order this page will have in the primary navigation. Lower numbers will be displayed first.

As soon as you Save the settings, a new custom page will be created, and you will be directed to the Content tab.

Custom page content

To add or edit the content of a custom page, select the Content tab and Edit page. Ensure that editing mode is also turned on!

You can add custom blocks in any block region defined in your theme. By default, these are the center of the page (content) and the block drawer (side-pre). Once you have completed the page editing, its structure is shown in the content tab.

Custom page audience

Custom page audiences indicate which users have access to the page. This tab is only shown for global and local pages, since start pages are always available to all users.

To access audiences, select the Audience tab of a custom page.

You can add the following criteria to a custom page audience (multiple audiences are OR connected.):

Custom pages
- Administrators: Select at least one administrator who will be given access to the page (only available on Global pages)
- All authenticated users: Use this audience to give access to all logged in users in the tenant to any report
- Assigned category role: Select at least one category role; all users who have been assigned this role are given access to the page (only available on Local pages)
- Assigned system role: Select at least one system role; all users who have been assigned this role are given access to the page
- Manually added users: Select at least one user (via name or email address). Only email addresses of registered users are supported as schedule recipients.
- Member of cohort: Select at least one cohort; all users who are members of this cohort are given access to the page (only active if cohorts exist)
- Non-authenticated users: Give access to guest users and other non-authenticated users. See Public guest pages.
Organisation structure
- Job assignments: Select a Department and a Position, and optionally include subdepartments and subpositions, respectively
- Managers: Make pages available to managers. The Manager type options available are Manager, Manager (assigned manually), and Department Lead.
Multi-tenancy (only available on Global pages)
- Tenant users: Choose one of the following three options:
  - Users in all tenants (including future ones): effectively the same as the 'All users' setting in the 'Custom pages' section
  - Users in the following tenants...: select one or multiple tenants; all their users will be included
  - Users in all tenants except the following...: select one or multiple tenants; all their users will be excluded

Custom page details

This tab displays the same information when creating a new custom page. All values can be edited.

Custom page access

To see who can view the custom page, select the Access tab of a page where you'll see a report that can be filtered by Full name.

This tab is only shown for global and local pages, since start pages are always available to all users.

Accessing custom pages

The custom page name or, if provided, the navigation title is shown in the primary navigation. If multiple custom pages are available, the order is determined by the specified weights of the pages.

Accessing custom pages by its URL

Alternatively, any custom page can be accessed by its URL, that is, they can be referenced from other locations via their URL.

When selecting Copy URL from the dropdown on the custom pages main page or when editing the page, a modal window will open up which lets you copy the URL to your clipboard.

Accessing start pages

Start pages are special custom pages that are intended to be unlisted and used as a site start page. To select a custom page as start page, go to Appearance > Navigation and choose the custom page from the dropdown in the Start page for users option. Alternatively, search for defaulthomepage.

In our example, there are two custom pages to choose from which can be used as start page (Start page and Start page New).

Public custom pages

Moodle Workplace supports the creation of custom pages that can be viewed by guest or other non-authenticated users. Public pages are useful on sites where you want to display information to users who are not registered with your site. To create a public custom page, follow the following steps:

Ensure that forceloginforprofiles (General > Security > Site security settings > Force users to login for profiles) is enabled.
Go to Plugins > Authentication > Manage authentication > Guest login button and change its value to Show.
Create a new global custom page
Add the "Non-authenticated users" audience

The new item will appear in the navbar for non logged-in users, e.g. guests.

Documentation