Problem/Motivation

The Tour link in the upper right corner is easily missed. I never noticed it until today, where I had to find it. And even when actively looking for it, I had to search the text on the page for "Tour", to discover it.

This is sad, because it really is a great feature.

Steps to reproduce

Activate the Tour module and visit for example /admin/structure/views/view/frontpage.

Proposed resolution

Make the link stand out more, by extending the text, and making the background blue.

Remaining tasks

Update the code.

User interface changes

Tour link text extended, and with blue background.

API changes

None

Proposed solution

Currently
Current Tour link

Tour link, more visible
Tour link more visible

Issue fork drupal-3186076

Command icon 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:

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

ressa created an issue. See original summary.

Pooja Ganjage’s picture

FileSize
796 bytes

Hi,

Creating a patch for this issue.

Please review the patch.

Let me know if any suggestions.

Thanks.

Pooja Ganjage’s picture

Status: Active » Needs review
ressa’s picture

Issue summary: View changes

Updating example link in Issue summary.

ressa’s picture

Issue summary: View changes
Status: Needs review » Needs work

Thanks @Pooja Ganjage. It does make the text in the upper right corner longer, but I still think it can be missed, and would prefer to try with a button placed prominently in the center of the screen, making it very obvious and unmissable.

Also, nothing happens if I click the "Take a tour of this page" link ...

Pooja Ganjage’s picture

FileSize
2.34 KB

Hi,

Tried to implementing a tour link as suggested in #5 comment.

Please review the patch.

Let me know if any suggestions.

Thanks.

Pooja Ganjage’s picture

Status: Needs work » Needs review
ranjith_kumar_k_u’s picture

FileSize
463.07 KB
372.24 KB
334.49 KB

The above patch works fine .

Before patch
before patch

After patch
after patch

after patch

ressa’s picture

Thanks for testing @ranjith_kumar_k_u and @Pooja Ganjage for the code, great work. I realized that maybe it is a bit too intrusive at the center ... But your first suggestion of working with the original button in the upper right corner is good, so I have create a new patch, which makes the text longer and adds a class, giving it a blue background.

You can preview the update by clicking the link "View live preview (ready) via Tugboat" above:

  1. Log in, username and password are both admin
  2. Tour button at /admin/structure/views/view/frontpage or /admin/structure/block

Original Tour link

Original Tour link

Tour link, more text and blue background

Tour link more text, blue background

What do you think?

Pooja Ganjage’s picture

@ressa, that's a great looking, I am agree with showing tour link in upper right corner instead of center.

ressa’s picture

Status: Needs review » Needs work

Sounds good @Pooja Ganjage. There does seem to be some work to do, regarding the Claro theme, where the background colour doesn't change ... I am not sure if that's a Claro issue, or something that should be fixed here?

Pooja Ganjage’s picture

FileSize
1.42 KB

Hi,

@ressa, I create patch for fixing background colour that doesn't change in claro theme.

Please review.

Thanks.

Pooja Ganjage’s picture

Status: Needs work » Needs review
ressa’s picture

Status: Needs review » Needs work

Thanks! Perhaps we can try using the new system with Gitlab? I am not sure if you can click the "3186076-make-tour-link" link above, and edit directly there, or perhaps you have to create a new branch? It would be an interesting experiment, to figure out if it's possible. Do you want to have a go at it?

Pooja Ganjage’s picture

Hi,

@ressa, I want to go for it, but I don't have any idea Drupal GitLab, It would be nice if you give me any idea about this.

Thanks.

himanshu_sindhwani’s picture

FileSize
395.93 KB
  1. +++ b/core/modules/tour/tour.module
    @@ -50,9 +50,9 @@ function tour_toolbar() {
    +        'class' => ['toolbar-icon', 'toolbar-icon-help', 'button--primary'], ¶
    

    Please remove extra space at the end of line.

  2. +++ b/core/themes/claro/css/theme/toolbar.icons.theme.css
    @@ -45,7 +45,6 @@
    -  background-color: transparent;
    

    We can not remove this background-color: transparent; since this may cause problems at some other pages.

  3. +++ b/core/themes/claro/css/theme/toolbar.icons.theme.pcss.css
    @@ -34,7 +34,6 @@
    -  background-color: transparent;
    

    same here we can not remove

Here is an example if we remove background-color: transparent; then edit link gets white background.
example

ressa’s picture

Thanks for the review @himanshu_sindhwani, your comments are very useful. For now, I hope it's okay if we first try to get the proposed patch in #13 working in Gitlab integration, and then fix it based on your feedback.

@Pooja Ganjage: The new system can be a bit overwhelming to everyone, but very powerful, so don't worry about mistakes. I should know, I made many mistakes when I started using it. You might need to activate "Git access" under your account, if you haven't already, I am not sure if that's necessary.

These should be the steps:

  1. Click the link to the branch in GitLab at the top of the page, called 3186076-make-tour-link
  2. Click to find the files: core > themes > claro > css > theme > toolbar.icons.theme.css (should be https://git.drupalcode.org/issue/drupal-3186076/-/blob/3186076-make-tour...)
  3. Click "Edit", update the file, and click "Commit changes". It should be included in the Merge Request here (MR 161)
  4. Repeat for toolbar.icons.theme.pcss.css

Also, check out Issue forks & merge requests, there is much useful information on that page about GitLab Integration.

Pooja Ganjage’s picture

Status: Needs work » Needs review
ressa’s picture

Thanks @Pooja Ganjage, great that you got the new system at git.drupalcode.org working for you.

@himanshu_sindhwani: I see what you mean with the "Edit" link background in the upper right corner ... do you have any suggestions on how to solve this?

Pooja Ganjage’s picture

Hi @ressa,

I have solved that background issue for edit link..in latest commit changes...

Can you please look into it.

Let me know if any suggestions on it.

bnjmnm’s picture

There may be some overlap with these issues: #2069073: Allow Tours to be taken by users that cannot access the Toolbar (e.g. anonymous users), #2940433: Make block for tour button (copy of patch in 2069073 for D8.3). It would be worth reviewing those and seeing if that influences what is happening here.

Also tagging "Needs usability review". A change like this will require UX signoff. In my experience, the easiest way to get UX signoff is presenting the issue for discussion at a UX meeting. These meetings happen weekly, every Tuesday at 15:00UTC. Shortly before the meeting time, a link to the meeting will be posted in the #UX channel of Drupal Slack.

ressa’s picture

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

vikashsoni’s picture

Applied patch #13 in drupal-9.3.x-dev
Applied successfully
After patch ' Tour link is more visible '
Thanks for the patch
For ref sharing screenshot ....

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

gaurav-mathur’s picture

Assigned: Unassigned » gaurav-mathur
gaurav-mathur’s picture

Assigned: gaurav-mathur » Unassigned
FileSize
17.39 KB
29.97 KB

Patch #13 applied successfully on on Drupal 10.0.x-dev and PHP 8.1.6.
The patch work properly for me.
Refer to screenshots.

smustgrave’s picture

Status: Needs review » Needs work

MR needs to be updated for 10.1.x and still needs usability review.

ressa’s picture

I just installed the Honeypot module, and by chance (I forget where) I saw that it offered a Tour. It made me remember that the Tour link is hard to find, and it took me some time to scan the entire screen, when I finally found the "Tour" link, hidden in the upper right corner. It's so sad that it sits hidden up there ...

Gauravvvv’s picture

Status: Needs work » Needs review
FileSize
1.98 KB

I have attached patch for 10.1.x. please review

Patch #18, no longer applies

 git apply -v 161.patch
Checking patch core/modules/tour/tour.module...
Checking patch core/themes/claro/css/theme/toolbar.icons.theme.css...
Checking patch core/themes/claro/css/theme/toolbar.icons.theme.pcss.css...
Checking patch core/modules/contextual/css/contextual.toolbar.css...
error: while searching for:
}
.toolbar .toolbar-bar .contextual-toolbar-tab .toolbar-item {
  margin: 0;
}
.toolbar .toolbar-bar .contextual-toolbar-tab .toolbar-item.is-active {
  background-image: -webkit-linear-gradient(rgb(78, 159, 234) 0%, rgb(69, 132, 221) 100%);

error: patch failed: core/modules/contextual/css/contextual.toolbar.css:12
error: core/modules/contextual/css/contextual.toolbar.css: patch does not apply
ressa’s picture

Thanks @Gauravvvv, I updated the existing merge request target branch from 9.2 to 10.1, and rebased it by clicking "Rebase without pipeline":

To rebase a merge request’s branch without triggering a CI/CD pipeline, select Rebase without pipeline from the merge request reports section. This option is available when fast-forward merge is not possible but a conflict-free rebase is possible.

So the current MR !161 should now work with Drupal 10.1.

ressa’s picture

Status: Needs review » Needs work

Perhaps we can now look at the review by @himanshu_sindhwani in #17, about not removing the transparency?

smustgrave’s picture

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

dsandhya’s picture

plz review the path

quietone’s picture

Project: Drupal core » Tour
Version: 11.x-dev » 1.0.x-dev
Component: tour.module » Code