Tour Guide

With this element, you can create an accessible tour guide for your page. It will display a series of steps that the user can follow to learn how to use your page.

Activate

To activate the Tour Guide element, go to Bricksforge > Elements and enable the “Tour Guide” element. Now, a new element “Tour Guide” can be found in the Bricks Element List.

How to use

To show a Tour Guide to a page, drag the element to your element structure and configure it as you like.

Settings

SettingDescription
Active the tourEnable or disable the Tour Guide.
Hide in BuilderEnable or disable the Tour Guide in the Builder. Once styled, you can disable this setting.

General

SettingDescription
Scroll to elementIf you want to scroll to the element when the step is shown, enable this option.
Use Modal OverlayIf you want to use a modal overlay, enable this option.
TriggerChoose the trigger to start the tour guide. You can choose between “On Page Load” or “On Click”.
Trigger SelectorIf you choose “On Click” as the trigger, you can specify the selector to trigger the tour guide.
Trigger OnceIf you want to trigger the tour guide only once, enable this option. This is only available when the trigger is set to “On Page Load”.

Steps

Here you can setup the steps of the tour guide. You can add as many steps as you want. Each step has the following settings:

SettingDescription
ID (optional)A unique identifier for the step. (Only needed if you want to handle custom operations from outside)
TitleThe title of the step.
TextThe text of the step.
Element SelectorThe selector of the element that the step is related to.
PositionThe position of the step. You can choose between different positions.
Show Close IconIf you want to show a close icon, enable this option.
Overlay PaddingThe padding of the overlay.

Also, each step can have one or more action buttons. For each action button, you can set the following settings:

SettingDescription
ActionThe action of the button. You can choose between “Next”, “Back”, “Complete”, “Cancel”. “Next” will go to the next step, “Back” will go to the previous step, “Complete” will complete the tour guide, and “Cancel” will cancel the tour guide.
TextThe text of the button.