Problem/Motivation
While a tour takes visitors through various steps, the visitors have to remember the steps so that they can replicate those steps later. This places a cognitive load on the visitor or forces them to take notes. It would be good if they had the option at the end of the tour to pop the tour points up in a separate window that they can refer to while actually doing the task which was trained by the tour.
I am tagging this as accessibility due to the cognitive load issue.
Steps to reproduce
Steps:
1. As a visitor, go through a tour
2. Arrive at the last stop on the tour
Desired result (option one): Three buttons:
Previous
End tour
List steps in new window
Desired result (option two): Two buttons:
Previous
End tour
and a check box:
List steps in new window
Current result: Two buttons:
Previous
End tour
Proposed resolution
On the last stop of a tour, add a button "List steps in new window". Clicking that button pops up a resizable, positionable browser window listing all of the tour steps.
Or, on the last stop of a tour, add a check box "List steps in new window". Checking that box before clicking End Tour pops up a resizable, positionable browser window listing all of the tour steps.
Remaining tasks
Decide which option to use.
User interface changes
API changes
Data model changes
| Comment | File | Size | Author |
|---|---|---|---|
| #13 | Screenshot 2024-10-02 at 6.34.04 PM.png | 47.88 KB | smustgrave |
Issue fork tour-3471088
Show commands
Start within a Git clone of the project using the version control instructions.
Or, if you do not have SSH keys set up on git.drupalcode.org:
Comments
Comment #2
charles belovComment #4
smustgrave commentedOops not working on this one, wrong ticket.
Comment #5
smustgrave commentedCorrect me if I'm wrong but for this to work we would need something like #3469330: Add an "alt text" to tour tips describing the situation and the highlighted element added?
Else that overview page would just be
title
body
Excluding selector value because I imagine that wouldn't be useful to anyone.
Comment #6
charles belovAgreed. This is dependent on #3469330: Add an "alt text" to tour tips describing the situation and the highlighted element and I'm adding it as a related issue.
Comment #7
smustgrave commentedBlocker landed.
Decided we will stay using the label (now title) + body field, with the assumption the site admins are using descriptive titles.
Comment #8
thejimbirch commentedWith the alt text approach, I feel like you would basically have to write the tour twice.
An alternative approach could be to parse the tour yaml file completely. Looking at a simple tour:
You could loop through the tips and output something like this:
Comment #9
thejimbirch commentedDrupal core also has Help Topics. Could that be part of the solution?
Comment #10
charles belov+1 for parsing the yaml tour as it ensures the steps and labels are in sync and no duplicate effort.
Comment #11
smustgrave commentedActually a -1 for that approach.
1. We have removed all tours from the contrib module and placed into recipes
2 The yml could easily not match what's in the database so what appears in the yml could be different then what appears on the actual tour.
Comment #12
charles belovThen could the separate window could be generated from the database? The source doesn't matter; what matters is that it be the same source.
Comment #13
smustgrave commented@thejimbirch we actually dropped the alt idea. We tweaked the tip form some to make it clear that site builders really should be using descriptive titles. With that assumption we can use title and body. But do need to determine where this link should go
Don't want to distract from the actual content so think at the bottom probably would be best
Thought about a hot key but people may not know about it then. But rough idea, probably would shrink the text and change to "View full tour"
Comment #14
thejimbirch commentedNice idea. Maybe a external link style icon next to the close icon with the hover/title text you have there?
Comment #16
smustgrave commentedComment #18
smustgrave commentedGoing to go ahead and add this.