Tour Guide
Guided tours that walk new members through your forum. Each step points at something on the page and says what it is.
Version 2.0 is out, for Flarum 2. It is a rewrite: several tours instead of one, a point-and-click target picker, per-locale content, and completion statistics. The extension is now called Tour Guide; the package name is unchanged, so nothing installed breaks.
Features
- Several tours. A welcome tour on the index, another on the discussion page, a what-is-new tour after an upgrade. Each keeps its own record of who has taken it.
- Bound to a page. A tour names the route it belongs to and waits for it, so a member who lands somewhere else still gets it when they arrive.
- Desktop and mobile. Mark a tour or a step for one or the other. On a phone the popover becomes a bottom sheet.
- Steps that do not fit are skipped, so the progress count is always right. A step with no target is shown in the middle of the screen.
- Steps can drive the page. A step can click what it highlights, so the next one can point inside a menu. Or it can wait for the member to click it.
- Pick targets by clicking them. No hunting for CSS selectors by hand.
- Translations. Write each step per locale. Anything untranslated falls back to what you typed.
- Formatted descriptions. Rendered by the forum's own formatter, so Markdown, links and images work as far as your enabled extensions allow.
- Audience rules. Limit a tour to certain groups, or to accounts under a given age in days.
- Statistics. How many finished, how many left early, and which step loses them.
- Preview a tour before switching it on. Nothing is recorded.
- Import and export as JSON, to move a tour between forums.
- Replay. Members can retake a tour from their settings. Moderators with the permission can reset one for somebody else.
Picking a target
Press Pick and the forum opens in a second window. Hover to highlight, click to capture. Press Browse to navigate somewhere else first, or Test to see what a selector you already have matches.
In the admin area
More
A step with no target, shown on its own:
A step that waits for the member to click:
On a phone:
Installation
composer require datlechin/flarum-simple-tour-guide:"*"
php flarum migrate
php flarum cache:clear
Updating
composer update datlechin/flarum-simple-tour-guide
php flarum migrate
php flarum cache:clear
Upgrading from 0.2.x
The migrations carry your setup over. Two things worth knowing:
- Your steps become one tour called "Welcome tour", and anyone who had dismissed the old tour is recorded as having finished it.
- Steps had no order of their own before, so they are numbered oldest first. Check the order in the admin area and drag anything out of place.
Also breaking: skip_null_elements is gone, because skipping steps that do not fit is now how it always behaves. driver.js is no longer used, so custom CSS targeting .driver-* will not apply.
Links
Support
If this is useful to you, you can sponsor its development at GitHub Sponsors.
