Add Navigation Top Bar integration for Tour module in Drupal ~11.2.0 with Gin admin theme

Created on 14 July 2025, about 5 hours ago

Problem/Motivation

The Tour module in Drupal provides guided tours. In Drupal ~11.2.0, the new Navigation Top Bar becomes the standard for admin navigation, especially in combination with the Gin admin theme (~5.0). However, the Tour module currently lacks integration with the new top bar, reducing discoverability and usability of guided tours for site editors.

Steps to reproduce

1. Install Drupal ~11.2.0 with the Gin theme.
2. Enable the Tour module.
3. Visit any page which has a pre-configured tour for it. ( important to have a tour to show up in normal setup )
4. Note that the top navigation bar does not include a Tour activation button.

Proposed resolution

Add a `TopBarItem` plugin to the Tour module that places a “Start Tour” button in the Navigation Top Bar’s tools region. Ensure the button only renders if the current user has active tour steps available on the current route. The button should launch the tour when clicked and visually match the Gin admin interface.

Remaining tasks

User interface changes

API changes

Data model changes

📌 Task
Status

Active

Version

2.0

Component

Code

Created by

🇯🇴Jordan Rajab Natshah Jordan

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024