To properly understand how guides display and behave, we will detail two distinct concepts that relate to guides and URL’s: visibility and fail behaviors.
At a given moment, Helppier’s widget contains a list of guides that have been previously created. Each guide in this guide's list can be clicked by the user, which leads the guide to start playing.
While you can have all guides visible in the guides list throughout all your website’s pages (this is the default setting), you may want to only show a certain guide in the guide’s list on a certain webpage.
Example: You have created a total of 50 guides but, in your website’s “Contact” page, you only want to display a list of 5 guides that relate to information on that specific page.
You can easily configure each guide to show in the guides list for specific URLs (pages). To do that:
2. Go to the Guides list.
6. Select the option "Specific URL"
Example: “/contact.html” would configure the guide to be listed exclusively in "yourwebsite.com/contact.html”.
Example: In your “Contact” page, your guides list contains a “Welcome” guide that is only playable in your Homepage - as it relates to that page’s specific elements.
If your visibility settings enable that “Welcome” guide to be listed in the “Contact” page, a user can attempt to play it - which will result in a fail behavior.
Then, by setting up custom fail behaviors, you can choose what should happen when that fail behavior is detected.
Here’s how you can configure fail behaviors:
Fail Behaviour options:
Display an error message - you can show a custom error message to your users. Learn more here.
Reload the web page - the current page is reloaded in an attempt to restart the guide.
Redirect the user to a start page - the user is automatically redirected to a certain page. In the example above, trying to play the “Welcome” guide would fail, and could redirect the user to your homepage, where the guide would play flawlessly.
Start a new tutorial first - the user is automatically taken into another tutorial. This is useful if you wish that the user goes through a specific guide before starting the guide that produced the fail behavior.