Manually activate a tour (e.g. on click)

[prschmid]

For example when hovering over the "starred items" icon on Slack, you get a nice popup as follows

Then when you click on the icon, the (single step) tour begins

The nice thing is that the "hover" step doesn't need to be there (e.g. on mobile there is no "hover") and so it works nicely on both desktop and mobile.

[kofronpi]

@prschmid Really cool idea ! This gem wraps shepherd.js, did you open an issue there? :)

[jabbett]

@kofronpi I think this is fully implementable without any changes to shepherd.js. Abraham could define a single-step tour and tie the start() action to a click event on a particular DOM element.

[kofronpi]

@jabbett interesting ! you'd have to carefully consider what is configurable at the abraham-level and what is configurable at the shepherd-level (see the issue I opened - #8)

[scarroll32]

Just wondering if this suggestion is under consideration? It's a useful feature.

[jabbett]

Just thinking through how this might be implemented:

• Rework AbrahamHelper.abraham_tour to pass all a page's tours, regardless of completion, to the partial, along with a list of tour names that have been completed
• Have the ability to indicate in the tour config YAML whether a tour should only be manually-activated
• Update _abraham.html.erb to
  • render the JavaScript initialization of all tours, not just one
  • auto-start a tour on page load only if it's:
  • next in line
  • not manual
  • not completed
  • not already dismissed for later
  • not missing its first attachTo element
  • register JavaScript event listeners to make each tour individually startable by name

[scarroll32]

Can also be done by deleting the previous tour entry and reloading the page https://github.com/actmd/abraham/issues/42