Highlight and guide users through new features or explain existing functionality.
- Install the widget in your project
- Include the widget on a page where you want to show a tour
- Configure the widget's settings:
- On the Walkthrough tab, add steps:
Selector: the name of the Mendix component you'd like to highlight. (optionally use CSS/jQuery selectors here)Selector is Name: if you used a CSS/jQuery selector in the first step, select "no" here. Otherwise, keep "yes"Text: the text to display in the helper popover next to the component you're highlighting.Popover Position: where (relative to the component) should the popover appear?Show Backdrop: should we dim the rest of the page to highlight this element?Click to Continue: If enabled, clicking on the element will trigger the next step in the tour.
- On the Appearance tab, add the Button Text and any extra classes you'd like to add to the trigger button.
- On the Behavior tab, you can add:
-
Auto Run: A microflow to run to determine if the tour should start automaticallyDefault Behavior is that the tour will show once per user, and then they can always click the button to view it again. You can override this behavior using this microflow
-
Callback: A microflow that runs when a user ends the tour.
-
- On the Walkthrough tab, add steps:
- When snippets are present on the page, using
selector is nameastruecould cause the widget show a popover multiple times, since Mendix element name uniqueness is not enforced across snippets. In these cases, add a unique classname to your tour elements and useselector is nameasfalse.
See AppStoreWidgetBoilerplate for an example